Split string
Split string ( stringToSplit ; separator {; options} ) : Collection
| 引数 | 型 | 説明 | |
|---|---|---|---|
| stringToSplit | Text | → | 文字列の値 |
| separator | Text | → | stringToSplitを分割する文字列。空の文字列("")の場合には、stringToSplitを1文字ずつに分割します |
| options | Integer | → | 空の文字列と空白に関するオプション |
| 戻り値 | Collection | ← | 分割した文字列のコレクション |
説明
Split string コマンドは、stringToSplit 引数の文字列を、separator 引数で指定した区切り文字によって分割した文字列のコレクションを返します。返されたコレクション内の文字列には、separator 引数の区切り文字自身は含まれません。
stringToSplit 引数の文字列内にseparator 引数の区切り文字が見つからない場合、Split string はstringToSplit 引数を単一の要素として格納するコレクションを返します。separator 引数に空の文字列を渡した場合、Split string はstringToSplit 引数を1文字ずつに分割したコレクションを返します。
options 引数には、Strings テーマ内にある以下の定数の一つ、あるいはその組み合わせを渡すことができます:
| 定数 | 型 | 値 | コメント |
|---|---|---|---|
| sk ignore empty strings | 倍長整数 | 1 | 結果のコレクションから空の文字列を削除する(空の文字列を無視) |
| sk trim spaces | 倍長整数 | 2 | 分割した文字列の先頭と最後にある空白文字(スペース)は切り取る |
例題 1
var $vt : Text
var $col : Collection
$col:=New collection
$vt:="John;Doe;120 jefferson st.;Riverside;; NJ; 08075"
$col:=Split string($vt;";") //["John","Doe","120 jefferson st.","Riverside",""," NJ"," 08075"]
$col:=Split string($vt;";";sk ignore empty strings) //["John","Doe","120 jefferson st.","Riverside"," NJ"," 08075"]
$col:=Split string($vt;";";sk ignore empty strings+sk trim spaces) //["John","Doe","120 jefferson st.","Riverside","NJ","08075"]
例題 2
separator 引数には複数文字の文字列を指定することも可能です:
var $vt : Text
var $col : Collection
$vt:="NameSmithage40"
$col:=Split string($vt;"")
//$col=["Name","Smith","age","40"]