REPLCOLS

REPLCOLSファンクションは、複数行のTEXT値に存在する文字列の一部またはすべてを別の文字列に置換します。このファンクションの戻り値は、結果として得られる行で構成される複数行のTEXT値です。

列は、複数行のTEXT値の各行における文字位置です。各行の最初の文字は列1であり、2番目の文字は列2です（以降同様）。

戻り値

TEXTまたはNTEXT

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

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

戻り値における行数は、text-expressionにおける行数と常に同じです。columnsテキスト式の行数が少ない場合、戻り値の後続の各行でcolumnsの最後の行が繰り返されます。

構文

REPLCOLS(text-expression columns [start])

引数

text-expression: 置換される1列以上を含むテキスト式。
columns: 1行以上を含むテキスト式。この式は、text-expressionの一部またはすべての列を置換する列を指定します。
start: 置換を開始する列の位置を表す1から4000までのINTEGER。text-expressionの各行の最初の文字の列位置は1です。startを指定しなかった場合、置換は列1から開始されます。text-expressionの特定の行にある最後の文字よりも右側にくる開始列を指定すると、戻り値の対応する行にはその間の列を埋める空白が入ります。例8-78「列の結合および位置合せ」を参照してください。

例

例8-78 列の結合および位置合せ

次の例は、citylistの各行とcityrepsの各行を結合し、両方の値の位置を合せます。置換は列11から開始します。REPLCOLSのかわりにJOINCOLSを使用した場合、cityrepsリストの位置は合いません。

次の文を発行します。

SHOW citylist

生成される出力は次のとおりです。

Boston
Houston
Chicago
Denver

次の文を発行します。

SHOW cityreps

生成される出力は次のとおりです。

Brady
Lopez
Alfonso
Cody

次の文を発行します。

SHOW REPLCOLS(citylist cityreps 11)

生成される出力は次のとおりです。

Boston    Brady
Houston   Lopez
Chicago   Alfonso
Denver    Cody