---

INSBYTES

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

シングルバイト・キャラクタ・セットを使用している場合は、INSCHARSを使用します。

戻り値

TEXT

構文

INSBYTES(text-expression bytes [after])

引数

text-expression

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

bytes

text-expressionに挿入する1バイト以上のバイト。

after

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

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

abc def

例

例7-119 テキストへのバイトの挿入

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

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

INSBYTES('hellojoe', 'there', 5)

次の値が戻されます。

hellotherejoe