C のデータハンドル

はじめに

FFI\CData オブジェクトは、通常の PHP データのように様々な方法で使用できます:

• スカラー型の C のデータは $cdata プロパティを通してアクセスできます。例: $x = FFI::new('int'); $x->cdata = 42;
• C の構造体や共用体のフィールドは通常の PHP のオブジェクトプロパティのようにアクセスできます。例: $cdata->field
• C の配列要素は通常の PHP の配列要素のようにアクセスできます。例: $cdata[$offset]
• C の配列は foreach 文を使って反復できます。
• C の配列は count() の引数として使えます。
• C のポインタは配列のように参照外しできます。例: $cdata[0]
• C のポインタは通常の比較演算子を使って比較できます (<、 <=、==、!=、>=、>)。
• C のポインタは通常の +/-/ ++/-- 演算子を使ってインクリメント・デクリメントできます。例: $cdata += 5
• C のポインタは通常の - 演算子を使って他のポインタと引き算できます。
• C の関数ポインタは通常の PHP のクロージャのように呼び出せます。例: $cdata()
• 任意の C のデータは clone 演算子を使って 複製できます。例: $cdata2 = clone $cdata;
• 任意の C のデータは var_dump() や print_r() 等を 使って可視化できます。
• PHP 8.3.0 以降、FFI\CData は構造体やフィールドに代入できるようになりました。

注意: 特筆すべき制限として、FFI\CData インスタンスは isset()、empty()、unset() をサポートしていません。 また、ラップされた C の構造体や共用体は Traversable を実装していません。

クラス概要

変更履歴