SPLIT ER 関数
SPLIT 関数は、指定された入力文字列をサブ文字列に分割し、結果を新しいレコード リスト値として返します。
構文 1
SPLIT (input, length)
この構文は、指定された入力文字列を指定された長さのサブ文字列に分割するために使用します。
構文 2
SPLIT (input, delimiter)
この構文は、指定された入力文字列を指定された区切り記号に基づいてサブ文字列に分割するために使用します。
引数
input: 文字列
分割するテキスト。
length: 整数
単一のサブ文字列の最大の長さ。
delimiter: 文字列
サブ文字列を区切るために使用される区切り記号。
戻り値
レコード リスト
レコードの結果リスト。
使用上の注意
返されるリストのレコード構造は、文字列型の値フィールドで構成されます。 返されるリストのすべてのレコードには、このフィールドで生成されたサブ文字列が含まれます。
delimiter 引数が空の場合、返される新しいリストは、文字列型の値フィールドを持つ 1 つのレコードで構成されます。 このフィールドには、入力テキストが含まれています。
input 引数が空の場合は、新しい空のリストが返されます。 input または delimiter 引数のいずれかを指定しない場合 (null)、アプリケーション例外がスローされます。
例 1
SPLIT ("abcd", 3) は、文字列型の値フィールドのある 2 つのレコードで構成される新しいリストを返します。 最初のレコードの値フィールドには、テキスト "abc" が、2 つ目のレコードの値フィールドには、テキスト "d" が含まれます。
例 2
SPLIT ("XAb aBy", "aB") は、文字列型の値フィールドのある 3 つのレコードで構成される新しいリストを返します。 最初のレコードの値フィールドには、テキスト "X" が、2 つ目のレコードの値フィールドには、テキスト " " が、3 つ目のレコードの値フィールドにはテキスト "y" が含まれます。
例 3
INDEX 関数を使用して、指定された入力文字列の個別の要素にアクセスできます。 計算済フィールド タイプの MyList データ ソースを入力し、それに対して SPLIT("abc", 1) を構成している場合、式 INDEX(MyList,2).Value はテキスト "b" を返します。
例 4
ENUMERATE 関数は、指定された入力文字列の個別の要素にアクセスするのに役立ちます。 最初に計算済フィールド タイプの MyList データ ソースを入力し、それに対して SPLIT("abc", 1) 式を構成した後、計算済フィールド タイプの EnumeratedList データ ソースを入力し、それに対して ENUMERATE(MyList) 式を構成する場合、式 FIRSTORNULL(WHERE(EnumeratedList, EnumeratedList.Number=2)).Value はテキスト "b" を返します。