array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'ffi.new.php', 1 => 'FFI::new', 2 => 'Cria uma estrutura de dados C', ), 'up' => array ( 0 => 'class.ffi.php', 1 => 'FFI', ), 'prev' => array ( 0 => 'ffi.memset.php', 1 => 'FFI::memset', ), 'next' => array ( 0 => 'ffi.scope.php', 1 => 'FFI::scope', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/ffi/ffi/new.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

FFI::new

(PHP 7 >= 7.4.0, PHP 8)

FFI::new — Cria uma estrutura de dados C

Descrição

public FFI::new(FFI\CType|string $type, bool $owned = true, bool $persistent = false): ?FFI\CData

Cria uma estrutura de dados nativa do tipo C fornecido. Qualquer tipo declarado para a instância é permitido.

Parâmetros

type
type é uma declaração C válida como uma string ou uma instância de FFI\CType que já tenha sido criada.
owned
Define se serão criados dados próprios (ou seja, gerenciados) ou não gerenciados. Os dados gerenciados residem junto com o objeto FFI\CData retornado e são liberados quando a última referência a esse objeto é liberada pela contagem regular de referências do PHP ou pelo GC. Dados não gerenciados devem ser liberados chamando FFI::free(), quando não forem mais necessários.
persistent
Define se a estrutura de dados C será alocada permanentemente na memória do sistema (usando malloc()) ou na memória de requisição do PHP (usando emalloc()).

Valor Retornado

Retorna o objeto FFI\CData recém criado ou null em caso de falha.

Registro de Alterações

Versão Descrição
8.3.0 Chamar FFI::new() estaticamente agora foi descontinuado.