---

FINDLINES

FINDLINESファンクションは、複数行のテキスト式における1行以上の位置を判別します。

戻り値

INTEGER

構文

FINDLINES(text-expression, lines)

パラメータ

text-expression

テキスト式の値内で、特定の行または行のグループの位置を特定します。FINDLINESは指定する行をtext-expressionで検索します。大文字および小文字の区別も含めて完全一致する必要があります。また、複数行を指定した場合、FINDLINESでは、指定したすべての行がtext-expression内の単一の連続ブロックとして検索されます。すべての行がtext-expressionで出現するが、連続ブロックではない場合、FINDLINESは見つからないものとして0(ゼロ)を返します。

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

text-expressionの値がNAである場合、FINDLINESはNAを返すことに注意してください。

lines

検索する行を指定するテキスト式。text-expressionでlinesが見つからない場合、FINDLINESは0を返します。linesが複数回出現する場合、FINDLINESは最初に出現する行数を返します。

例

例7-97 連続した2行の検索

この例は、newlistというTEXT変数の複数行の値における2行「products」と「services」の位置を検索する方法を示します。newlist変数の値は、次のとおりです。

salespeople
products
services
regions
priorities

次のFINDLINESファンクション・コールに対するlines引数の文字「\n」は、「product」と「services」が別の行であることを示す改行を表します。

SHOW FINDLINES(newlist, 'products\nservices')

この文の結果は次のとおりです。

2