debian man page for gd_free_entry_strings

Query: gd_free_entry_strings

OS: debian

Section: 3

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

gd_free_entry_strings(3)					      GETDATA						  gd_free_entry_strings(3)

NAME
gd_free_entry_strings -- free strings in a GetData gd_entry_t object
SYNOPSIS
#include <getdata.h> gd_entry_t *gd_free_entry_strings(gd_entry_t *entry);
DESCRIPTION
The gd_free_entry_strings() function frees the character strings found in the gd_entry_t object entry which were previously allocated by a call to gd_entry(3). If entry is NULL, this function does nothing. If non-NULL, entry must point to a valid and properly initialised gd_entry_t object, such as that returned by gd_entry(3). As well, the caller may construct a properly initialised gd_entry_t object by first setting all bits to zero, then setting the field_type parameter to the desired gd_entype_t symbol, and finally initialising only the members defined for that type. The results of calling this function are undefined if the character strings pointed to by the string members of entry have not been allocated with malloc(3), unless these pointer members are equal to NULL. See gd_entry(3) for a complete description of the gd_entry_t data type.
RETURN VALUE
A call to gd_free_entry_strings() always returns its input, entry.
NOTES
This function is provided as a convenience only. Callers may free strings allocated by gd_entry(3) themselves by simply calling free(3) on the appropriate members for the given entry type, if they prefer to do so.
SEE ALSO
gd_entry(3), free(3) Version 0.7.0 16 June 2010 gd_free_entry_strings(3)
Related Man Pages
gd_add(3) - debian
gd_fragment_index(3) - debian
gd_madd(3) - debian
gd_mvector_list(3) - debian
gd_strings(3) - debian
Similar Topics in the Unix Linux Community
How can I do this in VI editor?
Detecting unused variables...
How to copy a column of multiple files and paste into new excel file (next to column)?
My first PERL incarnation... Audio Oscillograph