PDCLIB-2 PDCLIB-9: As an extension, add the POSIX thread-local locale API

[pdclib.old] / includes / locale.h

diff --git a/includes/locale.h b/includes/locale.h
index d849244efffa8a56ddd301ce33f3ce89c9e393a5..21221e33e64df11f71a6eff1d767814d8fcc53d8 100644 (file)
--- a/includes/locale.h
+++ b/includes/locale.h
@@ -8,11 +8,8 @@
 
 #ifndef _PDCLIB_LOCALE_H
 #define _PDCLIB_LOCALE_H _PDCLIB_LOCALE_H
-
-#ifndef _PDCLIB_INT_H
-#define _PDCLIB_INT_H _PDCLIB_INT_H
 #include <_PDCLIB_int.h>
-#endif
+_PDCLIB_BEGIN_EXTERN_C
 
 #ifndef _PDCLIB_NULL_DEFINED
 #define _PDCLIB_NULL_DEFINED _PDCLIB_NULL_DEFINED
@@ -68,22 +65,22 @@ struct lconv
 /* This is strictly internal, and visible here for technical reasons only. */
 extern struct lconv _PDCLIB_lconv;
 
-/* LC_ALL
-   - entire locale
-   LC_COLLATE
-   - strcoll(), strxfrm()
-   LC_CTYPE
-   - <ctype.h>
-   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      0
+/* Collation (strcoll(), strxfrm()) */
+#define LC_COLLATE  1
+/* Character types (<ctype.h>) */
+#define LC_CTYPE    2
+/* Monetary formatting (as returned by localeconv) */
+#define LC_MONETARY 3
+/* Decimal-point character (for printf() / scanf() functions), string
+   conversions, nonmonetary formatting as returned by localeconv              */
+#define LC_NUMERIC  4
+/* Time formats (strftime(), wcsftime()) */
+#define LC_TIME     5
 
 /* 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.
@@ -93,12 +90,37 @@ extern struct lconv _PDCLIB_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)
+typedef _PDCLIB_locale_t locale_t;
+
+/* 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
 
+_PDCLIB_END_EXTERN_C
 #endif