LOTUSSCRIPT 言語


StrToken 関数

テキスト文字列から指定した語を返します。

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

構文StrToken (expression, delimiter, wordNumber [, compMethod])
構成要素expression


delimiter
wordNumber
compMethod
戻り値String 型を返します。返される String 型は expression からの指定された語です。
使用法StrToken はテキスト文字列から指定された語を返します。「語」とは、文字列の一部で、指定した区切り文字で区切られた部分を指します。たとえば、区切り文字としてスペース (" ") を指定すると、語は前後にスペース (あるいは文字列の最初または最後を示す引用符 (')) の入った一連の文字になります。たとえば、「hello there」は 4 つの語「」、「hello」、「there」、「」からなります。
メモ 最初の「」は、左側が文字列の始まり、右側が区切り文字で区切られているため、語と解釈されます。

expression は語に分解され、wordNumber で指定された位置にある語が返されます。

wordNumber の絶対値が語数より大きい場合は、指定した語は空の文字列として認識されます。

wordNumber がゼロの場合、指定した語は文字列の最初の語として認識されます (wordNumber=0 は wordNumber=1 と同じとみなされます)。

wordNumber がゼロ未満の場合は、指定した語が文字列の最後の語から逆算して数えることで検出されます。

エラー処理StrToken は、expression または delimiter がスカラー型でない場合、または wordNumber が long 型でない場合 (コンパイラが long 型に変換できない場合)、ランタイムの型の不一致をスローします。
optionCompare が不正な値の場合は、引数範囲外のランタイムエラーが発生します。

クロスリファレンス式言語の @Word 関数

関連項目