FFI::load

(PHP 7 >= 7.4.0, PHP 8)

FFI::loadCharge les déclarations C à partir d'un fichier d'en-tête C

Description

publicstaticFFI::load(string$filename): ?FFI

Charge les déclarations C à partir d'un fichier d'en-tête C. Il est possible de spécifier les bibliothèques partagées qui doivent être chargées, en utilisant des définitions spéciales FFI_LIB dans le fichier d'en-tête C chargé.

Liste de paramètres

filename

Le nom d'un fichier d'en-tête C.

Les directives du préprocesseur C ne sont pas supportées, c'est-à-dire #include, #define et les macros CPP ne fonctionnent pas, sauf dans les cas particuliers énumérés ci-dessous.

Le fichier d'en-tête devrait contenir une déclaration #define pour la variable FFI_SCOPE, par exemple : #define FFI_SCOPE "MYLIB". Reportez-vous à l'introduction de la classe pour plus de détails.

Le fichier d'en-tête peut contenir une déclaration #define pour la variable FFI_LIB pour spécifier la bibliothèque qu'elle expose. S'il s'agit d'une bibliothèque système, seul le nom du fichier est requis, par exemple : #define FFI_LIB "libc.so.6". S'il s'agit d'une bibliothèque personnalisée, un chemin relatif est requis, par exemple : #define FFI_LIB "./mylib.so".

Valeurs de retour

Retourne l'objet FFI fraîchement créé, ou null en cas d'échec.

Voir aussi

  • FFI::scope() - Instancie un objet FFI avec les déclarations C analysées lors du préchargement
To Top