Function
GLibclear_pointer
since: 2.34
Description
Clears a reference to a variable.
pp
must not be NULL
.
If the reference is NULL
then this function does nothing.
Otherwise, the variable is destroyed using destroy
and the
pointer is set to NULL
.
A macro is also included that allows this function to be used without
pointer casts. This will mask any warnings about incompatible function types
or calling conventions, so you must ensure that your destroy
function is
compatible with being called as GDestroyNotify
using the standard calling
convention for the platform that GLib was compiled for; otherwise the program
will experience undefined behaviour.
Available since: 2.34
This function is not directly available to language bindings.
Parameters
pp
-
Type:
gpointer*
A pointer to a variable, struct member etc. holding a pointer.
The argument will be modified by the function. destroy
-
Type:
GDestroyNotify
A function to which a gpointer can be passed, to destroy *
pp
.