---

REPLBYTES

REPLBYTESファンクションは、テキスト式の1バイト以上を置換します。

ヒント: シングルバイト・キャラクタ・セットを使用している場合、REPLBYTESファンクションではなくREPLCHARSファンクションを使用できます。また、テキスト値に指定の文字列が1つ以上存在する場合に、その文字列を別の文字列に変更するには、CHANGECHARSファンクションを使用します。

戻り値

TEXT

構文

REPLBYTES(text-expression replacement [start])

パラメータ

text-expression

REPLBYTESがバイトを置換するTEXT式。text-expressionから置換されるバイトに埋込みの改行が含まれる場合、これらの改行は削除されます。その他の改行は維持されます。削除された改行の数は、置換されたバイト数の合計にはカウントされません。置換された式の改行も、REPLBYTESの出力に保持されますが、カウントの対象にはなりません。

ヒント: NTEXT値に対してこのファンクションを使用する必要がある場合、CONVERTまたはTO_CHARファンクションを使用してNTEXT値をTEXTに変換します。

replacement

text-expressionの既存のバイトを置換する1バイト以上が含まれるテキスト式。

start

バイトの置換を開始するバイト位置を表すINTEGER。text-expressionの最初のバイト位置は1です。この引数を省略した場合、REPLBYTESは最初のバイトから開始します。REPLBYTESは、replacementによって指定されるバイトに対して必要なバイト数のtext-expressionを置換します。startの値がtext-expressionの長さより大きい場合、REPLBYTESは単にtext-expressionを返します。

例

例8-76 バイトとしてのテキストの置換

この例は、テキスト値Hello there, Joeの一部を置換する方法を示します。

次の文

SHOW REPLBYTES('Hello there, Joe', 'Jane', 14)

によって、次の出力が生成されます。

Hello there, Jane

例8-77 REPLBYTESによる改行の処理

この例は、REPLBYTESによって改行が保持されて無視されることを示します。

var1 = JOINLINES('Hello' 'there' 'Joe')
var2 = JOINLINES('Hi' 'Jane')

次の文

SHOW REPLBYTES(var1 var2)

によって、次の出力が生成されます。

Hi
Janehere
Joe

REPLBYTESは、var1の先頭の6バイト(HellothereJoeのHellot)をvar2の6バイト(HiJane)に置換しました。var2のHiおよびvar1のthereの後の改行は保持されます。

var1の13バイトをすべて置換するには、置換後のバイトに13バイト指定する必要があります。たとえば、Janeの後に7つの空白を追加します。

var2 = JOINLINES('Hi' 'Jane       ')

次の文

SHOW REPLBYTES(var1 var2)

によって、次の出力が生成されます。

Hi
Jane