ffi_prep_cif(3)

ffi_prep_cif3

Prepare a ffi_cif structure for use with ffi_call

Usage

#include <ffi.h>

ffi_status

ffi_prep_cif(ffi_cif *cif, ffi_abi abi, unsigned int nargs, ffi_type *rtype, ffi_type **atypes);

Overview

The ffi_prep_cif function prepares a ffi_cif structure for use with ffi_call abi specifies a set of calling conventions to use. atypes is an array of nargs pointers to ffi_type structs that describe the data type, size and alignment of each argument. rtype points to an ffi_type that describes the data type, size and alignment of the return value. Note that to call a variadic function ffi_prep_cif_var must be used instead.

Return values

Upon successful completion, ffi_prep_cif returns FFI_OK. It will return FFI_BAD_TYPEDEF if cif is NULL or atypes or rtype is malformed. If abi does not refer to a valid ABI, FFI_BAD_ABI will be returned. Available ABIs are defined in <ffitarget.h>.

Releases

10 releases since Debian 5.0 (Lenny); the text changed 2 times.

  1. 5.0–6.0
  2. 7
  3. 8–Arch

From libffi 3.8.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's mdoc source.