NAME

ffi_prep_cif — Prepare a ffi_cif structure for use with ffi_call

SYNOPSIS

#include <ffi.h>

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

DESCRIPTION

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>.

SEE ALSO

ffi(3), ffi_call(3), ffi_prep_cif_var(3)