Let's assume we have a C struct:
typedef struct _Z3_ast *Z3_ast;
and we want to create an array:
Z3_ast args[2];
and assign values:
args[1] = x;
args[1] = y;
The PHP FFI equivalent would be:
<?php
$ffi = FFI::cdef(...
// Create Z3_ast[2] type
$arg_type = FFI::arrayType($ffi->type('Z3_ast'), [2]);
// Create array of type Z3_ast[2]
$args = FFI::new($arg_type);
// Populate the array
$args[0] = $x;
$args[1] = $y;
?>
FFI::new
(PHP 7 >= 7.4.0, PHP 8)
FFI::new — Создаёт структуру данных C
Описание
public static FFI::new(FFI\CType|string
$type, bool $owned = true, bool $persistent = false): FFI\CData|nullpublic static FFI::new(FFI\CType|string
$type, bool $owned = true, bool $persistent = false): FFI\CData|null
Создаёт нативную структуру данных заданного типа.
При статическом вызове данного метода необходимо использовать
только предопределённые имена типов С (такие как
int, char, и т.д.); при вызове как
метод объекта, допустим любой тип объявленный для него.
Список параметров
-
type -
type- корректная декларация типа С, например, string или заранее созданный объект класса FFI\CType. -
owned -
Создавать ли управляемые или неуправляемые данные. Управляемые данные живут в связке с возвращённым объектом FFI\CData и высвобождается когда стандартный подсчёт ссылок PHP или GC (сборщик мусора) освободят последнюю ссылку на этот объект. Неуправляемые данные необходимо высвобождать вручную с помощью FFI::free().
-
persistent -
Располагать ли данные на постоянной основе к системной куче(heap) (используя malloc()), или в куче запроса PHP (используя emalloc()).
Возвращаемые значения
Возвращает новый объект FFI\CData
или null в случае возникновения ошибки.
add a note
User Contributed Notes 1 note
baminazad at cs dot stonybrook dot edu ¶
4 years ago
