«List»() command is a way of listing the names of parties is all in one phrase, with a comma separating each pair of names except for the last two which are separated by the word ‘and’.
This is what the
«List»() command does and might look like this:
The parties are:
«List(parties,firstnames surname,!, , and )»
In some sample XML data set, suppose we have:
The names in our example would be rendered:
Harry Charles Potter, Juliet Charlene Jones and Fred Reggie Basset
Note the ‘!’ in front of the comma. This is an escape character and is required before a comma, or left or right parenthesis whenever that character is required as is in the output text.
This is because the characters ‘,’ ‘(‘ and ‘)’ are used by XpressDox as command and function parameter list delimiters. This means that, if any of those three characters are required to be in the printed output (as is the case with the comma above), then they must be prefixed by !
Notice that the syntax of the command is such that the second parameter is essentially a list of data element names, or function results, separated by spaces. Thus commands like this are possible:
«List(parties,ToUpper(firstnames) ToUpper(surname),!, , and )»
HARRY CHARLES POTTER, JULIET CHARLENE JONES and FRED REGGIE BASSET
«List(parties,ExtractInitials(firstnames,'.') ToUpper(surname),!, , and )»
H.C. POTTER, J.C. JONES and F.R. BASSET
«List(parties,ExtractInitials(firstnames,'.') Use('aka') aka ToUpper(surname),!, , and )»
H.C. aka Charlie POTTER, J.C. aka Charley JONES and F.R. aka Freddie BASSET