Gestionnaire de données C

Introduction

Les objets FFI\CData peuvent être utilisés de différentes manières, comme des données PHP normales :

• Les données C de type scalaire peuvent être lues et assignées via la propriété $cdata, par exemple. $x = FFI::new('int'); $x->cdata = 42;
• Les champs de type struct et union peuvent être accédés comme des propriétés d'objets PHP ordinaires, par exemple $cdata->field
• Les éléments d'un tableau C sont accessibles comme les éléments d'un tableau PHP, par exemple. $cdata[$offset]
• Les tableaux C peuvent être itérés en utilisant des instructions foreach.
• Les tableaux C peuvent être utilisés comme arguments de count().
• Les pointeurs C peuvent être déréférencés comme des tableaux, par exemple $cdata[0]
• Les pointeurs C peuvent être comparés à l'aide d'opérateurs de comparaison ordinaires (<, <=, ==, !=, >=, >).
• Les pointeurs C peuvent être incrémentés et décrémentés à l'aide des opérations ordinaires +/-/++/--, par exemple $cdata += 5
• Les pointeurs C peuvent être soustraits d'un autre à l'aide d'opérations ordinaires -.
• Les pointeurs C vers des fonctions peuvent être appelés comme une fermeture PHP classique, par exemple $cdata()
• Toute donnée C peut être dupliquée en utilisant l'opérateur clone, par exemple $cdata2 = clone $cdata;
• Toutes les données C peuvent être visualisées à l'aide de var_dump(), print_r(), etc.
• FFI\CData peut maintenant être attribué à des structures et des champs à partir de PHP 8.3.0.

Note: Les limitations notables sont que les instances de FFI\CData ne supportent pas les fonctions isset(), empty() et unset(), et que les structs et unions C enveloppés n'implémentent pas Traversable.

Synopsis de la classe

Historique