function rb_utf8_str_new

UTF-8 の新しい String を作成します。 rb_str_new と同じですが、エンコーディングが UTF-8 になります。

[PARAM] ptr:

文字列の内容を持つ、len バイト以上のメモリ領域です。

[PARAM] len:

ptr の長さです。終端の NUL 文字を含まないバイト数で指定します。

[RETURN]

ptr の内容をそのままコピーした、長さ len バイトで UTF-8 の新しい String です。

[EXCEPTION] NoMemoryError:

len+1 バイトの確保に失敗したとき。

[EXCEPTION] ArgumentError:

len が負のとき。