TRANSLATE

UTL_RAW.TRANSLATE は、バイト単位での翻訳関数であり、RAW 型データをバイトごとに変換するために使用されます。

構文

UTL_RAW.TRANSLATE (
   r        IN RAW,
   from_set IN RAW,
   to_set   IN RAW
) RETURN RAW;

パラメータ説明

使用方法

ソース文字列 r の値をバイトごとにスキャンします：

• その値が from_set に含まれている場合、to_set の対応する位置のバイトで置き換えます。
• バイトが from_set に含まれていない場合、結果に直接コピーします。
• from_set のバイトが to_set に対応する項目がない場合、そのバイトは削除されます。
• from_set が to_set より長い場合、余分な from_set のバイトに対応する翻訳がないため、マッチしたバイトは削除されます。
• to_set が from_set より長い場合、余分な to_set のバイトは無視されます。
• from_set に重複するバイトがある場合、重複するバイトは無視されます（同じバイトが from_set 内で2回目に現れた場合、その対応関係は無視されます）。
• 3つのパラメータのいずれかに NULL 値または長さが 0 のものがある場合、ValueError エラーが発生します。
• 文字列の長さが奇数の場合、処理時に最左端に 0 を補います。

使用例

以下のコマンドを実行し、UTL_RAW.TRANSLATE 関数を使用して、入力バイトシーケンス内の特定の文字をすべて F に置き換え、他の文字は元のまま保持します。

obclient> SELECT UTL_RAW.TRANSLATE('1236567812125612344434341234567890ABAA1234','12AA34','FFFFFF') FROM dual;

戻り結果は次のとおりです：

+-----------------------------------------------------------------------------------+
| UTL_RAW.TRANSLATE('1236567812125612344434341234567890ABAA1234','12AA34','FFFFFF') |
+-----------------------------------------------------------------------------------+
| FF365678FFFF56FFFF44FFFFFFFF567890ABFFFFFF                                        |
+-----------------------------------------------------------------------------------+