prevnext   » SZS: Wiimms SZS Toolset » wszst: Wiimms SZS Tool » wszst split

wszst split

Analyse (file) names and split them into the different parts. Print the results in machine readable format.


1.   Syntax

wszst SPLIT [source]...

2.   Options

Option Param Description
--load-prefix file Read in a PREFIX file and replace the internal prefix database with the content. is the authoritative source for this.
--plus chars If a name begins with a plus sign, then all characters up to the first space are recognized as a plus prefix. The first part consists of all the plus signs followed by any other characters. The first character of the second part is used to determine the sort value. If the second part is empty, then the last plus sign is used instead.

The higher sorting value is now calculated from the number of plus signs in the first part, the more plus signs, the smaller the value. The first character from the second part determines the lower value. If it is in parameter CHARS then the position determines the value, otherwise the ASCII value to which 500 is added.

-i --ignore Ignore non existing source files without warning.
--sections Dump info using configuration or section syntax. Use »--var name« as prefix.
--sh Dump info using SH syntax. Use »--var name« as prefix.
--bash Dump info using BASH syntax. Use »--var name« as prefix.
--json Dump info using JSON syntax. Options --var and --array are ignored.
--php Dump infos using PHP syntax. Use »--var name« as variable name of the resulting object.
--makedoc Dump infos using MakeDoc syntax. Use »--var name« as variable name of the resulting map.
--var varname Use VARNAME as variable name or prefix on script output. The default value is 'res' for variables and 'res_' as prefix.
--array Use an array on script output if possible. If arrays are not supported, then append a '_#' suffix with an zero based index to the variable name defined by »--var name«. In this case, only one output file is created.
--avar varname Shortcut for: »--array --var name«
--case case CASE is one of LOWER, AUTO (default) or UPPER.If LOWER or UPPER are set, then the lower/upper case of the variable names is adjusted accordingly.
-d --dest path Define a destination path (directory/file). The destination - means: write to standard output.

The path may contain escape sequences: %Q is replaced by the fully qualified source name. %P and %F are replaced by the source path or by the filename. %N and %E are replaced by source filename without extension or by the source extension. Finally, %T is replaced by the default extension of the destination format.

A '?' direct behind '%' in %E and %T conversions avoid that the same extension is used twice in row.

-D --DEST path Like --dest, but create the directory path automatically.