function rb_get_kwargs

キーワード引数のハッシュ keyword_hash から、table に並べたキーワードに対応する値を取り出して values に格納します。取り出した要素は keyword_hash から削除されます。

table の先頭の required 個のキーワードは必須です。続く optional 個のキーワードは省略できます。 optional が負のときは、省略できるキーワードは -optional-1 個で、table にない残りのキーワードは無視されます。 optional が負でなければ、table にないキーワードがあると例外が発生します。省略できるキーワードが keyword_hash になければ、values の対応する要素には Qundef が設定されます。

C API でキーワード引数を扱うのは Ruby で扱うよりも効率が悪くなります。 Ruby でラッパーメソッドを書き、キーワード引数を取らない C の関数を呼び出すことも検討してください。

[PARAM] keyword_hash:

分解するキーワード引数のハッシュです。

[PARAM] table:

取り出したいキーワードの ID の配列です。

[PARAM] required:

必須のキーワードの個数です。

[PARAM] optional:

省略できるキーワードの個数です。負の数も指定できます。

[PARAM] values:

取り出した値を格納するバッファです。

[RETURN]

values に格納した値の個数です。

[EXCEPTION] ArgumentError:

必須のキーワードがないとき。

[EXCEPTION] ArgumentError:

未知のキーワードがあったとき。