mirror of
https://sourceware.org/git/glibc.git
synced 2024-11-09 23:00:07 +00:00
f0be25b633
xlocale.h is already a single-type micro-header, defining struct
__locale_struct and the typedefs __locale_t and locale_t. This patch
brings it into the bits/types/ scheme: there are now
bits/types/__locale_t.h which defines only __locale_struct and
__locale_t, and bits/types/locale_t.h which defines locale_t as well
as the other two. None of *our* headers need __locale_t.h, but it
appears to me that libstdc++ could make use of it.
There are a lot of external uses of xlocale.h, but all the uses I
checked had an autoconf test or equivalent for its existence. It has
never been available from other C libraries, and it has always
contained a comment reading "This file is not standardized, don't rely
on it, it can go away without warning" so I think dropping it is
pretty safe.
I also took the opportunity to clean up comments in various public
header files that still talk about the *_l interfaces as though they
were completely nonstandard. There are a few of them, notably the
strtoX_l and wcstoX_l families, that haven't been standardized, but
the bulk are in POSIX.1-2008.
* locale/xlocale.h: Rename to...
* locale/bits/types/__locale_t.h: ...here. Adjust commentary.
Only define struct __locale_struct and __locale_t, not locale_t.
* locale/bits/types/locale_t.h: New file; define locale_t here.
* locale/Makefile (headers): Update to match.
* include/xlocale.h: Delete wrapper.
* include/bits/types/__locale_t.h: New wrapper.
* include/bits/types/locale_t.h: New wrapper.
* ctype/ctype.h, include/printf.h, include/time.h
* locale/langinfo.h, locale/locale.h, stdlib/monetary.h
* stdlib/stdlib.h, string/string.h, string/strings.h, time/time.h
* wcsmbs/wchar.h, wctype/wctype.h: Use bits/types/locale_t.h.
Correct outdated comments regarding the standardization status of
the functions that take locale_t arguments.
* stdlib/strtod_l.c, stdlib/strtof_l.c, stdlib/strtol_l.c
* stdlib/strtold_l.c, stdlib/strtoul_l.c, stdlib/strtoull_l.c
* sysdeps/ieee754/ldbl-128ibm/strtold_l.c
* sysdeps/ieee754/ldbl-64-128/strtold_l.c
* wcsmbs/wcstod.c, wcsmbs/wcstod_l.c, wcsmbs/wcstof.c
* wcsmbs/wcstof_l.c, wcsmbs/wcstold.c, wcsmbs/wcstold_l.c:
Don't include xlocale.h. If necessary, include locale.h instead.
* stdlib/strtold_l.c: Unconditionally include wchar.h.
198 lines
7.5 KiB
C
198 lines
7.5 KiB
C
/* Copyright (C) 1991-2017 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, see
|
|
<http://www.gnu.org/licenses/>. */
|
|
|
|
/*
|
|
* 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_XOPEN2K8
|
|
/* POSIX.1-2008 extends the locale interface with functions for
|
|
explicit creation and manipulation of 'locale_t' objects
|
|
representing locale contexts, and a set of parallel
|
|
locale-sensitive text processing functions that take a locale_t
|
|
argument. This enables applications to work with data from
|
|
multiple locales simultaneously and thread-safely. */
|
|
# include <bits/types/locale_t.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,
|
|
made by OR'ing together LC_*_MASK bits above. */
|
|
extern __locale_t newlocale (int __category_mask, const char *__locale,
|
|
__locale_t __base) __THROW;
|
|
|
|
/* These are the bits that can be set in the CATEGORY_MASK argument to
|
|
`newlocale'. In the GNU implementation, LC_FOO_MASK has the value
|
|
of (1 << LC_FOO), but this is not a part of the interface that
|
|
callers can assume will be true. */
|
|
# define LC_CTYPE_MASK (1 << __LC_CTYPE)
|
|
# define LC_NUMERIC_MASK (1 << __LC_NUMERIC)
|
|
# define LC_TIME_MASK (1 << __LC_TIME)
|
|
# define LC_COLLATE_MASK (1 << __LC_COLLATE)
|
|
# define LC_MONETARY_MASK (1 << __LC_MONETARY)
|
|
# define LC_MESSAGES_MASK (1 << __LC_MESSAGES)
|
|
# define LC_PAPER_MASK (1 << __LC_PAPER)
|
|
# define LC_NAME_MASK (1 << __LC_NAME)
|
|
# define LC_ADDRESS_MASK (1 << __LC_ADDRESS)
|
|
# define LC_TELEPHONE_MASK (1 << __LC_TELEPHONE)
|
|
# define LC_MEASUREMENT_MASK (1 << __LC_MEASUREMENT)
|
|
# define LC_IDENTIFICATION_MASK (1 << __LC_IDENTIFICATION)
|
|
# define LC_ALL_MASK (LC_CTYPE_MASK \
|
|
| LC_NUMERIC_MASK \
|
|
| LC_TIME_MASK \
|
|
| LC_COLLATE_MASK \
|
|
| LC_MONETARY_MASK \
|
|
| LC_MESSAGES_MASK \
|
|
| LC_PAPER_MASK \
|
|
| LC_NAME_MASK \
|
|
| LC_ADDRESS_MASK \
|
|
| LC_TELEPHONE_MASK \
|
|
| LC_MEASUREMENT_MASK \
|
|
| LC_IDENTIFICATION_MASK \
|
|
)
|
|
|
|
/* 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;
|
|
|
|
/* Switch the current thread's locale to DATASET.
|
|
If DATASET is null, instead just return the current setting.
|
|
The special value LC_GLOBAL_LOCALE is the initial setting
|
|
for all threads and can also be installed any time, meaning
|
|
the thread uses the global settings controlled by `setlocale'. */
|
|
extern __locale_t uselocale (__locale_t __dataset) __THROW;
|
|
|
|
/* This value can be passed to `uselocale' and may be returned by it.
|
|
Passing this value to any other function has undefined behavior. */
|
|
# define LC_GLOBAL_LOCALE ((__locale_t) -1L)
|
|
|
|
#endif
|
|
|
|
__END_DECLS
|
|
|
|
#endif /* locale.h */
|