TO_MULTI_BYTE
構文
目的
TO_MULTI_BYTE
は、シングルバイト文字を、対応するマルチバイト文字に変換してchar
を戻します。char
のデータ型は、CHAR
、VARCHAR2
、NCHAR
またはNVARCHAR2
です。戻り値は、char
と同じデータ型です。
char
内に同等のマルチバイト文字がないシングルバイト文字は、シングルバイト文字として出力されます。このファンクションは、ご使用のデータベース文字セットに、シングルバイト文字およびマルチバイト文字の両方が含まれている場合にのみ有効です。
このファンクションは、CLOB
データを直接的にサポートしていません。ただし、暗黙的なデータ変換を使用してCLOB
を引数として渡すことはできます。
関連項目:
-
詳細は、「データ型の比較規則」を参照してください。
-
TO_MULTI_BYTE
の文字の戻り値に割り当てる照合を定義する照合導出ルールは、『Oracle Databaseグローバリゼーション・サポート・ガイド』の付録Cを参照してください。
例
次の例では、シングルバイトA
からUTF8のマルチバイトA
への変換を示します。
SELECT dump(TO_MULTI_BYTE( 'A')) FROM DUAL; DUMP(TO_MULTI_BYTE('A')) ------------------------ Typ=1 Len=3: 239,188,161