RAWTOHEX スカラー関数

RAWTOHEX 関数は、値の 16 進表記を文字ストリングとして戻します。

構文図を読む構文図をスキップするRAWTOHEX(expression )

スキーマは SYSIBM です。

expression
16 進値を戻すストリングを指定する式。この式は、組み込みの文字ストリング、GRAPHIC ストリング、バイナリー・ストリング、数値、ブール値、または日時値を返す必要があります。 値が文字ストリング、GRAPHIC ストリング、バイナリー・ストリングでない場合は、関数の評価の前に VARCHAR に暗黙的にキャストされます。

結果

関数の結果は VARCHAR です。引数が NULL になる可能性がある場合、結果も NULL になる可能性があります。引数が NULL の場合、結果は NULL 値となります。 結果の長さは、以下の表に基づいて計算されます。

表 1. 引数のデータ・タイプと長さ属性のデータ・タイプの関数としての結果のデータ・タイプ
引数のデータ・タイプ1 長さ属性2 結果データ・タイプ
CHAR(A) または BINARY(A) A<128 CHAR(A*2)
CHAR(A) または BINARY(A) A>127 VARCHAR(A*2)
VARCHAR(A)、VARBINARY(A)、CLOB(A)、または BLOB(A) A<16337 VARCHAR(A*2)
GRAPHIC(A) A<64 CHAR(A*2*2)
GRAPHIC(A) A>63 VARCHAR(A*2*2)
VARGRAPHIC(A) または DBCLOB(A) A<8169 VARCHAR(A*2*2)
CHAR(A CODEUNITS32) A<64 VARCHAR(A*4*2)
VARCHAR(A CODEUNITS32) または CLOB(A CODEUNITS32) A<4085 VARCHAR(A*4*2)
GRAPHIC(A CODEUNITS32) A<64 VARCHAR(A*2*2*2)
VARGRAPHIC(A CODEUNITS32) または DBCLOB(A CODEUNITS32) A<4085 VARCHAR(A*2*2*2)
1. ストリング単位が指定されない場合、データ・タイプのストリング単位は CODEUNITS32 ではありません。
2. 最大長さ属性は、データ・タイプ制限または入力引数用の 16336 バイトの限度を反映します。

values rawtohex('hello')
	returns 68656C6C6F