diff options
Diffstat (limited to 'src/c_locale.h')
-rw-r--r-- | src/c_locale.h | 450 |
1 files changed, 0 insertions, 450 deletions
diff --git a/src/c_locale.h b/src/c_locale.h deleted file mode 100644 index 36d9961..0000000 --- a/src/c_locale.h +++ /dev/null @@ -1,450 +0,0 @@ -/* - * Copyright (c) 1999 - * Silicon Graphics Computer Systems, Inc. - * - * Copyright (c) 1999 - * Boris Fomitchev - * - * This material is provided "as is", with absolutely no warranty expressed - * or implied. Any use is at your own risk. - * - * Permission to use or copy this software for any purpose is hereby granted - * without fee, provided the above notices are retained on all copies. - * Permission to modify the code and to distribute modified code is granted, - * provided the above notices are retained, and a notice that the code was - * modified is included with the above copyright notice. - * - */ - -/* - * It is impossible to write the C++ locale library in terms of locales - * as defined in the C standard. Instead, we write the C++ locale and I/O - * library in terms of a low level C-like interface. This file defines - * that interface. - * - * The low-level locale interface can't be written portably; there - * must be a version of it for each platform that the C++ library - * is ported to. On many systems this interface may be a thin wrapper - * for existing functionality. - */ - -#ifndef _STLP_C_LOCALE_IMPL_H -#define _STLP_C_LOCALE_IMPL_H - -#include "stlport_prefix.h" - -#include <wchar.h> /* for mbstate_t */ -#include <stl/c_locale.h> - -struct _Locale_name_hint; - -#if defined (_GNU_SOURCE) && defined (__GLIBC__) && \ - ((__GLIBC__ > 2) || (__GLIBC__ == 2 && __GLIBC_MINOR__ >= 2)) -# define _STLP_USE_GLIBC2_LOCALIZATION -# include <nl_types.h> -typedef nl_catd nl_catd_type; -#else -typedef int nl_catd_type; -#endif - -/* - * A number: the maximum length of a simple locale name. - * (i.e. a name like like en_US, as opposed to a name like - * en_US/de_AT/de_AT/es_MX/en_US/en_US) */ -#define _Locale_MAX_SIMPLE_NAME 256 - -#ifdef __cplusplus -extern "C" { -#endif - -/* - * Typedefs: - */ -typedef unsigned short int _Locale_mask_t; - -/* Function called during STLport library load phase. Might contain any - * code necessary to the platform localization layer. - */ -void _Locale_init(void); - -/* Function called during STLport library unload. Might contain any - * code necessary to the platform localization layer. - */ -void _Locale_final(void); - -/* Create a category of the locale with the given name. - * - * The char* argument is a simple (not a composite) locale name, which may - * neither be an empty string nor a null pointer. - * - * These functions return NULL to indicate failure. Failure reason should be reported - * using the __err_code pointer. - */ -struct _Locale_ctype* _Locale_ctype_create(const char *, struct _Locale_name_hint*, int * /* __err_code */); -struct _Locale_codecvt* _Locale_codecvt_create(const char *, struct _Locale_name_hint*, int * /* __err_code */); -struct _Locale_numeric* _Locale_numeric_create(const char *, struct _Locale_name_hint*, int * /* __err_code */); -struct _Locale_time* _Locale_time_create(const char *, struct _Locale_name_hint*, int * /* __err_code */); -struct _Locale_collate* _Locale_collate_create(const char *, struct _Locale_name_hint*, int * /* __err_code */); -struct _Locale_monetary* _Locale_monetary_create(const char *, struct _Locale_name_hint*, int * /* __err_code */); -struct _Locale_messages* _Locale_messages_create(const char *, struct _Locale_name_hint*, int * /* __err_code */); - -/* Give error reason on failure of one of the _Locale_*_create functions. Available - * reasons are: - * 0: No specific error reason has been reported. - * 1: No platform support for the given facet. - * 2: Unknown locale name - * 3: No platform API for localization support. - * 4: No more memory - */ -#define _STLP_LOC_UNDEFINED 0 -#define _STLP_LOC_UNSUPPORTED_FACET_CATEGORY 1 -#define _STLP_LOC_UNKNOWN_NAME 2 -#define _STLP_LOC_NO_PLATFORM_SUPPORT 3 -#define _STLP_LOC_NO_MEMORY 4 - -/* Release a category of a locale - * - * These functions are used to release a category acquired with the - * according _Locale_*_create() functions. - */ -void _Locale_ctype_destroy(struct _Locale_ctype *); -void _Locale_codecvt_destroy(struct _Locale_codecvt *); -void _Locale_numeric_destroy(struct _Locale_numeric *); -void _Locale_time_destroy(struct _Locale_time *); -void _Locale_collate_destroy(struct _Locale_collate *); -void _Locale_monetary_destroy(struct _Locale_monetary *); -void _Locale_messages_destroy(struct _Locale_messages *); - -/* - * Returns the name of the user's default locale in each - * category, as a null-terminated string. A NULL value - * means the default "C" locale. - */ -const char * _Locale_ctype_default(char * __buf); -const char * _Locale_numeric_default(char * __buf); -const char * _Locale_time_default(char * __buf); -const char * _Locale_collate_default(char * __buf); -const char * _Locale_monetary_default(char * __buf); -const char * _Locale_messages_default(char * __buf); - -/* Retrieve the name of the given category - * - * __buf points to a buffer that can hold at least _Locale_MAX_SIMPLE_NAME - * characters. These functions store the name, as a null-terminated - * string, in __buf. This function can't fail, at worst name is truncated. - */ -char const* _Locale_ctype_name(const struct _Locale_ctype *, char* __buf); -char const* _Locale_codecvt_name(const struct _Locale_codecvt *, char* __buf); -char const* _Locale_numeric_name(const struct _Locale_numeric *, char* __buf); -char const* _Locale_time_name(const struct _Locale_time *, char* __buf); -char const* _Locale_collate_name(const struct _Locale_collate *, char* __buf); -char const* _Locale_monetary_name(const struct _Locale_monetary *, char* __buf); -char const* _Locale_messages_name(const struct _Locale_messages *, char* __buf); - -/* - * cname is a (possibly composite) locale name---i.e. a name that can - * be passed to setlocale. __buf points to an array large enough to - * store at least _Locale_MAX_SIMPLE_NAME characters, and each of these - * functions extracts the name of a single category, stores it in buf - * as a null-terminated string, and returns buf. - */ -char const* _Locale_extract_ctype_name(const char *cname, char *__buf, - struct _Locale_name_hint* __hint, int *__err_code); -char const* _Locale_extract_numeric_name(const char *cname, char *__buf, - struct _Locale_name_hint* __hint, int *__err_code); -char const* _Locale_extract_time_name(const char *cname, char *__buf, - struct _Locale_name_hint* __hint, int *__err_code); -char const* _Locale_extract_collate_name(const char *cname, char *__buf, - struct _Locale_name_hint* __hint, int *__err_code); -char const* _Locale_extract_monetary_name(const char *cname, char *__buf, - struct _Locale_name_hint* __hint, int *__err_code); -char const* _Locale_extract_messages_name(const char *cname, char *__buf, - struct _Locale_name_hint* __hint, int *__err_code); - -/* Functions to improve locale creation process. For some locale API (Win32) - * you need to find a locale identification from the name which can be a - * rather expensive operation especially if you do so for all facets of a - * locale. Those functions can be used to extract from a API dependent facet - * struct the information necessary to skip this lookup process for other - * facets creation. If not supported those function should return NULL. - */ -struct _Locale_name_hint* _Locale_get_ctype_hint(struct _Locale_ctype*); -struct _Locale_name_hint* _Locale_get_numeric_hint(struct _Locale_numeric*); -struct _Locale_name_hint* _Locale_get_time_hint(struct _Locale_time*); -struct _Locale_name_hint* _Locale_get_collate_hint(struct _Locale_collate*); -struct _Locale_name_hint* _Locale_get_monetary_hint(struct _Locale_monetary*); -struct _Locale_name_hint* _Locale_get_messages_hint(struct _Locale_messages*); - -/* - * FUNCTIONS THAT USE CTYPE - */ - -/* - * Narrow character functions: - */ - -/* - * Returns a pointer to the beginning of the ctype table. The table is - * at least 257 bytes long; if p is the pointer returned by this - * function, then p[c] is valid if c is EOF or if p is any value of - * type unsigned char. - */ -const _Locale_mask_t * _Locale_ctype_table(struct _Locale_ctype *); - -/* - * c is either EOF, or an unsigned char value. - */ -int _Locale_toupper(struct _Locale_ctype *, int /* c */); -int _Locale_tolower(struct _Locale_ctype *, int /* c */); - - -#ifndef _STLP_NO_WCHAR_T -/* - * Wide character functions: - */ -_Locale_mask_t _WLocale_ctype(struct _Locale_ctype *, wint_t, _Locale_mask_t); -wint_t _WLocale_tolower(struct _Locale_ctype *, wint_t); -wint_t _WLocale_toupper(struct _Locale_ctype *, wint_t); - -/* - * Multibyte functions: - */ - -/* - * Returns the number of bytes of the longest allowed multibyte - * character in the current encoding. - */ -int _WLocale_mb_cur_max(struct _Locale_codecvt *); - -/* - * Returns the number of bytes of the shortest allowed multibyte - * character in the current encoding. - */ -int _WLocale_mb_cur_min(struct _Locale_codecvt *); - -/* - * Returns 1 if the current multibyte encoding is stateless - * and does not require the use of an mbstate_t value. - */ -int _WLocale_is_stateless(struct _Locale_codecvt *); - -/* - * Almost identical to mbrtowc, from 4.6.5.3.2 of NA1. The only - * important difference is that mbrtowc treats null wide characters - * as special, and we don't. Specifically: examines the characters - * in [from, from + n), extracts a single wide character, and stores - * it in *to. Modifies shift_state if appropriate. The return value, - * which is always positive, is the number of characters extracted from - * the input sequence. Return value is (size_t) -1 if there was an - * encoding error in the input sequence, and (size_t) -2 if - * [from, from + n) is correct but not complete. None of the pointer - * arguments may be null pointers. - */ -size_t _WLocale_mbtowc(struct _Locale_codecvt *, - wchar_t * /* to */, - const char * /* from */, size_t /* n */, - mbstate_t *); - -/* - * Again, very similar to wcrtomb. The differences are that (1) it - * doesn't treat null characters as special; and (2) it stores at most - * n characters. Converts c to a multibyte sequence, stores that - * sequence in the array 'to', and returns the length of the sequence. - * Modifies shift_state if appropriate. The return value is (size_t) -1 - * if c is not a valid wide character, and (size_t) -2 if the length of - * the multibyte character sequence is greater than n. - */ -size_t _WLocale_wctomb(struct _Locale_codecvt *, - char *, size_t, - const wchar_t, - mbstate_t *); - -/* - * Inserts whatever characters are necessary to restore st to an - * initial shift state. Sets *next to buf + m, where m is the number - * of characters inserted. (0 <= m <= n.) Returns m to indicate - * success, (size_t) -1 to indicate error, (size_t) -2 to indicate - * partial success (more than n characters needed). For success or partial - * success, sets *next to buf + m. - */ -size_t _WLocale_unshift(struct _Locale_codecvt *, - mbstate_t *, - char *, size_t, char **); -#endif - -/* - * FUNCTIONS THAT USE COLLATE - */ - -/* - * Compares the two sequences [s1, s1 + n1) and [s2, s2 + n2). Neither - * sequence is assumed to be null-terminated, and null characters - * aren't special. If the two sequences are the same up through - * min(n1, n2), then the sequence that compares less is whichever one - * is shorter. - */ -int _Locale_strcmp(struct _Locale_collate *, - const char * /* s1 */, size_t /* n1 */, - const char * /* s2 */, size_t /* n2 */); -#ifndef _STLP_NO_WCHAR_T -int _WLocale_strcmp(struct _Locale_collate *, - const wchar_t * /* s1 */, size_t /* n1 */, - const wchar_t * /* s2 */, size_t /* n2 */); -#endif - -/* - * Creates a transformed version of the string [s2, s2 + n2). The - * string may contain embedded null characters; nulls aren't special. - * The transformed string begins at s1, and contains at most n1 - * characters. The return value is the length of the transformed - * string. If the return value is greater than n1 then this is an - * error condition: it indicates that there wasn't enough space. In - * that case, the contents of [s1, s1 + n1) is unspecified. -*/ -size_t _Locale_strxfrm(struct _Locale_collate *, - char * /* s1 */, size_t /* n1 */, - const char * /* s2 */, size_t /* n2 */); - -#ifndef _STLP_NO_WCHAR_T -size_t _WLocale_strxfrm(struct _Locale_collate *, - wchar_t * /* s1 */, size_t /* n1 */, - const wchar_t * /* s2 */, size_t /* n2 */); -#endif - - -/* - * FUNCTIONS THAT USE NUMERIC - */ - -/* - * Equivalent to the first three fields in struct lconv. (C standard, - * section 7.4.) - */ -char _Locale_decimal_point(struct _Locale_numeric *); -char _Locale_thousands_sep(struct _Locale_numeric *); -const char * _Locale_grouping(struct _Locale_numeric *); - -#ifndef _STLP_NO_WCHAR_T -wchar_t _WLocale_decimal_point(struct _Locale_numeric *); -wchar_t _WLocale_thousands_sep(struct _Locale_numeric *); -#endif - -/* - * Return "true" and "false" in English locales, and something - * appropriate in non-English locales. - */ -const char * _Locale_true(struct _Locale_numeric *); -const char * _Locale_false(struct _Locale_numeric *); - -#ifndef _STLP_NO_WCHAR_T -const wchar_t * _WLocale_true(struct _Locale_numeric *, wchar_t* /* buf */, size_t /* bufSize */); -const wchar_t * _WLocale_false(struct _Locale_numeric *, wchar_t* /* buf */, size_t /* bufSize */); -#endif - -/* - * FUNCTIONS THAT USE MONETARY - */ - -/* - * Return the obvious fields of struct lconv. - */ -const char * _Locale_int_curr_symbol(struct _Locale_monetary *); -const char * _Locale_currency_symbol(struct _Locale_monetary *); -char _Locale_mon_decimal_point(struct _Locale_monetary *); -char _Locale_mon_thousands_sep(struct _Locale_monetary *); -const char * _Locale_mon_grouping(struct _Locale_monetary *); -const char * _Locale_positive_sign(struct _Locale_monetary *); -const char * _Locale_negative_sign(struct _Locale_monetary *); -char _Locale_int_frac_digits(struct _Locale_monetary *); -char _Locale_frac_digits(struct _Locale_monetary *); -int _Locale_p_cs_precedes(struct _Locale_monetary *); -int _Locale_p_sep_by_space(struct _Locale_monetary *); -int _Locale_p_sign_posn(struct _Locale_monetary *); -int _Locale_n_cs_precedes(struct _Locale_monetary *); -int _Locale_n_sep_by_space(struct _Locale_monetary *); -int _Locale_n_sign_posn(struct _Locale_monetary *); - -#ifndef _STLP_NO_WCHAR_T -const wchar_t * _WLocale_int_curr_symbol(struct _Locale_monetary *, wchar_t* /* buf */, size_t /* bufSize */); -const wchar_t * _WLocale_currency_symbol(struct _Locale_monetary *, wchar_t* /* buf */, size_t /* bufSize */); -wchar_t _WLocale_mon_decimal_point(struct _Locale_monetary *); -wchar_t _WLocale_mon_thousands_sep(struct _Locale_monetary *); -const wchar_t * _WLocale_positive_sign(struct _Locale_monetary *, wchar_t* /* buf */, size_t /* bufSize */); -const wchar_t * _WLocale_negative_sign(struct _Locale_monetary *, wchar_t* /* buf */, size_t /* bufSize */); -#endif - -/* - * FUNCTIONS THAT USE TIME - */ - -/* - * month is in the range [0, 12). - */ -const char * _Locale_full_monthname(struct _Locale_time *, int /* month */); -const char * _Locale_abbrev_monthname(struct _Locale_time *, int /* month */); - -#ifndef _STLP_NO_WCHAR_T -const wchar_t * _WLocale_full_monthname(struct _Locale_time *, int /* month */, - wchar_t* /* buf */, size_t /* bufSize */); -const wchar_t * _WLocale_abbrev_monthname(struct _Locale_time *, int /* month */, - wchar_t* /* buf */, size_t /* bufSize */); -#endif - -/* - * day is in the range [0, 7). Sunday is 0. - */ -const char * _Locale_full_dayofweek(struct _Locale_time *, int /* day */); -const char * _Locale_abbrev_dayofweek(struct _Locale_time *, int /* day */); - -#ifndef _STLP_NO_WCHAR_T -const wchar_t * _WLocale_full_dayofweek(struct _Locale_time *, int /* day */, - wchar_t* /* buf */, size_t /* bufSize */); -const wchar_t * _WLocale_abbrev_dayofweek(struct _Locale_time *, int /* day */, - wchar_t* /* buf */, size_t /* bufSize */); -#endif - -const char * _Locale_d_t_fmt(struct _Locale_time *); -const char * _Locale_d_fmt(struct _Locale_time *); -const char * _Locale_t_fmt(struct _Locale_time *); -const char * _Locale_long_d_t_fmt(struct _Locale_time*); -const char * _Locale_long_d_fmt(struct _Locale_time*); - -const char * _Locale_am_str(struct _Locale_time *); -const char * _Locale_pm_str(struct _Locale_time *); - -#ifndef _STLP_NO_WCHAR_T -const wchar_t * _WLocale_am_str(struct _Locale_time *, - wchar_t* /* buf */, size_t /* bufSize */); -const wchar_t * _WLocale_pm_str(struct _Locale_time *, - wchar_t* /* buf */, size_t /* bufSize */); -#endif - -/* - * FUNCTIONS THAT USE MESSAGES - */ - -/* - * Very similar to catopen, except that it uses the given message - * category to determine which catalog to open. - */ -nl_catd_type _Locale_catopen(struct _Locale_messages*, const char*); - -/* Complementary to _Locale_catopen. - * The catalog must be a value that was returned by a previous call - * to _Locale_catopen. - */ -void _Locale_catclose(struct _Locale_messages*, nl_catd_type); - -/* - * Returns a string, identified by a set index and a message index, - * from an opened message catalog. Returns the supplied default if - * no such string exists. - */ -const char * _Locale_catgets(struct _Locale_messages *, nl_catd_type, - int, int,const char *); - -#ifdef __cplusplus -} -#endif - -#endif /* _STLP_C_LOCALE_IMPL_H */ |