function rb_enc_str_new_cstr

エンコーディングを指定して、C の文字列から新しい String を作成します。 rb_enc_str_new と同じですが、ptr が C の文字列であると仮定して長さを求めます。 rb_str_new_cstr と同じですが、エンコーディング enc を持つ文字列になります。

enc には NULL も指定できます。その場合は、rb_usascii_str_new_cstr と同じになります。 ptr は C の文字列なので、enc に UTF-32 のようなものを指定しても意味がありません。

[PARAM] ptr:

C の文字列です。NULL は指定できません。

[PARAM] enc:

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

[RETURN]

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

[EXCEPTION] NoMemoryError:

メモリの確保に失敗したとき。