3 /* 7.11 Localization <locale.h>
5 This file is part of the Public Domain C Library (PDCLib).
6 Permission is granted to use, modify, and / or redistribute at will.
9 #ifndef _PDCLIB_LOCALE_H
10 #define _PDCLIB_LOCALE_H _PDCLIB_LOCALE_H
11 #include <_PDCLIB_int.h>
12 _PDCLIB_BEGIN_EXTERN_C
14 #ifndef _PDCLIB_NULL_DEFINED
15 #define _PDCLIB_NULL_DEFINED _PDCLIB_NULL_DEFINED
16 #define NULL _PDCLIB_NULL
19 /* The structure returned by localeconv().
21 The values for *_sep_by_space:
23 1 - if symbol and sign are adjacent, a space seperates them from the value;
24 otherwise a space seperates the symbol from the value
25 2 - if symbol and sign are adjacent, a space seperates them; otherwise a
26 space seperates the sign from the value
28 The values for *_sign_posn:
29 0 - Parentheses surround value and symbol
30 1 - sign precedes value and symbol
31 2 - sign succeeds value and symbol
32 3 - sign immediately precedes symbol
33 4 - sign immediately succeeds symbol
37 char * decimal_point; /* decimal point character */
38 char * thousands_sep; /* character for seperating groups of digits */
39 char * grouping; /* string indicating the size of digit groups */
40 char * mon_decimal_point; /* decimal point for monetary quantities */
41 char * mon_thousands_sep; /* thousands_sep for monetary quantities */
42 char * mon_grouping; /* grouping for monetary quantities */
43 char * positive_sign; /* string indicating nonnegative mty. qty. */
44 char * negative_sign; /* string indicating negative mty. qty. */
45 char * currency_symbol; /* local currency symbol (e.g. '$') */
46 char * int_curr_symbol; /* international currency symbol (e.g. "USD" */
47 char frac_digits; /* fractional digits in local monetary qty. */
48 char p_cs_precedes; /* if currency_symbol precedes positive qty. */
49 char n_cs_precedes; /* if currency_symbol precedes negative qty. */
50 char p_sep_by_space; /* if it is seperated by space from pos. qty. */
51 char n_sep_by_space; /* if it is seperated by space from neg. qty. */
52 char p_sign_posn; /* positioning of positive_sign for mon. qty. */
53 char n_sign_posn; /* positioning of negative_sign for mon. qty. */
54 char int_frac_digits; /* Same as above, for international format */
55 char int_p_cs_precedes; /* Same as above, for international format */
56 char int_n_cs_precedes; /* Same as above, for international format */
57 char int_p_sep_by_space; /* Same as above, for international format */
58 char int_n_sep_by_space; /* Same as above, for international format */
59 char int_p_sign_posn; /* Same as above, for international format */
60 char int_n_sign_posn; /* Same as above, for international format */
63 /* First arguments to setlocale().
64 TODO: Beware, values might change before v0.6 is released.
68 /* Collation (strcoll(), strxfrm()) */
70 /* Character types (<ctype.h>) */
72 /* Monetary formatting (as returned by localeconv) */
74 /* Decimal-point character (for printf() / scanf() functions), string
75 conversions, nonmonetary formatting as returned by localeconv */
77 /* Time formats (strftime(), wcsftime()) */
80 /* The category parameter can be any of the LC_* macros to specify if the call
81 to setlocale() shall affect the entire locale or only a portion thereof.
82 The category locale specifies which locale should be switched to, with "C"
83 being the minimal default locale, and "" being the locale-specific native
84 environment. A NULL pointer makes setlocale() return the *current* setting.
85 Otherwise, returns a pointer to a string associated with the specified
86 category for the new locale.
88 char * setlocale( int category, const char * locale ) _PDCLIB_nothrow;
90 /* Returns a struct lconv initialized to the values appropriate for the current
93 struct lconv * localeconv( void ) _PDCLIB_nothrow;
95 #if _PDCLIB_POSIX_MIN(2008)
96 #define LC_COLLATE_MASK (1 << LC_COLLATE)
97 #define LC_CTYPE_MASK (1 << LC_CTYPE)
98 #define LC_MONETARY_MASK (1 << LC_MONETARY)
99 #define LC_NUMERIC_MASK (1 << LC_NUMERIC)
100 #define LC_TIME_MASK (1 << LC_TIME)
101 #define LC_ALL_MASK (LC_COLLATE_MASK | LC_CTYPE_MASK | LC_MONETARY_MASK | \
102 LC_NUMERIC_MASK | LC_TIME_MASK)
105 /* POSIX locale type */
106 typedef _PDCLIB_locale_t locale_t;
109 extern struct _PDCLIB_locale _PDCLIB_global_locale;
110 #define LC_GLOBAL_LOCALE (&_PDCLIB_global_locale)
112 #ifdef _PDCLIB_LOCALE_METHOD
114 locale_t newlocale(int category_mask, const char *locale, locale_t base);
116 /* Set the thread locale to newlocale
118 * If newlocale is (locale_t)0, then doesn't change the locale and just returns
119 * the existing locale.
121 * If newlocale is LC_GLOBAL_LOCALE, resets the thread's locale to use the
124 * Returns the previous thread locale. If the thread had no previous locale,
125 * returns the global locale.
127 locale_t uselocale(locale_t newlocale);
129 /* Returns a copy of loc */
130 locale_t duplocale(locale_t loc);
132 /* Frees the passed locale object */
133 void freelocale(locale_t loc);