[thirdparty/glibc.git] / locale / locale.h

/* Copyright (C) 1991,92,1995-1999,2000,2001 Free Software Foundation, Inc.
   This file is part of the GNU C Library.

   The GNU C Library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public
   License as published by the Free Software Foundation; either
   version 2.1 of the License, or (at your option) any later version.

   The GNU C Library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Lesser General Public License for more details.

   You should have received a copy of the GNU Lesser General Public
   License along with the GNU C Library; if not, write to the Free
   Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
   02111-1307 USA.  */

/*
 *	ISO C99 Standard: 7.11 Localization	<locale.h>
 */

#ifndef	_LOCALE_H
#define	_LOCALE_H	1

#include <features.h>

#define __need_NULL
#include <stddef.h>
#include <bits/locale.h>

__BEGIN_DECLS

/* These are the possibilities for the first argument to setlocale.
   The code assumes that the lowest LC_* symbol has the value zero.  */
#define LC_CTYPE          __LC_CTYPE
#define LC_NUMERIC        __LC_NUMERIC
#define LC_TIME           __LC_TIME
#define LC_COLLATE        __LC_COLLATE
#define LC_MONETARY       __LC_MONETARY
#define LC_MESSAGES       __LC_MESSAGES
#define	LC_ALL		  __LC_ALL
#define LC_PAPER	  __LC_PAPER
#define LC_NAME		  __LC_NAME
#define LC_ADDRESS	  __LC_ADDRESS
#define LC_TELEPHONE	  __LC_TELEPHONE
#define LC_MEASUREMENT	  __LC_MEASUREMENT
#define LC_IDENTIFICATION __LC_IDENTIFICATION


/* Structure giving information about numeric and monetary notation.  */
struct lconv
{
  /* Numeric (non-monetary) information.  */

  char *decimal_point;		/* Decimal point character.  */
  char *thousands_sep;		/* Thousands separator.  */
  /* Each element is the number of digits in each group;
     elements with higher indices are farther left.
     An element with value CHAR_MAX means that no further grouping is done.
     An element with value 0 means that the previous element is used
     for all groups farther left.  */
  char *grouping;

  /* Monetary information.  */

  /* First three chars are a currency symbol from ISO 4217.
     Fourth char is the separator.  Fifth char is '\0'.  */
  char *int_curr_symbol;
  char *currency_symbol;	/* Local currency symbol.  */
  char *mon_decimal_point;	/* Decimal point character.  */
  char *mon_thousands_sep;	/* Thousands separator.  */
  char *mon_grouping;		/* Like `grouping' element (above).  */
  char *positive_sign;		/* Sign for positive values.  */
  char *negative_sign;		/* Sign for negative values.  */
  char int_frac_digits;		/* Int'l fractional digits.  */
  char frac_digits;		/* Local fractional digits.  */
  /* 1 if currency_symbol precedes a positive value, 0 if succeeds.  */
  char p_cs_precedes;
  /* 1 iff a space separates currency_symbol from a positive value.  */
  char p_sep_by_space;
  /* 1 if currency_symbol precedes a negative value, 0 if succeeds.  */
  char n_cs_precedes;
  /* 1 iff a space separates currency_symbol from a negative value.  */
  char n_sep_by_space;
  /* Positive and negative sign positions:
     0 Parentheses surround the quantity and currency_symbol.
     1 The sign string precedes the quantity and currency_symbol.
     2 The sign string follows the quantity and currency_symbol.
     3 The sign string immediately precedes the currency_symbol.
     4 The sign string immediately follows the currency_symbol.  */
  char p_sign_posn;
  char n_sign_posn;
#ifdef __USE_ISOC99
  /* 1 if int_curr_symbol precedes a positive value, 0 if succeeds.  */
  char int_p_cs_precedes;
  /* 1 iff a space separates int_curr_symbol from a positive value.  */
  char int_p_sep_by_space;
  /* 1 if int_curr_symbol precedes a negative value, 0 if succeeds.  */
  char int_n_cs_precedes;
  /* 1 iff a space separates int_curr_symbol from a negative value.  */
  char int_n_sep_by_space;
  /* Positive and negative sign positions:
     0 Parentheses surround the quantity and int_curr_symbol.
     1 The sign string precedes the quantity and int_curr_symbol.
     2 The sign string follows the quantity and int_curr_symbol.
     3 The sign string immediately precedes the int_curr_symbol.
     4 The sign string immediately follows the int_curr_symbol.  */
  char int_p_sign_posn;
  char int_n_sign_posn;
#else
  char __int_p_cs_precedes;
  char __int_p_sep_by_space;
  char __int_n_cs_precedes;
  char __int_n_sep_by_space;
  char __int_p_sign_posn;
  char __int_n_sign_posn;
#endif
};


/* Set and/or return the current locale.  */
extern char *setlocale (int __category, __const char *__locale) __THROW;

/* Return the numeric/monetary information for the current locale.  */
extern struct lconv *localeconv (void) __THROW;

#ifdef	__USE_GNU
/* The concept of one static locale per category is not very well
   thought out.  Many applications will need to process its data using
   information from several different locales.  Another application is
   the implementation of the internationalization handling in the
   upcoming ISO C++ standard library.  To support this another set of
   the functions using locale data exist which have an additional
   argument.

   Attention: all these functions are *not* standardized in any form.
   This is a proof-of-concept implementation.  */

/* Get locale datatype definition.  */
# include <xlocale.h>

/* Return a reference to a data structure representing a set of locale
   datasets.  Unlike for the CATEGORY parameter for `setlocale' the
   CATEGORY_MASK parameter here uses a single bit for each category.
   I.e., 1 << LC_CTYPE means to load data for this category.  If
   BASE is non-null the appropriate category information in the BASE
   record is replaced.  */
extern __locale_t __newlocale (int __category_mask, __const char *__locale,
			       __locale_t __base) __THROW;

/* Return a duplicate of the set of locale in DATASET.  All usage
   counters are increased if necessary.  */
extern __locale_t __duplocale (__locale_t __dataset) __THROW;

/* Free the data associated with a locale dataset previously returned
   by a call to `setlocale_r'.  */
extern void __freelocale (__locale_t __dataset) __THROW;
#endif

__END_DECLS

#endif /* locale.h  */
Commit	Line	Data
3e154a6f	1	/* Copyright (C) 1991,92,1995-1999,2000,2001 Free Software Foundation, Inc.
6d52618b	2	This file is part of the GNU C Library.
28f540f4	3
6d52618b	4	The GNU C Library is free software; you can redistribute it and/or
41bdb6e2 AJ	5	modify it under the terms of the GNU Lesser General Public
	6	License as published by the Free Software Foundation; either
	7	version 2.1 of the License, or (at your option) any later version.
28f540f4	8
6d52618b UD	9	The GNU C Library is distributed in the hope that it will be useful,
	10	but WITHOUT ANY WARRANTY; without even the implied warranty of
	11	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
41bdb6e2	12	Lesser General Public License for more details.
28f540f4	13
41bdb6e2 AJ	14	You should have received a copy of the GNU Lesser General Public
	15	License along with the GNU C Library; if not, write to the Free
	16	Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
	17	02111-1307 USA. */
28f540f4 RM	18
28f540f4 RM	19	/*
d1646309	20	* ISO C99 Standard: 7.11 Localization <locale.h>
28f540f4 RM	21	*/
	22
	23	#ifndef _LOCALE_H
28f540f4	24	#define _LOCALE_H 1
5107cf1d	25
28f540f4 RM	26	#include <features.h>
28f540f4 RM	27
6d52618b UD	28	#define __need_NULL
6d52618b UD	29	#include <stddef.h>
3e154a6f	30	#include <bits/locale.h>
6d52618b	31
28f540f4 RM	32	__BEGIN_DECLS
	33
	34	/* These are the possibilities for the first argument to setlocale.
643e9936	35	The code assumes that the lowest LC_* symbol has the value zero. */
3e154a6f UD	36	#define LC_CTYPE __LC_CTYPE
	37	#define LC_NUMERIC __LC_NUMERIC
	38	#define LC_TIME __LC_TIME
	39	#define LC_COLLATE __LC_COLLATE
	40	#define LC_MONETARY __LC_MONETARY
	41	#define LC_MESSAGES __LC_MESSAGES
	42	#define LC_ALL __LC_ALL
	43	#define LC_PAPER __LC_PAPER
	44	#define LC_NAME __LC_NAME
	45	#define LC_ADDRESS __LC_ADDRESS
	46	#define LC_TELEPHONE __LC_TELEPHONE
	47	#define LC_MEASUREMENT __LC_MEASUREMENT
	48	#define LC_IDENTIFICATION __LC_IDENTIFICATION
28f540f4 RM	49
	50
	51	/* Structure giving information about numeric and monetary notation. */
	52	struct lconv
	53	{
	54	/* Numeric (non-monetary) information. */
	55
	56	char decimal_point; / Decimal point character. */
	57	char thousands_sep; / Thousands separator. */
	58	/* Each element is the number of digits in each group;
	59	elements with higher indices are farther left.
	60	An element with value CHAR_MAX means that no further grouping is done.
	61	An element with value 0 means that the previous element is used
	62	for all groups farther left. */
	63	char *grouping;
	64
	65	/* Monetary information. */
	66
	67	/* First three chars are a currency symbol from ISO 4217.
	68	Fourth char is the separator. Fifth char is '\0'. */
	69	char *int_curr_symbol;
	70	char currency_symbol; / Local currency symbol. */
	71	char mon_decimal_point; / Decimal point character. */
	72	char mon_thousands_sep; / Thousands separator. */
	73	char mon_grouping; / Like `grouping' element (above). */
	74	char positive_sign; / Sign for positive values. */
	75	char negative_sign; / Sign for negative values. */
	76	char int_frac_digits; /* Int'l fractional digits. */
	77	char frac_digits; /* Local fractional digits. */
	78	/* 1 if currency_symbol precedes a positive value, 0 if succeeds. */
	79	char p_cs_precedes;
	80	/* 1 iff a space separates currency_symbol from a positive value. */
	81	char p_sep_by_space;
	82	/* 1 if currency_symbol precedes a negative value, 0 if succeeds. */
	83	char n_cs_precedes;
	84	/* 1 iff a space separates currency_symbol from a negative value. */
	85	char n_sep_by_space;
	86	/* Positive and negative sign positions:
	87	0 Parentheses surround the quantity and currency_symbol.
	88	1 The sign string precedes the quantity and currency_symbol.
6d52618b	89	2 The sign string follows the quantity and currency_symbol.
28f540f4	90	3 The sign string immediately precedes the currency_symbol.
6d52618b	91	4 The sign string immediately follows the currency_symbol. */
28f540f4 RM	92	char p_sign_posn;
28f540f4 RM	93	char n_sign_posn;
417bafec	94	#ifdef __USE_ISOC99
3b434940 UD	95	/* 1 if int_curr_symbol precedes a positive value, 0 if succeeds. */
	96	char int_p_cs_precedes;
	97	/* 1 iff a space separates int_curr_symbol from a positive value. */
	98	char int_p_sep_by_space;
	99	/* 1 if int_curr_symbol precedes a negative value, 0 if succeeds. */
	100	char int_n_cs_precedes;
	101	/* 1 iff a space separates int_curr_symbol from a negative value. */
	102	char int_n_sep_by_space;
	103	/* Positive and negative sign positions:
	104	0 Parentheses surround the quantity and int_curr_symbol.
	105	1 The sign string precedes the quantity and int_curr_symbol.
	106	2 The sign string follows the quantity and int_curr_symbol.
	107	3 The sign string immediately precedes the int_curr_symbol.
	108	4 The sign string immediately follows the int_curr_symbol. */
	109	char int_p_sign_posn;
	110	char int_n_sign_posn;
417bafec UD	111	#else
	112	char __int_p_cs_precedes;
	113	char __int_p_sep_by_space;
	114	char __int_n_cs_precedes;
	115	char __int_n_sep_by_space;
	116	char __int_p_sign_posn;
	117	char __int_n_sign_posn;
	118	#endif
28f540f4 RM	119	};
	120
	121
	122	/* Set and/or return the current locale. */
c1422e5b	123	extern char setlocale (int __category, __const char __locale) __THROW;
28f540f4 RM	124
28f540f4 RM	125	/* Return the numeric/monetary information for the current locale. */
c1422e5b	126	extern struct lconv *localeconv (void) __THROW;
28f540f4	127
6d52618b UD	128	#ifdef __USE_GNU
	129	/* The concept of one static locale per category is not very well
	130	thought out. Many applications will need to process its data using
	131	information from several different locales. Another application is
	132	the implementation of the internationalization handling in the
	133	upcoming ISO C++ standard library. To support this another set of
	134	the functions using locale data exist which have an additional
	135	argument.
	136
	137	Attention: all these functions are not standardized in any form.
	138	This is a proof-of-concept implementation. */
	139
c84142e8 UD	140	/* Get locale datatype definition. */
c84142e8 UD	141	# include <xlocale.h>
6d52618b UD	142
	143	/* Return a reference to a data structure representing a set of locale
	144	datasets. Unlike for the CATEGORY parameter for `setlocale' the
	145	CATEGORY_MASK parameter here uses a single bit for each category.
	146	I.e., 1 << LC_CTYPE means to load data for this category. If
	147	BASE is non-null the appropriate category information in the BASE
	148	record is replaced. */
c1422e5b UD	149	extern __locale_t __newlocale (int __category_mask, __const char *__locale,
c1422e5b UD	150	__locale_t __base) __THROW;
c84142e8 UD	151
	152	/* Return a duplicate of the set of locale in DATASET. All usage
	153	counters are increased if necessary. */
c1422e5b	154	extern __locale_t __duplocale (__locale_t __dataset) __THROW;
6d52618b UD	155
	156	/* Free the data associated with a locale dataset previously returned
	157	by a call to `setlocale_r'. */
c1422e5b	158	extern void __freelocale (__locale_t __dataset) __THROW;
6d52618b UD	159	#endif
6d52618b UD	160
28f540f4 RM	161	__END_DECLS
	162
	163	#endif /* locale.h */