NAME

freelocale — free resources allocated for a locale object

SYNOPSIS

[CX]
#include <locale.h>

void freelocale(locale_t locobj);

DESCRIPTION

The freelocale () function shall cause the resources allocated for a locale object returned by a call to the newlocale(3) or duplocale(3) 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.

RETURN VALUE

None.

ERRORS

None.

The following sections are informative.

EXAMPLES

#include <locale.h>
...


/* Every locale object allocated with newlocale() should be
 * freed using freelocale():
 */


locale_t loc;


/* Get the locale. */


loc = newlocale (LC_CTYPE_MASK | LC_TIME_MASK, "locname", NULL);


/* ... Use the locale object ... */
...


/* Free the locale object resources. */
freelocale (loc);

APPLICATION USAGE

None.

RATIONALE

None.

FUTURE DIRECTIONS

None.

SEE ALSO

duplocale(3), newlocale(3), uselocale(3)

XBD <locale.h>

CHANGE HISTORY

First released in Issue 7.

POSIX.1-2008, Technical Corrigendum 1, XSH/TC1-2008/0180 [283] is applied.

End of informative text.