ListFromString
Synopsis
ListFromString(string[,delimiter])
パラメータ
string | Caché リストに変換される文字列。この文字列には、delimiter によって区切られた 1 つ以上の要素が含まれます。delimiter は、作成される Caché リストの構成要素にはなりません。 |
delimiter | オプション — string 内の部分文字列 (要素) を分離するために使用される区切り文字。delimiter は、引用符付きの文字列として指定します。delimiter を指定しない場合、既定はコンマ (,) 文字です。 |
説明
ListFromString は、各要素が区切られた引用符付き文字列を受け取り、リストを返します。リストは、区切り文字列を使用しないエンコード形式でデータを表します。したがって、リストには可能な文字をすべて含めることができますが、ビット文字列データに最適です。リストは、Caché Basic の List 関数を使用して処理されます。
Caché のリストは、ListBuild 関数を使用して作成することも、List 関数を使用して別のリストから抽出することもできます。
パラメータ
string
文字列リテラル (引用符で囲まれた)、数値、あるいは文字列に評価される変数または式。この文字列には、delimiter によって区切られた 1 つ以上の部分文字列 (要素) を含めることができます。delimiter 文字は出力リストに表示されないため、文字列のデータ要素には delimiter 文字 (または文字列) を含めることはできません。
delimiter
入力文字列内の部分文字列を区切るのに使用される文字 (または文字列)。(引用符で囲まれた) 数値または文字列リテラル、変数名、文字列に評価される式を指定できます。
通常、区切り文字には、文字列データ内で決して使用されることがなく、部分文字列を区切る文字としてのみ使用する特定の文字を設定します。区切り文字には、複数文字から成る文字列を指定することもできますが、それを構成する個々の文字は文字列データ内で使用できます。
delimiter を指定しない場合、既定の区切り文字はコンマ (,) です。NULL 文字列 ("") は区切り文字として指定できません。
例
以下の例は、空白で区切られた名前を含む文字列を受け取り、リストを作成します。
namestring="Deborah Noah Martha Bowie"
namelist=ListFromString(namestring," ")
Println "1st element: ",List(namelist,1)
Println "2nd element: ",List(namelist,2)
Println "3rd element: ",List(namelist,3)
空白は文字列 delimiter となり、新しく作成されたリストには含まれません。
以下の例は、<sp> 区切り文字で区切られた名前を含む文字列を受け取り、リストを作成します。
namestring="Deborah<sp>Noah<sp>Martha<sp>Bowie"
namelist=ListFromString(namestring,"<sp>")
Println "1st element: ",List(namelist,1)
Println "2nd element: ",List(namelist,2)
Println "3rd element: ",List(namelist,3)
以下の例では、既定の区切り文字 (コンマ) を使用してリストを作成します。このリストの 2 番目の要素には、値は含まれていません。
namestring="Deborah,,Noah,Martha"
namelist=ListFromString(namestring)
Println "1st element: ",List(namelist,1)
Println "2nd element: ",List(namelist,2)
Println "3rd element: ",List(namelist,3)
関連項目
-
List 関数
-
ListBuild 関数
-
ListExists 関数
-
ListFind 関数
-
ListGet 関数
-
ListLength 関数
-
ListNext 関数
-
ListSame 関数
-
ListToString 関数
-
ListValid 関数
-
Piece 関数