Man page - gd_free_entry_strings(3)

Packages contains this manual

Manual

gd_free_entry_strings

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
NOTES
HISTORY
SEE ALSO

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). After freeing a string, the associated pointer is set to NULL. 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). By default, strings are deallocated by calling free (3) on each, but a different memory manager may be specified by calling gd_alloc_funcs (3) before calling this function.

See gd_entry (3) for a description of the gd_entry_t data type.

RETURN VALUE

The function gd_free_entry_strings () always returns its input, entry .

NOTES

This function is provided as a convenience only. The caller may deallocate the strings in the gd_entry_t object provided by gd_entry (3) itself simply by calling the deallocator on the each initialised string member, if they prefer to do so.

HISTORY

The dirfile_free_entry_strings () function appeared in GetData-0.3.0.

In GetData-0.7.0, this function was renamed to gd_free_entry_strings ().

SEE ALSO

gd_alloc_funcs (3), gd_entry (3)