---

INSCHARS

INSCHARSファンクションは、テキスト式に1文字以上を挿入します。

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

戻り値

TEXTまたはNTEXT

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

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

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

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

構文

INSCHARS(text-expression characters [after])

引数

text-expression

文字を挿入する式。text-expressionが複数行のTEXT値である場合、改行はINSCHARSの戻り値でも維持されます。

characters

text-expressionに挿入する1文字以上の文字。

after

指定されたcharactersが挿入される位置の前の文字位置を表すINTEGER。text-expressionの最初の文字位置は1です。テキストの先頭に文字を挿入するには、afterに0を指定します。この引数を省略した場合、INSCHARSはtext-expressionの最後の文字の後ろに文字を挿入します。

text-expressionの長さより大きな値をafterに指定した場合、INSCHARSはtext-expressionの末尾に空白を追加します。挿入される空白の数は、afterの値とtext-expressionの長さとの差です。たとえば、INSCHARS('abc' 'def' 4)では、次のように'def'が'abc'に追加される前に1つの空白が挿入されます。

abc def

例

例7-120 テキストへの文字の挿入

この例は、TEXT値hellojoeに文字thereを挿入する方法を示します。

INSCHARS('hellojoe', 'there', 5)

hellotherejoe