文字列の検索と分割関数
- 更新日2025-07-30
- 4分で読める
単一文字列を2つの部分文字列に分割します。
文字列は、特定の文字、または部分文字列で分割できます。文字列の検索と分割は、文字列から検索文字列/文字内の文字列または文字を検索します。この関数は文字列を分割し、結果の2つの文字列を一致前の部分文字列と一致+残りの文字列に返します。

入力/出力
文字列
—
文字列は、関数が検索または分割する入力文字列です。
検索文字列/文字 (-)
—
検索文字列/文字は、文字列内を検索する文字列または文字です。この入力が配線されていないか、または空の文字列である場合、この関数はオフセットで文字列を分割します。検索文字またはオフセットのどちらかを配線しなければなりません。
オフセット (0)
—
オフセットは、文字列に対して一致の検索を開始する文字数位置を指定します。オフセットは数値である必要があります。文字列の最初の文字のオフセットは0です。オフセットが未配線、または0未満の場合、関数はオフセットを0とみなします。
一致前部分文字列
—
一致前部分文字列は、検索文字列/文字の前にある文字列部分を返します。検索文字列/文字が配線されていない場合は、オフセットの前の文字列部分を返します。この関数が検索文字列を検出しない場合、一致前部分文字列は元の文字列全体を返します。
一致文字列とそれ以降の部分文字列
—
一致文字列とそれ以降の部分文字列は、検索文字列/文字および文字列内の次に続くすべての文字から成ります。この関数が検索文字列を検出しない場合、一致文字列とそれ以降の部分文字列は空の文字列を返します。
一致オフセット
—
一致オフセットは、文字列内の検索文字列/文字の位置です。この関数が検索文字列を検出しない場合は、一致オフセットは-1を返します。 |
1文字を一致させるオプションを有効にした場合、この関数は検索文字列/文字の最初の文字のみを使用して、文字列でこの文字を検索します。文字列で最初の一致が見つかると、この関数は文字列を分割し、結果として 2つの文字列を返します。1文字を一致させるオプションを有効にするには、この関数を右クリックしてショートカットメニューから1文字を一致させるを選択します。
たとえば、文字列にTest stringを指定して検索文字列/文字にstrを指定すると、1文字を一致させるオプションを有効にしているかどうかによって、この関数は結果として異なる文字列を返します。以下の表に結果の文字列を示します。
| 「1文字を一致させる」が有効の場合 | 「1文字を一致させる」が無効の場合 | |
|---|---|---|
| 一致前部分文字列 | Test | Te |
| 一致文字列とそれ以降の部分文字列 | string | st string |
文字列
—
オフセット (0)
—
一致前部分文字列
—
一致オフセット
—