General information


In syntax descriptions,


In a mapping string, individual items are separated from each other by one or more blanks.  Within a command-code item that has operands, the command code and its associated operands must have no embedded spaces or other values not part of the syntax, unless these are part of a quoted string operand.


A mapping command is a command used to copy and transform character data found by an SPFLite CHANGE Primary command.  These mapping commands are specified in a CHANGE string-2 operand string with a string type code of M.


The string value found by string-1 of the CHANGE Primary command is called the source string.  This value is referenced by some of the mapping commands.  It is a read-only value that can be referenced or copied (in whole or in part), but cannot be modified.


The string produced as a result of processing the mapping command is called the result string.  The result string initially is an empty (zero-length) string that is successively built up by process of executing mapping commands.


Mapping commands can be generally divided into two types: copying commands and modifying commands.





When a column reference appears by itself without an associated command code, the column reference is considered a copying command that refers to data in the source string; it requires dot notation to make it refer to the current result string.


The distinction between copying commands and modifying commands affects how column references with dot notation are treated.


See Full Mapping String Documentation for a complete discussion of mapping strings.



Sample Usage with the CHANGE command


CHANGE  R"[A-Za-z]+"  M"4-1"  WORD  ALL


Mappings strings use an M type code, and always appear as string-2 of a CHANGE command.  The type code M may appear at beginning or end of string-2, and is case-insensitive.  String-1 will normally be a Picture (P) or Regular Expression (R) string type.





Created with the Personal Edition of HelpNDoc: Write eBooks for the Kindle