/home/ntakagi/work/STLport-5.1.5/src/c_locale.h Go to the documentation of this file. /* * 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 <stl/c_locale.h> #ifdef _STLP_REAL_LOCALE_IMPLEMENTED # if defined (_STLP_USE_GLIBC) && !defined (__CYGWIN__) # include <nl_types.h> # endif #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 /* * Maximum length of a composite locale. */ #define _Locale_MAX_COMPOSITE_NAME 6*(_Locale_MAX_SIMPLE_NAME+3) #ifdef __cplusplus extern "C" { #endif /* * Typedefs: */ #if (defined (__GNUC__) && !defined (__MINGW32__)) || defined (_KCC) || defined (__ICC) typedef unsigned short int _Locale_mask_t; #else typedef unsigned int _Locale_mask_t; #endif /* Function called during STLport library load phase. Might contain any * code necessary to the platform localization layer. */ void _Locale_init(); /* Function called during STLport library unload. Might contain any * code necessary to the platform localization layer. */ void _Locale_final(); /* 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. * * Note These functions return a void* instead of the appropriate * _Locale_* struct because they are used with __acquire_category which * requires that all functions have the same signature. */ void * _Locale_ctype_create(const char *, struct _Locale_name_hint*); void * _Locale_numeric_create(const char *, struct _Locale_name_hint*); void * _Locale_time_create(const char *, struct _Locale_name_hint*); void * _Locale_collate_create(const char *, struct _Locale_name_hint*); void * _Locale_monetary_create(const char *, struct _Locale_name_hint*); void * _Locale_messages_create(const char *, struct _Locale_name_hint*); /* Release a category of a locale * * These functions are used to release a category acquired with the * according _Locale_*_create() functions. * * Note: For the same reasons as for the *_create functions, these * take void* instead of the correct types so that they can be used * with __release_category. */ void _Locale_ctype_destroy(void *); void _Locale_numeric_destroy(void *); void _Locale_time_destroy(void *); void _Locale_collate_destroy(void *); void _Locale_monetary_destroy(void *); void _Locale_messages_destroy(void *); /* * 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. * TODO: can this fail? How is that signalled then? */ char const* _Locale_ctype_name(const void *, char* __buf); char const* _Locale_numeric_name(const void *, char* __buf); char const* _Locale_time_name(const void *, char* __buf); char const* _Locale_collate_name(const void *, char* __buf); char const* _Locale_monetary_name(const void *, char* __buf); char const* _Locale_messages_name(const void *, 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); char const* _Locale_extract_numeric_name(const char *cname, char *__buf, struct _Locale_name_hint* __hint); char const* _Locale_extract_time_name(const char *cname, char *__buf, struct _Locale_name_hint* __hint); char const* _Locale_extract_collate_name(const char *cname, char *__buf, struct _Locale_name_hint* __hint); char const* _Locale_extract_monetary_name(const char *cname, char *__buf, struct _Locale_name_hint* __hint); char const* _Locale_extract_messages_name(const char *cname, char *__buf, struct _Locale_name_hint* __hint); /* * The inputs to this function are six null-terminated strings: the * names of a locale's six categories. Locale names for non-standard * categories are taken from __DefaultName. * __buf is a pointer to an array large enough to store at least * _Locale_MAX_COMPOSITE_NAME characters. * This function constructs a (possibly composite) name describing the * locale as a whole, stores that name in buf as a null-terminated * string, and returns buf. */ char const* _Locale_compose_name(char *__buf, const char *__Ctype, const char *__Numeric, const char *__Time, const char *__Collate, const char *__Monetary, const char *__Messages, const char *__DefaultName); /* Funstions 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); int _Locale_tolower(struct _Locale_ctype *, int); # ifndef _STLP_NO_WCHAR_T /* * Wide character functions: */ _Locale_mask_t _Locale_wchar_ctype(struct _Locale_ctype *, wint_t, _Locale_mask_t); wint_t _Locale_wchar_tolower(struct _Locale_ctype *, wint_t); wint_t _Locale_wchar_toupper(struct _Locale_ctype *, wint_t); # endif # if !defined ( _STLP_NO_MBSTATE_T ) /* * Multibyte functions: */ int _Locale_mb_cur_max (struct _Locale_ctype *); /* * Returns the number of bytes of the longest allowed multibyte * character in the current encoding. */ int _Locale_mb_cur_min (struct _Locale_ctype *); /* * Returns the number of bytes of the shortest allowed multibyte * character in the current encoding. */ int _Locale_is_stateless (struct _Locale_ctype *); /* * Returns 1 if the current multibyte encoding is stateless * and does not require the use of an mbstate_t value. */ # ifndef _STLP_NO_WCHAR_T wint_t _Locale_btowc(struct _Locale_ctype *, int); int _Locale_wctob(struct _Locale_ctype *, wint_t); /* * Just like btowc and wctob, from 4.6.5.1 of the C standard, Normative * Addendum 1. (And just like widen/narrow, from clause 22 of the C++ * standard.) */ size_t _Locale_mbtowc(struct _Locale_ctype *, wchar_t *, const char *, size_t, mbstate_t *); /* * 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 _Locale_wctomb(struct _Locale_ctype *, char *, size_t, const wchar_t, 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. */ # endif size_t _Locale_unshift(struct _Locale_ctype *, mbstate_t *, char *, size_t, char **); /* * 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. */ # endif /* _STLP_NO_MBSTATE_T */ /* * FUNCTIONS THAT USE COLLATE */ int _Locale_strcmp(struct _Locale_collate *, const char *, size_t, const char *, size_t); # ifndef _STLP_NO_WCHAR_T int _Locale_strwcmp(struct _Locale_collate *, const wchar_t *, size_t, const wchar_t *, size_t); # endif /* * 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. */ size_t _Locale_strxfrm(struct _Locale_collate *, char *, size_t, const char *, size_t); # ifndef _STLP_NO_WCHAR_T size_t _Locale_strwxfrm(struct _Locale_collate *, wchar_t *, size_t, const wchar_t *, size_t); # 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. */ /* * 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 *); /* * 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 *); /* * 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 *); /* * FUNCTIONS THAT USE TIME */ /* * month is in the range [0, 12). */ const char * _Locale_full_monthname(struct _Locale_time *, int); const char * _Locale_abbrev_monthname(struct _Locale_time *, int); /* * day is in the range [0, 7). Sunday is 0. */ const char * _Locale_full_dayofweek(struct _Locale_time *, int); const char * _Locale_abbrev_dayofweek(struct _Locale_time *, int); 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 *); const char * _Locale_t_fmt_ampm(struct _Locale_time *); /* * FUNCTIONS THAT USE MESSAGES */ # ifdef _STLP_REAL_LOCALE_IMPLEMENTED # if defined (WIN32) || defined (_WIN32) typedef int nl_catd_type; # elif defined (_STLP_USE_GLIBC) && !defined (__CYGWIN__) typedef nl_catd nl_catd_type; # else typedef int nl_catd_type; # endif # else typedef int nl_catd_type; # endif /* _STLP_REAL_LOCALE_IMPLEMENTED */ /* * 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 */

• ソフトウェア開発
• ホームページ制作
• Doxygen Source Document
• Tcl Source Document