-// ----------------------------------------------------------------------------
-// $Id$
-// ----------------------------------------------------------------------------
-// Public Domain C Library - http://pdclib.sourceforge.net
-// This code is Public Domain. Use, modify, and redistribute at will.
-// ----------------------------------------------------------------------------
-// Provides information on locale specifics as well as a function to change the
-// active locale to something else but the startup default "C".
-// ----------------------------------------------------------------------------
+/* Localization <locale.h>
-#ifndef __LOCALE_H
-#define __LOCALE_H __LOCALE_H
+ This file is part of the Public Domain C Library (PDCLib).
+ Permission is granted to use, modify, and / or redistribute at will.
+*/
-// ----------------------------------------------------------------------------
-// DEFINES
+#ifndef _PDCLIB_LOCALE_H
+#define _PDCLIB_LOCALE_H _PDCLIB_LOCALE_H
+#include "_PDCLIB_int.h"
-#define NULL 0
+#ifdef __cplusplus
+extern "C" {
+#endif
-// Locale categories
-#define LC_COLLATE 1 // affects strcoll() and strxfrm()
-#define LC_CTYPE 2 // affects ctype.h
-#define LC_MONETARY 4 // affects monetary aspect of localeconv()
-#define LC_NUMERIC 8 // affects numeric aspect of localeconv()
-#define LC_TIME 16 // affects strftime()
-#define LC_ALL 31 // affects all of the above
+#ifndef _PDCLIB_NULL_DEFINED
+#define _PDCLIB_NULL_DEFINED _PDCLIB_NULL_DEFINED
+#define NULL _PDCLIB_NULL
+#endif
-// ----------------------------------------------------------------------------
-// TYPEDEFS
+/* The structure returned by localeconv().
-// TODO: Detailed documentation of grouping formats and field values
+ The values for *_sep_by_space:
+ 0 - no space
+ 1 - if symbol and sign are adjacent, a space seperates them from the value;
+ otherwise a space seperates the symbol from the value
+ 2 - if symbol and sign are adjacent, a space seperates them; otherwise a
+ space seperates the sign from the value
+ The values for *_sign_posn:
+ 0 - Parentheses surround value and symbol
+ 1 - sign precedes value and symbol
+ 2 - sign succeeds value and symbol
+ 3 - sign immediately precedes symbol
+ 4 - sign immediately succeeds symbol
+*/
struct lconv
{
- // LC_NUMERIC
- char * decimal_point; // decimal point
- char * grouping; // grouping
- char * thousands_sep; // grouping string
-
- // LC_MONETARY
- char * mon_decimal_point; // decimal point
- char * mon_grouping; // grouping
- char * mon_thousands_sep; // grouping string
- char * negative_sign; // negative sign
- char * positive_sign; // positive sign
- char * currency_symbol; // currency symbol
- char frac_digits; // after-point digits
- // negative values
- char n_cs_precedes; // currency symbol preceding value?
- char n_sep_by_space; // currency symbol seperated by space?
- char n_sign_posn; // sign position
- // positive values
- char p_cs_precedes; // currency symbol preceding value?
- char p_sep_by_space; // currency symbol seperated by space?
- char p_sign_posn; // sign position?
-
- // for international monetary values
- char * int_curr_symbol; // international currency symbol (ISO 4217)
- char int_frac_digits; // after-point digits
- // negative values
- char int_n_cs_precedes; // currency symbol preceding value?
- char int_n_sep_by_space; // currency symbol seperated by space?
- char int_n_sign_posn; // sign position?
- // positive values
- char int_p_cs_precedes; // currency symbol preceding value?
- char int_p_sep_by_space; // currency symbol seperated by space?
- char int_p_sign_posn; // sign position?
+ char * decimal_point; /* decimal point character */
+ char * thousands_sep; /* character for seperating groups of digits */
+ char * grouping; /* string indicating the size of digit groups */
+ char * mon_decimal_point; /* decimal point for monetary quantities */
+ char * mon_thousands_sep; /* thousands_sep for monetary quantities */
+ char * mon_grouping; /* grouping for monetary quantities */
+ char * positive_sign; /* string indicating nonnegative mty. qty. */
+ char * negative_sign; /* string indicating negative mty. qty. */
+ char * currency_symbol; /* local currency symbol (e.g. '$') */
+ char * int_curr_symbol; /* international currency symbol (e.g. "USD" */
+ char frac_digits; /* fractional digits in local monetary qty. */
+ char p_cs_precedes; /* if currency_symbol precedes positive qty. */
+ char n_cs_precedes; /* if currency_symbol precedes negative qty. */
+ char p_sep_by_space; /* if it is seperated by space from pos. qty. */
+ char n_sep_by_space; /* if it is seperated by space from neg. qty. */
+ char p_sign_posn; /* positioning of positive_sign for mon. qty. */
+ char n_sign_posn; /* positioning of negative_sign for mon. qty. */
+ char int_frac_digits; /* Same as above, for international format */
+ char int_p_cs_precedes; /* Same as above, for international format */
+ char int_n_cs_precedes; /* Same as above, for international format */
+ char int_p_sep_by_space; /* Same as above, for international format */
+ 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 */
};
-// ----------------------------------------------------------------------------
-// FUNCTIONS
+/* 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 (<ctype.h>) */
+#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
-// Returns a (pointer to a) lconv structure holding the values for the current
-// locale. The structure must not be changed; values might become outdated with
-// later calls to setlocale() changing LC_NUMERIC, LC_MONETARY or LC_ALL.
-struct lconv * localeconv( void );
+/* 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.
+ The category locale specifies which locale should be switched to, with "C"
+ being the minimal default locale, and "" being the locale-specific native
+ environment. A NULL pointer makes setlocale() return the *current* setting.
+ Otherwise, returns a pointer to a string associated with the specified
+ category for the new locale.
+*/
+char * setlocale( int category, const char * locale ) _PDCLIB_nothrow;
-// Categories are selected by OR'ing the LC_* defines from this header. The
-// function sets the current locale to that defined by locale_name, and returns
-// the name of the new locale (if it was set successfully) or a null pointer
-// (if unsuccessful). At startup, the current locale is "C" by default. A null
-// pointer as locale_name leaves the locale unchanged, an empty string sets it
-// to the "native" locale.
-char * setlocale( int categories, const char * locale_name );
+/* Returns a struct lconv initialized to the values appropriate for the current
+ locale setting.
+*/
+struct lconv * localeconv( void ) _PDCLIB_nothrow;
-#endif // __LOCALE_H
+#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
projects / pdclib / blobdiff