例
以下の例は、4 つの要素を持つリストを作成し、要素がコロン (:) 文字で区切られた文字列に変換します。
SET namelist=$LISTBUILD("Deborah","Noah","Martha","Bowie")
WRITE $LISTTOSTRING(namelist,":")
このコードは、結果として "Deborah:Noah:Martha:Bowie" を返します。
以下の例は、4 つの要素を持つリストを作成し、要素が *sp* 文字列で区切られた文字列に変換します。
SET namelist=$LISTBUILD("Deborah","Noah","Martha","Bowie")
WRITE $LISTTOSTRING(namelist,"*sp*")
このコードは、結果として "Deborah*sp*Noah*sp*Martha*sp*Bowie" を返します。
以下の例では、省略された要素 1 つと空の文字列値のある要素 1 つを持つリストを作成します。$LISTTOSTRING は、このリストをコロン (:) 文字で区切られた要素を持つ 1 つの文字列に変換します。省略された要素があるため、<NULL VALUE> エラーを避けるには flag=1 が必要です。ただし、flag=1 の場合、省略された要素と空の文字列値は区別されません。
SET namelist=$LISTBUILD("Deborah",,"","Bowie")
WRITE $LISTTOSTRING(namelist,":",1)
このコードは、結果として "Deborah:::Bowie" を返します。
以下の例では、コンマを含む要素のリストを作成します。既定では、$LISTTOSTRING は delimiter としてコンマを使用します。最初の例では、コンマを含む要素は、コンマで区切られた 2 つの要素と区別できません。2 番目の例では、flag=3 が指定されているため、この要素に引用符が付いています。3 番目の例では、flag=7 が指定されているため、すべての要素に引用符が付いています。
SET pairlist=$LISTBUILD("A,B","C^D","E|F")
WRITE $LISTTOSTRING(pairlist,,1)
// returns A,B,C^D,E|F
WRITE $LISTTOSTRING(pairlist,,3)
// returns "A,B",C^D,E|F
WRITE $LISTTOSTRING(pairlist,,7)
// returns "A,B","C^D","E|F"
$LISTVALID では以下のすべてを有効なリストと見なします。flag=1 で、$LISTTOSTRING はすべてについて NULL 文字列 ("") を返します。
WRITE "1",$LISTTOSTRING("",,1),!
WRITE "2",$LISTTOSTRING($LB(),,1),!
WRITE "3",$LISTTOSTRING($LB(UndefinedVar),,1),!
WRITE "4",$LISTTOSTRING($LB(""),,1)
flag=0 で、$LISTTOSTRING は以下に対してのみ NULL 文字列 ("") を返します。
WRITE "1",$LISTTOSTRING("",,0),!
WRITE "4",$LISTTOSTRING($LB(""),,0)
その他は <NULL VALUE> エラーを生成します。