$LISTFROMSTRING
Synopsis
$LISTFROMSTRING(string,delimiter) $LFS(string,delimiter)
パラメータ
string | Caché リストに変換される文字列。この文字列には、delimiter によって区切られた 1 つ以上の要素が含まれます。delimiter は、作成される Caché リストの構成要素にはなりません。 |
delimiter | オプション — string 内の部分文字列 (要素) を分離するために使用される区切り文字。delimiter は、引用符付きの文字列として指定します。delimiter を指定しない場合、既定はコンマ (,) 文字です。 |
概要
$LISTFROMSTRING は、各要素が区切られた引用符付き文字列を受け取り、リストを返します。リストは、区切り文字列を使用しないエンコード形式でデータを表します。したがって、リストには可能な文字をすべて含めることができますが、ビット文字列データに最適です。リストは、ObjectScript $LIST 関数を使用して操作されます。
パラメータ
string
文字列リテラル (引用符で囲まれた)、数値、あるいは文字列に評価される変数または式。この文字列には、delimiter によって区切られた 1 つ以上の部分文字列 (要素) を含めることができます。delimiter 文字は出力リストに表示されないため、文字列のデータ要素には delimiter 文字 (または文字列) を含めることはできません。
delimiter
入力文字列内の部分文字列を区切るのに使用される文字 (または文字列)。(引用符で囲まれた) 数値または文字列リテラル、変数名、文字列に評価される式を指定できます。
通常、区切り文字には、文字列データ内で決して使用されることがなく、部分文字列を区切る文字としてのみ使用される特定の文字が設定されます。区切り文字には、複数文字から成る文字列を指定することもできますが、それを構成する個々の文字は文字列データ内で使用できます。
delimiter を指定しない場合、既定の区切り文字はコンマ (,) です。NULL 文字列 ("") は区切り文字として指定できません。NULL 文字列を指定すると、<STRINGSTACK> エラーになります。
例
以下の例は、空白スペースで区切られた名前の文字列を受け取り、リストを作成します。
SET namestring="Deborah Noah Martha Bowie"
SET namelist=$LISTFROMSTRING(namestring," ")
WRITE !,"1st element: ",$LIST(namelist,1)
WRITE !,"2nd element: ",$LIST(namelist,2)
WRITE !,"3rd element: ",$LIST(namelist,3)
関連項目
-
$LISTBUILD 関数
-
$LIST 関数
-
$PIECE 関数
-
$LISTDATA 関数
-
$LISTFIND 関数
-
$LISTGET 関数
-
$LISTLENGTH 関数
-
$LISTNEXT 関数
-
$LISTSAME 関数
-
$LISTUPDATE 関数
-
$LISTVALID 関数