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_strings(3) | GETDATA | gd_strings(3) |
NAME¶
gd_strings — retrieve a list of string values from a dirfileSYNOPSIS¶
#include <getdata.h>const char
**gd_strings(DIRFILE *dirfile);
DESCRIPTION¶
The gd_strings() function queries a dirfile(5) database specified by dirfile and returns a read-only list of values of the all STRING type fields defined in the database. Notably, this list does not include /META subfields.RETURN VALUE¶
Upon successful completion, gd_strings() returns a pointer to an array of strings containing the values of all the STRING fields defined in the dirfile database. If no strings are defined in the database, 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_DIRFILE
- The supplied dirfile was invalid.
SEE ALSO¶
dirfile(5), gd_open(3), gd_error(3), gd_error_string(3), gd_field_list_by_type(3), gd_mstrings(3), gd_nfields_by_type(3), gd_string(3)15 October 2010 | Version 0.7.0 |