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_mstrings(3) | GETDATA | gd_mstrings(3) |
NAME¶
gd_mstrings — retrieve a list of string values from a dirfileSYNOPSIS¶
#include <getdata.h>const char
**gd_mstrings(DIRFILE *dirfile, const char
*parent);
DESCRIPTION¶
The gd_mstrings() function queries a dirfile(5) database specified by dirfile and returns a read-only list of values of the all STRING type metafields for the supplied parent field.RETURN VALUE¶
Upon successful completion, gd_mstrings() returns a pointer to an array of strings containing the values of all the STRING metafields for the specified parent field. 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.
SEE ALSO¶
dirfile(5), gd_open(3), gd_error(3), gd_error_string(3), gd_mfield_list_by_type(3), gd_nmfields_by_type(3), gd_strings(3)15 October 2010 | Version 0.7.0 |