function rb_enc_str_new

エンコーディングを指定して、新しい String を作成します。 rb_str_new と同じですが、エンコーディング enc を持つ文字列になります。

enc には NULL も指定できます。その場合は、US-ASCII の文字列を作成する rb_usascii_str_new と同じになります。

[PARAM] ptr:

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

[PARAM] len:

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

[PARAM] enc:

ptr のエンコーディングです。

[RETURN]

ptr の内容をそのままコピーした、長さ len バイトで enc のエンコーディングの新しい String です。

[EXCEPTION] NoMemoryError:

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

[EXCEPTION] ArgumentError:

len が負のとき。