30.2 freem_ent_t Data Structure

The freem_function() and freem_procedure() APIs in libfreem use the freem_ent_t struct in order to indicate the name of the entry point being called, any arguments being passed to it, and the return value of the called function (not used for freem_procedure()).

The data structure, defined in ‘freem.h’, looks like this:

typedef struct freem_ent_t {

    /* name of function or procedure entry point */
    char name[256];

    /* return value */
    char value[STRLEN];

    /* value of ierr on return */
    short status;

    /* argument count and array */
    unsigned int argument_count;
    char arguments[255][256];

} freem_ent_t;

freem_ent_t Members

‘name’

The ‘name’ member contains the name of the extrinsic function or procedure to be called.

‘value’

This member contains the value returned by the function called. Not used by freem_procedure().

‘status’

This member gives us the value of ierr after the function or procedure call returns. The possible values of ierr are listed in merr.h.

‘argument_count’

The number of arguments to be passed into the extrinsic function or procedure being called. This value represents the maximum index into the first dimension of the arguments array.

‘arguments’

A two-dimensional array containing the arguments to be passed into the extrinsic function or procedure being called.

This document was generated on September 20, 2023 using texi2html 5.0.