freelocale - free resources allocated for a locale object
The freelocale() function shall cause the resources allocated for a locale object returned by a call to the newlocale() or duplocale() functions to be released.
The behavior is undefined if the locobj argument is the special locale object LC_GLOBAL_LOCALE or is not a valid locale object handle.
Any use of a locale object that has been freed results in undefined behavior.
Freeing Up a Locale Object
The following example shows a code fragment to free a locale object created by newlocale():#include <locale.h> ...
/* Every locale object allocated with newlocale() should be * freed using freelocale(): */
/* Get the locale. */
loc = newlocale (LC_CTYPE_MASK | LC_TIME_MASK, "locname", NULL);
/* ... Use the locale object ... */ ...
/* Free the locale object resources. */ freelocale (loc);
duplocale, newlocale, uselocale
First released in Issue 7.
POSIX.1-2008, Technical Corrigendum 1, XSH/TC1-2008/0180  is applied.
return to top of page