Inserted text


Inserted text to be appended as a literal value at the end of the result string, or are a parameter of a command code, are specified as inner quoted strings within the larger M string.  Example:   M"1-2 `**` 3-4".  


Inserted text can have a replication factor;  M"`Abc`2" produces 'AbcAbc'.


The type of quote used for such inner quoted values must differ from the outer quotes used on the M string itself; ( ' ) single, ( " ) double and ( ` ) accent quotes are available.  To represent a quoted-quote as data in such inner quoted values, it must be doubled.  Due to the way SPFLite handles its own quoted strings, you cannot use the quotes of the M string itself literally as data, neither by escaping them nor by doubling them.  In the example above, the M string is enclosed in ( " ) double quotes, so double quotes cannot be used as data anywhere within that M string.  You can use the commands SQ, DQ and AQ to insert a Single Quote, Double Quote or Accent Quote.  You can also insert text as a hex value, such as '31'X.


Hex values can also have a replication factor;  M"`31`X4" produces '1111'.


When a string parameter is involved in character comparisons, it can be suffixed with C or T to cause CASE C or CASE T comparisons to be performed.  Example:   M"1+ RC`abc=xyz`T".  Commands such as RC here that use a string-pair syntax can also perform case-conformant changes, depending on if and where the string type of T is used.


Hex strings can be specified with an X suffix, and are always treated as case-sensitive.  String suffixes take precedence over CC or CT command codes, which take precedence over the Edit PROFILE CASE setting.


Inserted text ranges use a range of Ansi characters in brackets.  Example: [0-9] produces the same as '0123456789' and [9-0] produces the same as '9876543210'.  Multiple ranges are allowed.  Example:  [A‑Z,0‑9] produces the same as 'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789'.



Created with the Personal Edition of HelpNDoc: Produce Kindle eBooks easily