1
2
3
4
5
6
7
8
9gd_free_entry_strings(3)            GETDATA           gd_free_entry_strings(3)
10
11
12

NAME

14       gd_free_entry_strings — free strings in a GetData gd_entry_t object
15
16

SYNOPSIS

18       #include <getdata.h>
19
20       gd_entry_t *gd_free_entry_strings(gd_entry_t *entry);
21
22

DESCRIPTION

24       The  gd_free_entry_strings() function frees the character strings found
25       in the gd_entry_t object entry which were  previously  allocated  by  a
26       call to gd_entry(3).  After freeing a string, the associated pointer is
27       set to NULL.  If entry is NULL, this function does nothing.
28
29       If non-NULL, entry must point  to  a  valid  and  properly  initialised
30       gd_entry_t  object,  such as that returned by gd_entry(3).  By default,
31       strings are deallocated by calling free(3) on  each,  but  a  different
32       memory  manager  may  be  specified by calling gd_alloc_funcs(3) before
33       calling this function.
34
35       See gd_entry(3) for a description of the gd_entry_t data type.
36
37

RETURN VALUE

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

NOTES

43       This function is provided as a convenience only.  The caller may  deal‐
44       locate the strings in the gd_entry_t object provided by gd_entry(3) it‐
45       self simply by calling the deallocator on the each  initialised  string
46       member, if they prefer to do so.
47
48

HISTORY

50       The dirfile_free_entry_strings() function appeared in GetData-0.3.0.
51
52       In GetData-0.7.0, this function was renamed to gd_free_entry_strings().
53
54

SEE ALSO

56       gd_alloc_funcs(3), gd_entry(3)
57
58
59
60Version 0.10.0                 25 December 2016       gd_free_entry_strings(3)
Impressum