指定した文字列の部分文字列である文字列配列を返します。

メモ この関数は Lotus Domino Release 6 で新しく追加されました。

構文Split (expression [, delimiter [, count [, compMethod ]]])

構成要素expression

部分文字列に分割されるスカラー型の文字列です。

省略可能。部分文字列を区切る文字を含むスカラー文字列。区切り文字が指定されていないとスペース (" ") が使用されます。

返す部分文字列の数を示す数値。既定値は -1 で、すべての部分文字列を返します。

区切り文字を検索するときに使用する比較のタイプを示す数値。

数値	比較方法
0	大文字と小文字および全角と半角を区別します
1	大文字と小文字を区別しません。全角と半角を区別します
4	大文字と小文字を区別します。全角と半角を区別しません
5	大文字と小文字を区別しません。全角と半角を区別しません

プラットフォームのソート順序を使って文字列を比較する場合は、2 を使います。2 を指定すると文字列はビット単位で比較されます。compMethod を省略すると、既定の比較モードはこのモジュールの Option Compare ステートメントで設定されたモードになります。モジュールに対して比較方法が宣言されていない場合は、既定で大文字と小文字および全角と半角が区別されます。

指定した数が実際に返された結果の数より大きい場合は、返される配列は実際の結果の数と同じになります。

指定した数が実際に返された結果の数より小さい場合は、返される配列の最後の要素が、文字列の残りすべてを含みます。例を次に示します。

split("this is a test", " ", 2)

count が -1 より小さい場合は、引数が範囲外であるランタイムエラーが発生します。

count がゼロの場合は、lbound 0 と ubound -1 を含むサイズゼロの配列を返します。

エラー処理expression または delimiter がスカラー型でない場合、Split はランタイムの型の不一致をスローします。
count が -1 未満か、compare が不正な数値の場合、引数が範囲外であるランタイムエラーが発生します。

クロスリファレンス式言語の @Explode 関数
例
関連項目

LotusScript ランゲージリファレンス: Q - T

用語集