INSLINES

INSLINESファンクションは、複数行のテキスト式に1行以上を挿入します。

戻り値

TEXTまたはNTEXT

このファンクションでは、TEXT値とNTEXT値を引数として使用できます。戻り値のデータ型は、引数として指定する値のデータ型によって次のように異なります。

すべての引数がTEXT値である場合、戻り値はTEXTです。
すべての引数がNTEXT値である場合、戻り値はNTEXTです。
引数にTEXTとNTEXTの両方の値が存在する場合は、すべてのTEXT値がNTEXT値に変換されてからファンクションの演算が実行され、戻り値はNTEXTになります。

構文

INSLINES(text-expression lines [after])

パラメータ

text-expression: 1行以上を値に挿入する複数行の式。
lines: text-expressionに挿入するテキストの1行以上を表す式。
after: 指定されたlinesが挿入される位置の前の行数を表すINTEGER。text-expressionの最初の行の位置は1です。最初の行の前に挿入するには、afterに0(ゼロ)を指定します。この引数を省略した場合、INSLINESはtext-expressionの最後の行の後ろに新しい行を挿入します。

例

例7-122 テキスト行の挿入

この例は、次の値を持つmktglistという変数における複数行のテキスト値に新しい行を挿入する方法を示します。

Salespeople
Products
Services

INSLINESファンクションをコールします。

INSLINES(mktglist, 'Advertising', 2)

次の値が返されます。

Salespeople
Products
Advertising
Services