INSCHARSファンクションは、テキスト式に1文字以上を挿入します。
マルチバイト・キャラクタ・セットを使用している場合、INSCHARSファンクションのかわりにINSBYTESファンクションを使用できます。
戻り値
TEXTまたはNTEXT
このファンクションでは、TEXT値とNTEXT値を引数として使用できます。戻り値のデータ型は、引数として指定する値のデータ型によって次のように異なります。
すべての引数がTEXT値である場合、戻り値はTEXTです。
すべての引数がNTEXT値である場合、戻り値はNTEXTです。
引数にTEXTとNTEXTの両方の値が存在する場合は、すべてのTEXT値がNTEXT値に変換されてからファンクションの演算が実行され、戻り値はNTEXTになります。
パラメータ
文字を挿入する式。text-expressionが複数行のTEXT値である場合、改行はINSCHARSの戻り値でも維持されます。
text-expressionに挿入する1文字以上の文字。
指定された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