---

INSCOLS

INSCOLSファンクションは、複数行のTEXT値の列に別のTEXT値のすべての列を挿入します。挿入される列は指定した列位置の後ろに配置され、各行の元の列は右に移動します。このファンクションは、挿入された列で構成された複数行のTEXT値を返します。

戻り値

TEXTまたはNTEXT

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

• すべての引数がTEXT値である場合、戻り値はTEXTです。

• すべての引数がNTEXT値である場合、戻り値はNTEXTです。

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

戻り値の行数は、text-expressionの行数と常に同じです。columnsのTEXT式の行がこれより少ない場合、INSCOLSはその式の最後の行を戻り値の後続の行で繰り返します。

構文

INSCOLS(text-expression columns [after])

パラメータ

text-expression

列を挿入する式。

columns

各行に1つ以上の列を含む式。この式のすべての列がtext-expressionの対応する行に挿入されます。

after

列が挿入される前の列位置を表す0から4,000のINTEGER。各行における最初の文字の列位置は1です。afterを指定しない場合、挿入は各行の末尾から開始されます。1行の全体の長さは、シングルバイト文字では4,000列またはマルチバイト文字ではそれより少ない列を超えることができません。

text-expressionのある行における最後の文字よりも右側にくるafter列を指定した場合、戻り値の対応する行における間の列は空白で埋められます。

例

例7-121 テキスト列の挿入

次の例では、カラー・コード(複数行のTEXT値itemcolorに格納)を、itemidテキスト値に格納される項目識別子に挿入します。列は列3の後ろに挿入します。

itemcolor値は、次のとおりです。

Blu
Red
Gre
Ora

itemid値は、次のとおりです。

542-Fra
379-Eng
968-USA
369-Can

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

INSCOLS(itemid itemcolor 3)

次の値が返されます。

542Blu-Fra
379Red-Eng
968Gre-USA
369Ora-Can