PHP マニュアル

FFI::new

C のデータ構造を作成する

説明

public FFI\CDatanull FFI::new(FFI\CTypestring $type, bool $owned = true, bool $persistent = false)

与えられた C の型を持つネイティブデータ構造を作成します。このインスタンスで宣言された任意の型が使えます。

パラメータ

type: type は、有効な C の宣言を表す string か、作成済みの FFI\CType のインスタンスです。
owned: 所有された (マネージドな) データを作成するか、アンマネージドなデータを作成するか。マネージドデータは返される FFI\CData オブジェクトと共に生存し、そのオブジェクトへの最後の参照が PHP の通常のリファレンスカウントや GC によって解放されたときに解放されます。アンマネージドなデータは、不要になったら FFI::free を呼んで解放すべきです。
persistent: この C のデータ構造をシステムヒープ上に永続的に確保するか (malloc を使用)、 PHP のリクエストヒープ上に確保するか (emalloc を使用)。

戻り値

新しく作成された FFI\CData オブジェクトを返します。失敗時には null を返します。

変更履歴

バージョン	説明
8.3.0	FFI::new を static メソッドとして呼び出すのは非推奨となりました。