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
12 /* The structure returned by localeconv().
14 The values for *_sep_by_space:
16 1 - if symbol and sign are adjacent, a space seperates them from the value;
17 otherwise a space seperates the symbol from the value
18 2 - if symbol and sign are adjacent, a space seperates them; otherwise a
19 space seperates the sign from the value
21 The values for *_sign_posn:
22 0 - Parentheses surround value and symbol
23 1 - sign precedes value and symbol
24 2 - sign succeeds value and symbol
25 3 - sign immediately precedes symbol
26 4 - sign immediately succeeds symbol
30 char * decimal_point; /* decimal point character */
31 char * thousands_sep; /* character for seperating groups of digits */
32 char * grouping; /* string indicating the size of digit groups */
33 char * mon_decimal_point; /* decimal point for monetary quantities */
34 char * mon_thousands_sep; /* thousands_sep for monetary quantities */
35 char * mon_grouping; /* grouping for monetary quantities */
36 char * positive_sign; /* string indicating nonnegative mty. qty. */
37 char * negative_sign; /* string indicating negative mty. qty. */
38 char * currency_symbol; /* local currency symbol (e.g. '$') */
39 char * int_curr_symbol; /* international currency symbol (e.g. "USD" */
40 char frac_digits; /* fractional digits in local monetary qty. */
41 char p_cs_precedes; /* if currency_symbol precedes positive qty. */
42 char n_cs_precedes; /* if currency_symbol precedes negative qty. */
43 char p_sep_by_space; /* if it is seperated by space from pos. qty. */
44 char n_sep_by_space; /* if it is seperated by space from neg. qty. */
45 char p_sign_posn; /* positioning of positive_sign for mon. qty. */
46 char n_sign_posn; /* positioning of negative_sign for mon. qty. */
47 char int_frac_digits; /* Same as above, for international format */
48 char int_p_cs_precedes; /* Same as above, for international format */
49 char int_n_cs_precedes; /* Same as above, for international format */
50 char int_p_sep_by_space; /* Same as above, for international format */
51 char int_n_sep_by_space; /* Same as above, for international format */
52 char int_p_sign_posn; /* Same as above, for international format */
53 char int_n_sign_posn; /* Same as above, for international format */
56 #ifndef _PDCLIB_NULL_DEFINED
57 #define _PDCLIB_NULL_DEFINED _PDCLIB_NULL_DEFINED
58 #define NULL _PDCLIB_NULL
64 - strcoll(), strxfrm()
68 - monetary formatting as returned by localeconv
70 - decimal-point character for printf() / scanf() functions, string
71 conversions, and nonmonetary formattign as returned by localeconv
73 - strftime(), wcsftime()
75 First arguments to setlocale().
78 /* The category parameter can be any of the LC_* macros to specify if the call
79 to setlocale() shall affect the entire locale or only a portion thereof.
80 The category locale specifies which locale should be switched to, with "C"
81 being the minimal default locale, and "" being the locale-specific native
82 environment. A NULL pointer makes setlocale() return the *current* setting.
83 Otherwise, returns a pointer to a string associated with the specified
84 category for the new locale.
86 char * setlocale( int category, const char * locale );
88 /* Returns a struct lconv initialized to the values appropriate for the current
91 struct lconv * localeconv( void );