FINDCHARS

FINDCHARSファンクションは、テキスト式内の文字における、指定したグループの先頭の文字位置を返します。

ヒント:

マルチバイト・キャラクタ・セットを使用している場合、FINDCHARSファンクションのかわりにFINDBYTESファンクションを使用できます。

戻り値

INTEGER

構文

FINDCHARS(text-expression, characters [starting-pos [LINENUM]])

引数

text-expression

指定する文字の検索元のテキスト式。text-expressionは複数行の値も可能です。その場合、FINDCHARSは指定した文字をすべての行で検索します。大文字および小文字の区別も含めて完全一致する必要があります。

FINDCHARSでは、引数としてTEXT値およびNTEXT値を使用できます。1つの引数のみがNTEXTである場合、FINDCHARSはファンクション操作を実行する前に、他の引数をNTEXTに自動的に変換します。

characters

検索対象の文字のグループ。charactersが複数行の値である場合、FINDCHARSは最初の行以外をすべて無視します。

text-expressionでcharactersが見つからない場合、FINDCHARSはゼロを返します。文字のグループが複数回出現する場合、FINDCHARSは最初に出現する位置を返します。

starting-pos

text-expで検索を開始する文字位置を指定するINTEGER式。デフォルトはtext-expの位置1（最初の文字）です。

LINENUM

指定したテキストの先頭の文字位置ではなく行数をFINDCHARSが返すことを指定します。

例

例7-96 文字グループの開始位置の検索

この例は、リテラルTEXT値hellotherejoeにおいて文字の様々なグループの開始位置を検索する方法を示します。

次の文を発行します。

SHOW FINDCHARS('hellotherejoe', 'joe')

生成される出力は次のとおりです。

次の文を発行します。

SHOW FINDCHARS('hellotherejoe', 'al')

生成される出力は次のとおりです。