UTF8 関数

目的

引数に相当する UTF-8 文字の文字列を返します。

構文

UTF8(x)

パラメーター

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.

制限事項

なし。