table of contents
other versions
- wheezy 0.7.3-6
- jessie 0.7.3-6+b2
- testing 0.9.4-1
- unstable 0.9.4-1
- experimental 0.10.0-1
gd_mconstants(3) | GETDATA | gd_mconstants(3) |
NAME¶
gd_mconstants — retrieve a list of constant values from a dirfileSYNOPSIS¶
#include <getdata.h>const void
*gd_mconstants(DIRFILE *dirfile, const char
*parent, gd_type_t return_type);
DESCRIPTION¶
The gd_mconstants() function queries a dirfile(5) database specified by dirfile and returns a read-only list of values of the all CONST type metafields for the supplied parent field after type conversion to the data type specified by return_type.RETURN VALUE¶
Upon successful completion, gd_mconstants() returns a pointer to an array of values containing the values of all the CONST metafields for the supplied parent field. If the parent field has no constant metafields, NULL is returned. On error it returns NULL and sets the dirfile error to a non-zero error value. Possible error values are:- GD_E_ALLOC
- The library was unable to allocate memory.
- GD_E_BAD_CODE
- The supplied parent field code was not found, or referred to a metafield itself.
- GD_E_BAD_DIRFILE
- The supplied dirfile was invalid.
- GD_E_BAD_TYPE
- The return_type specified was invalid.
SEE ALSO¶
dirfile(5), gd_error(3), gd_error_string(3), gd_field_list_by_type(3), gd_nfields_by_type(3), gd_mcarrays(3), gd_open(3)3 November 2010 | Version 0.7.0 |