目的
引数に相当する UTF-8 文字の文字列を返します。
パラメーター
x は、文字列に変換できる式です。x が WIDECHAR 型でない場合、文字列に変換されてから相当する UTF-8 文字に変換されます。
説明
UTF8 関数は、引数 x に相当する UTF-8 の CHARACTER の文字列を返します。返される文字列の長さは、x が CHARACTER の場合は最大 2 倍、WIDECHAR の場合は最大 3 倍になることがあります。この長さが CHARACTER 型で許容される最大長を超える場合や、WIDRECHAR 入力文字列に無効な UTF16 文字が含まれている場合は、ERROR 条件が発生します。
例
dcl u8 char(12) var;
u8 = utf8('Hello World.');
put skip list('From ASCII: ', hex(u8));
put skip list(utf8tochar(u8));
結果は次のようになります。
From ASCII: 000C48656C6C6F20576F726C642E
Hello World.