OCTET_LENGTH スカラー関数

OCTET_LENGTH 関数は、オクテット (バイト) で expression の長さを戻します。

スキーマは SYSIBM です。

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

文字または GRAPHIC ストリングの長さには、末尾ブランクが含まれます。バイナリー・ストリングの長さには、2 進ゼロが含まれます。可変長ストリングの長さは、最大長ではなく実際の長さです。

移植性を高めるために、データ・タイプ DECIMAL(31) の結果を受け入れられるようにアプリケーションをコーディングしてください。

例

例 1: 表 T1 に、C1 という名前の GRAPHIC(10) 列があるとします。
```
   SELECT OCTET_LENGTH(C1) FROM T1
```
戻り値は 20 です。
例 2: 以下の例は、Unicode ストリング '&N~AB' に対応します。 '&' は音楽のト音記号、'~' は結合チルド文字です。以下の例では、このストリングを異なる Unicode エンコード方式で示しています。

'&' 'N' '~' 'A' 'B'

UTF-8 X'F09D849E' X'4E' X'CC83' X'41' X'42'

UTF-16BE X'D834DD1E' X'004E' X'0303' X'0041' X'0042'
変数 UTF8_VAR および UTF16_VAR に、ストリングの UTF-8 表記および UTF-16BE 表記がそれぞれ含まれているとします。
```
   SELECT OCTET_LENGTH(UTF8_VAR),
     OCTET_LENGTH(UTF16_VAR)
   FROM SYSIBM.SYSDUMMY1
```
これは値 9 および 12 をそれぞれ戻します。

	'&'	'N'	'~'	'A'	'B'
UTF-8	X'F09D849E'	X'4E'	X'CC83'	X'41'	X'42'
UTF-16BE	X'D834DD1E'	X'004E'	X'0303'	X'0041'	X'0042'