$TRANSLATE

Synopsis

$TRANSLATE(string,identifier[,associator])

概要

$TRANSLATE 関数は、返り値の文字列内の文字と文字の置き換えを行います。string 引数の処理を一度に 1 文字行います。string にある各文字と identifier 引数にある各文字とを比較します。$TRANSLATE が一致するものを見つけると、文字の位置を書きとめます。

• 引数が 2 つの形式の $TRANSLATE は、identifier 引数にある文字のすべてのインスタンスを出力文字列から取り除きます。

• 引数が 3 つの形式の $TRANSLATE は、string 内で見つかった各 identifier 文字のすべてのインスタンスを、位置的に対応する associator 文字と置き換えます。置換は、文字列単位ではなく文字単位で行われます。identifier 引数に含まれる文字が associator 引数よりも多い場合、identifier 引数にある余分な文字は出力文字列から削除されます。 identifier 引数に含まれる文字が associator 引数よりも少い場合、associator 引数にある余分な文字は無視されます。

SQLCODE -380 は、指定した引数が少なすぎる場合に発行されます。SQLCODE -381 は、指定した引数が多すぎる場合に発行されます。

$TRANSLATE は、大文字と小文字を区別します。

$TRANSLATE は、NULL を文字と置き換えるためには使用できません。

例

以下の例では、引数が 2 つの $TRANSLATE によって、句読点 (コンマ、スペース、ピリオド、アポストロフィ、ハイフン) を削除することで Name 値を変更し、アルファベット文字のみから成る名前を返します。identifier では、アポストロフィが二重になることに注意してください。これは、アポストロフィを文字列区切りではなくリテラル文字としてエスケープするためです。

SELECT TOP 20 Name,$TRANSLATE(Name,', .''-') AS AlphaName 
FROM Sample.Person
WHERE Name %STARTSWITH 'O'

以下の例では、引数が 3 つの $TRANSLATE によって、コンマおよびスペースをキャレット (^) 文字に置き換えることで Name 値を変更し、3 つの部分 (姓、名、ミドルネームのイニシャル) に区切られた名前を返します。associator では、identifier 内の文字数と同数の “^” を指定する必要があることに注意してください。

SELECT TOP 20 Name,$TRANSLATE(Name,', ','^^') AS PiecesNamePunc
FROM Sample.Person
WHERE Name %STARTSWITH 'O'

以下の例では、引数が 3 つの $TRANSLATE によって、コンマおよびスペースをキャレット (^) 文字に置き換え (identifier および associator 内で指定されている)、ピリオド、アポストロフィ、およびハイフンを削除することで (identifier 内では指定されており、associator からは省略されている)、Name 値を変更します。

SELECT TOP 20 Name,$TRANSLATE(Name,', .''-','^^') AS PiecesNameNoPunc 
FROM Sample.Person
WHERE Name %STARTSWITH 'O'

関連項目

• REPLACE 関数

• STUFF 関数

• 文字列操作