X-Git-Url: https://pd.if.org/git/?p=pdclib;a=blobdiff_plain;f=includes%2Flocale.h;h=da9138245082ee2995d9471690725893d2b59c9b;hp=f9dd659ed18d132bdd23d37028cbcdc69154060d;hb=761281caf431d264d568aec797095ef2c28f3910;hpb=1d9d92ba957a0b8307c9a65c35867fde68e6533b diff --git a/includes/locale.h b/includes/locale.h index f9dd659..da91382 100644 --- a/includes/locale.h +++ b/includes/locale.h @@ -1,93 +1,102 @@ -/* ---------------------------------------------------------------------------- - * $Id$ - * ---------------------------------------------------------------------------- - * Public Domain C Library - http://pdclib.sourceforge.net - * This code is Public Domain. Use, modify, and redistribute at will. - * ---------------------------------------------------------------------------- - * Localization - * --------------------------------------------------------------------------*/ +/* Localization -#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. +*/ -#ifndef _NULL -#include "__intern.h" -#endif /* _NULL */ +#ifndef _PDCLIB_LOCALE_H +#define _PDCLIB_LOCALE_H _PDCLIB_LOCALE_H -/* ---------------------------------------------------------------------------- - * DEFINES - * --------------------------------------------------------------------------*/ +#include "_PDCLIB_int.h" -#define NULL _NULL +#ifndef _PDCLIB_NULL_DEFINED +#define _PDCLIB_NULL_DEFINED _PDCLIB_NULL_DEFINED +#define NULL _PDCLIB_NULL +#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 */ +/* The structure returned by localeconv(). -/* ---------------------------------------------------------------------------- - * TYPEDEFS - * --------------------------------------------------------------------------*/ - -/* 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 */ + struct _PDCLIB_ctype_t * ctype; /* internal information */ + char * _PDCLIB_errno_texts[_PDCLIB_ERRNO_MAX]; /* strerror() / perror() */ + char * _PDCLIB_month_name_abbr[12]; /* month names, abbreviated */ + char * _PDCLIB_month_name_full[12]; /* month names, full */ + char * _PDCLIB_day_name_abbr[7]; /* weekday names, abbreviated */ + char * _PDCLIB_day_name_full[7]; /* weekday names, full */ + 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 */ +}; - /* 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? */ +/* This is strictly internal, and visible here for technical reasons only. */ +extern struct lconv _PDCLIB_lconv; - /* 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? */ -}; +/* 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 () */ +#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 -/* ---------------------------------------------------------------------------- - * FUNCTIONS - * --------------------------------------------------------------------------*/ +/* 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 ); -/** 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. - */ +/* Returns a struct lconv initialized to the values appropriate for the current + locale setting. +*/ struct lconv * localeconv( void ); -/** 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 ); - -#endif /* _LOCALE_H */ +#endif