翻訳

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                                        |
+-----------------------------------------------------------------------------------+