TO_MULTI_BYTE スカラー関数

TO_MULTI_BYTE 関数は、string-expression 内の 1 バイト文字を同等のマルチバイト (全角) 文字に変換した Unicode ストリングを返します。

Read syntax diagramSkip visual syntax diagram TO_MULTI_BYTE ( string-expression )

スキーマは SYSIBM です。

ストリング式
組み込み文字ストリングの値を返す式。
文字ストリングはビット・データであってはなりません。
引数は数値データ・タイプにすることもできます。
数値引数は、暗黙的に VARCHAR データ・タイプにキャストされます。

結果

関数の結果は VARCHAR です。

結果のストリング単位は string-expression と同じです。

結果の長さ属性は、次のようにストリング単位によって決まります。
  • ストリング単位が OCTETS である場合、結果の長さ属性は、string-expression の長さ属性の 3 倍の長さと、結果のデータ・タイプの最大長のうちの小さい方になります。
  • それ以外の場合、結果の長さ属性は string-expression と同じです。

結果のストリングの実際の長さが戻りタイプの最大長を超えると、エラーが発生します (SQLSTATE 54006)。

引数が NULL になる可能性がある場合、結果も NULL になる可能性があります。 引数が NULL の場合、結果は NULL 値になります。

例

以下の例の照会は、元の 1 バイト・ストリング「ABC」、それに相当する全角ストリング、およびそれに相当する全角の 16 進表記を返します。

SELECT S, TO_MULTI_BYTE(S) MB, HEX(TO_MULTI_BYTE(S)) HEX
FROM (VALUES 'ABC') T(S)
S   MB        HEX

------------------------------
ABC ＡＢＣEFBCA1EFBCA2EFBCA3

1 record(s) selected.