X-Git-Url: https://pd.if.org/git/?a=blobdiff_plain;f=includes%2Flocale.h;h=16aa64920cb7760272d36041b8b01cf5d2295a49;hb=be738e08ec9ba2498d81153bee1de9b8af7e764c;hp=fd014db44469b13fe8ae4f77f98c44534617bcfe;hpb=0fa6394bc70eab55e0e38703a31a3072232c0729;p=pdclib diff --git a/includes/locale.h b/includes/locale.h index fd014db..16aa649 100644 --- a/includes/locale.h +++ b/includes/locale.h @@ -1,6 +1,4 @@ -/* $Id$ */ - -/* 7.11 Localization +/* Localization This file is part of the Public Domain C Library (PDCLib). Permission is granted to use, modify, and / or redistribute at will. @@ -8,6 +6,16 @@ #ifndef _PDCLIB_LOCALE_H #define _PDCLIB_LOCALE_H _PDCLIB_LOCALE_H +#include "_PDCLIB_int.h" + +#ifdef __cplusplus +extern "C" { +#endif + +#ifndef _PDCLIB_NULL_DEFINED +#define _PDCLIB_NULL_DEFINED _PDCLIB_NULL_DEFINED +#define NULL _PDCLIB_NULL +#endif /* The structure returned by localeconv(). @@ -51,29 +59,24 @@ struct lconv char int_n_sep_by_space; /* Same as above, for international format */ char int_p_sign_posn; /* Same as above, for international format */ char int_n_sign_posn; /* Same as above, for international format */ -} - -#ifndef _PDCLIB_NULL_DEFINED -#define _PDCLIB_NULL_DEFINED _PDCLIB_NULL_DEFINED -#define NULL _PDCLIB_NULL -#endif +}; -/* LC_ALL - - entire locale - LC_COLLATE - - strcoll(), strxfrm() - LC_CTYPE - - - LC_MONETARY - - monetary formatting as returned by localeconv - LC_NUMERIC - - decimal-point character for printf() / scanf() functions, string - conversions, and nonmonetary formattign as returned by localeconv - LC_TIME - - strftime(), wcsftime() - - First arguments to setlocale(). +/* First arguments to setlocale(). + TODO: Beware, values might change before v0.6 is released. */ +/* Entire locale */ +#define LC_ALL -1 +/* Collation (strcoll(), strxfrm()) */ +#define LC_COLLATE 0 +/* Character types () */ +#define LC_CTYPE 1 +/* Monetary formatting (as returned by localeconv) */ +#define LC_MONETARY 2 +/* Decimal-point character (for printf() / scanf() functions), string + conversions, nonmonetary formatting as returned by localeconv */ +#define LC_NUMERIC 3 +/* Time formats (strftime(), wcsftime()) */ +#define LC_TIME 4 /* The category parameter can be any of the LC_* macros to specify if the call to setlocale() shall affect the entire locale or only a portion thereof. @@ -83,12 +86,58 @@ struct lconv Otherwise, returns a pointer to a string associated with the specified category for the new locale. */ -char * setlocale( int category, const char * locale ); +char * setlocale( int category, const char * locale ) _PDCLIB_nothrow; /* Returns a struct lconv initialized to the values appropriate for the current locale setting. */ -struct lconv * localeconv( void ); +struct lconv * localeconv( void ) _PDCLIB_nothrow; + +#if _PDCLIB_POSIX_MIN(2008) +#define LC_COLLATE_MASK (1 << LC_COLLATE) +#define LC_CTYPE_MASK (1 << LC_CTYPE) +#define LC_MONETARY_MASK (1 << LC_MONETARY) +#define LC_NUMERIC_MASK (1 << LC_NUMERIC) +#define LC_TIME_MASK (1 << LC_TIME) +#define LC_ALL_MASK (LC_COLLATE_MASK | LC_CTYPE_MASK | LC_MONETARY_MASK | \ + LC_NUMERIC_MASK | LC_TIME_MASK) + + +/* POSIX locale type */ +typedef _PDCLIB_locale_t locale_t; + +/* Global locale */ +extern struct _PDCLIB_locale _PDCLIB_global_locale; +#define LC_GLOBAL_LOCALE (&_PDCLIB_global_locale) + +#ifdef _PDCLIB_LOCALE_METHOD + +locale_t newlocale(int category_mask, const char *locale, locale_t base); + +/* Set the thread locale to newlocale + * + * If newlocale is (locale_t)0, then doesn't change the locale and just returns + * the existing locale. + * + * If newlocale is LC_GLOBAL_LOCALE, resets the thread's locale to use the + * global locale. + * + * Returns the previous thread locale. If the thread had no previous locale, + * returns the global locale. + */ +locale_t uselocale( locale_t newlocale ); + +/* Returns a copy of loc */ +locale_t duplocale( locale_t loc ); + +/* Frees the passed locale object */ +void freelocale( locale_t loc ); +#endif #endif +#ifdef __cplusplus +} +#endif + +#endif