mirror of
https://sourceware.org/git/glibc.git
synced 2024-12-27 05:00:15 +00:00
e2239af353
Improve the commentary to aid future developers who will stumble upon this novel, yet not always perfect, mechanism to support alternative formats for long double. Likewise, rename __LONG_DOUBLE_USES_FLOAT128 to __LDOUBLE_REDIRECTS_TO_FLOAT128_ABI now that development work has settled down. The command used was git grep -l __LONG_DOUBLE_USES_FLOAT128 ':!./ChangeLog*' | \ xargs sed -i 's/__LONG_DOUBLE_USES_FLOAT128/__LDOUBLE_REDIRECTS_TO_FLOAT128_ABI/g' Reviewed-by: Tulio Magno Quites Machado Filho <tuliom@linux.ibm.com>
863 lines
31 KiB
C
863 lines
31 KiB
C
/* Copyright (C) 1995-2020 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
|
|
<https://www.gnu.org/licenses/>. */
|
|
|
|
/*
|
|
* ISO C99 Standard: 7.24
|
|
* Extended multibyte and wide character utilities <wchar.h>
|
|
*/
|
|
|
|
#ifndef _WCHAR_H
|
|
#define _WCHAR_H 1
|
|
|
|
#define __GLIBC_INTERNAL_STARTING_HEADER_IMPLEMENTATION
|
|
#include <bits/libc-header-start.h>
|
|
|
|
/* Gather machine dependent type support. */
|
|
#include <bits/floatn.h>
|
|
|
|
#define __need_size_t
|
|
#define __need_wchar_t
|
|
#define __need_NULL
|
|
#include <stddef.h>
|
|
|
|
#define __need___va_list
|
|
#include <stdarg.h>
|
|
|
|
#include <bits/wchar.h>
|
|
#include <bits/types/wint_t.h>
|
|
#include <bits/types/mbstate_t.h>
|
|
#include <bits/types/__FILE.h>
|
|
|
|
#if defined __USE_UNIX98 || defined __USE_XOPEN2K
|
|
# include <bits/types/FILE.h>
|
|
#endif
|
|
#ifdef __USE_XOPEN2K8
|
|
# include <bits/types/locale_t.h>
|
|
#endif
|
|
|
|
/* Tell the caller that we provide correct C++ prototypes. */
|
|
#if defined __cplusplus && __GNUC_PREREQ (4, 4)
|
|
# define __CORRECT_ISO_CPP_WCHAR_H_PROTO
|
|
#endif
|
|
|
|
#ifndef WCHAR_MIN
|
|
/* These constants might also be defined in <inttypes.h>. */
|
|
# define WCHAR_MIN __WCHAR_MIN
|
|
# define WCHAR_MAX __WCHAR_MAX
|
|
#endif
|
|
|
|
#ifndef WEOF
|
|
# define WEOF (0xffffffffu)
|
|
#endif
|
|
|
|
/* All versions of XPG prior to the publication of ISO C99 required
|
|
the bulk of <wctype.h>'s declarations to appear in this header
|
|
(because <wctype.h> did not exist prior to C99). In POSIX.1-2001
|
|
those declarations were marked as XSI extensions; in -2008 they
|
|
were additionally marked as obsolescent. _GNU_SOURCE mode
|
|
anticipates the removal of these declarations in the next revision
|
|
of POSIX. */
|
|
#if (defined __USE_XOPEN && !defined __USE_GNU \
|
|
&& !(defined __USE_XOPEN2K && !defined __USE_XOPEN2KXSI))
|
|
# include <bits/wctype-wchar.h>
|
|
#endif
|
|
|
|
__BEGIN_DECLS
|
|
|
|
/* This incomplete type is defined in <time.h> but needed here because
|
|
of `wcsftime'. */
|
|
struct tm;
|
|
|
|
|
|
/* Copy SRC to DEST. */
|
|
extern wchar_t *wcscpy (wchar_t *__restrict __dest,
|
|
const wchar_t *__restrict __src)
|
|
__THROW __nonnull ((1, 2));
|
|
|
|
/* Copy no more than N wide-characters of SRC to DEST. */
|
|
extern wchar_t *wcsncpy (wchar_t *__restrict __dest,
|
|
const wchar_t *__restrict __src, size_t __n)
|
|
__THROW __nonnull ((1, 2));
|
|
|
|
/* Append SRC onto DEST. */
|
|
extern wchar_t *wcscat (wchar_t *__restrict __dest,
|
|
const wchar_t *__restrict __src)
|
|
__THROW __nonnull ((1, 2));
|
|
/* Append no more than N wide-characters of SRC onto DEST. */
|
|
extern wchar_t *wcsncat (wchar_t *__restrict __dest,
|
|
const wchar_t *__restrict __src, size_t __n)
|
|
__THROW __nonnull ((1, 2));
|
|
|
|
/* Compare S1 and S2. */
|
|
extern int wcscmp (const wchar_t *__s1, const wchar_t *__s2)
|
|
__THROW __attribute_pure__ __nonnull ((1, 2));
|
|
/* Compare N wide-characters of S1 and S2. */
|
|
extern int wcsncmp (const wchar_t *__s1, const wchar_t *__s2, size_t __n)
|
|
__THROW __attribute_pure__ __nonnull ((1, 2));
|
|
|
|
#ifdef __USE_XOPEN2K8
|
|
/* Compare S1 and S2, ignoring case. */
|
|
extern int wcscasecmp (const wchar_t *__s1, const wchar_t *__s2) __THROW;
|
|
|
|
/* Compare no more than N chars of S1 and S2, ignoring case. */
|
|
extern int wcsncasecmp (const wchar_t *__s1, const wchar_t *__s2,
|
|
size_t __n) __THROW;
|
|
|
|
/* Similar to the two functions above but take the information from
|
|
the provided locale and not the global locale. */
|
|
extern int wcscasecmp_l (const wchar_t *__s1, const wchar_t *__s2,
|
|
locale_t __loc) __THROW;
|
|
|
|
extern int wcsncasecmp_l (const wchar_t *__s1, const wchar_t *__s2,
|
|
size_t __n, locale_t __loc) __THROW;
|
|
#endif
|
|
|
|
/* Compare S1 and S2, both interpreted as appropriate to the
|
|
LC_COLLATE category of the current locale. */
|
|
extern int wcscoll (const wchar_t *__s1, const wchar_t *__s2) __THROW;
|
|
/* Transform S2 into array pointed to by S1 such that if wcscmp is
|
|
applied to two transformed strings the result is the as applying
|
|
`wcscoll' to the original strings. */
|
|
extern size_t wcsxfrm (wchar_t *__restrict __s1,
|
|
const wchar_t *__restrict __s2, size_t __n) __THROW;
|
|
|
|
#ifdef __USE_XOPEN2K8
|
|
/* Similar to the two functions above but take the information from
|
|
the provided locale and not the global locale. */
|
|
|
|
/* Compare S1 and S2, both interpreted as appropriate to the
|
|
LC_COLLATE category of the given locale. */
|
|
extern int wcscoll_l (const wchar_t *__s1, const wchar_t *__s2,
|
|
locale_t __loc) __THROW;
|
|
|
|
/* Transform S2 into array pointed to by S1 such that if wcscmp is
|
|
applied to two transformed strings the result is the as applying
|
|
`wcscoll' to the original strings. */
|
|
extern size_t wcsxfrm_l (wchar_t *__s1, const wchar_t *__s2,
|
|
size_t __n, locale_t __loc) __THROW;
|
|
|
|
/* Duplicate S, returning an identical malloc'd string. */
|
|
extern wchar_t *wcsdup (const wchar_t *__s) __THROW __attribute_malloc__;
|
|
#endif
|
|
|
|
/* Find the first occurrence of WC in WCS. */
|
|
#ifdef __CORRECT_ISO_CPP_WCHAR_H_PROTO
|
|
extern "C++" wchar_t *wcschr (wchar_t *__wcs, wchar_t __wc)
|
|
__THROW __asm ("wcschr") __attribute_pure__;
|
|
extern "C++" const wchar_t *wcschr (const wchar_t *__wcs, wchar_t __wc)
|
|
__THROW __asm ("wcschr") __attribute_pure__;
|
|
#else
|
|
extern wchar_t *wcschr (const wchar_t *__wcs, wchar_t __wc)
|
|
__THROW __attribute_pure__;
|
|
#endif
|
|
/* Find the last occurrence of WC in WCS. */
|
|
#ifdef __CORRECT_ISO_CPP_WCHAR_H_PROTO
|
|
extern "C++" wchar_t *wcsrchr (wchar_t *__wcs, wchar_t __wc)
|
|
__THROW __asm ("wcsrchr") __attribute_pure__;
|
|
extern "C++" const wchar_t *wcsrchr (const wchar_t *__wcs, wchar_t __wc)
|
|
__THROW __asm ("wcsrchr") __attribute_pure__;
|
|
#else
|
|
extern wchar_t *wcsrchr (const wchar_t *__wcs, wchar_t __wc)
|
|
__THROW __attribute_pure__;
|
|
#endif
|
|
|
|
#ifdef __USE_GNU
|
|
/* This function is similar to `wcschr'. But it returns a pointer to
|
|
the closing NUL wide character in case C is not found in S. */
|
|
extern wchar_t *wcschrnul (const wchar_t *__s, wchar_t __wc)
|
|
__THROW __attribute_pure__;
|
|
#endif
|
|
|
|
/* Return the length of the initial segmet of WCS which
|
|
consists entirely of wide characters not in REJECT. */
|
|
extern size_t wcscspn (const wchar_t *__wcs, const wchar_t *__reject)
|
|
__THROW __attribute_pure__;
|
|
/* Return the length of the initial segmet of WCS which
|
|
consists entirely of wide characters in ACCEPT. */
|
|
extern size_t wcsspn (const wchar_t *__wcs, const wchar_t *__accept)
|
|
__THROW __attribute_pure__;
|
|
/* Find the first occurrence in WCS of any character in ACCEPT. */
|
|
#ifdef __CORRECT_ISO_CPP_WCHAR_H_PROTO
|
|
extern "C++" wchar_t *wcspbrk (wchar_t *__wcs, const wchar_t *__accept)
|
|
__THROW __asm ("wcspbrk") __attribute_pure__;
|
|
extern "C++" const wchar_t *wcspbrk (const wchar_t *__wcs,
|
|
const wchar_t *__accept)
|
|
__THROW __asm ("wcspbrk") __attribute_pure__;
|
|
#else
|
|
extern wchar_t *wcspbrk (const wchar_t *__wcs, const wchar_t *__accept)
|
|
__THROW __attribute_pure__;
|
|
#endif
|
|
/* Find the first occurrence of NEEDLE in HAYSTACK. */
|
|
#ifdef __CORRECT_ISO_CPP_WCHAR_H_PROTO
|
|
extern "C++" wchar_t *wcsstr (wchar_t *__haystack, const wchar_t *__needle)
|
|
__THROW __asm ("wcsstr") __attribute_pure__;
|
|
extern "C++" const wchar_t *wcsstr (const wchar_t *__haystack,
|
|
const wchar_t *__needle)
|
|
__THROW __asm ("wcsstr") __attribute_pure__;
|
|
#else
|
|
extern wchar_t *wcsstr (const wchar_t *__haystack, const wchar_t *__needle)
|
|
__THROW __attribute_pure__;
|
|
#endif
|
|
|
|
/* Divide WCS into tokens separated by characters in DELIM. */
|
|
extern wchar_t *wcstok (wchar_t *__restrict __s,
|
|
const wchar_t *__restrict __delim,
|
|
wchar_t **__restrict __ptr) __THROW;
|
|
|
|
/* Return the number of wide characters in S. */
|
|
extern size_t wcslen (const wchar_t *__s) __THROW __attribute_pure__;
|
|
|
|
#ifdef __USE_XOPEN
|
|
/* Another name for `wcsstr' from XPG4. */
|
|
# ifdef __CORRECT_ISO_CPP_WCHAR_H_PROTO
|
|
extern "C++" wchar_t *wcswcs (wchar_t *__haystack, const wchar_t *__needle)
|
|
__THROW __asm ("wcswcs") __attribute_pure__;
|
|
extern "C++" const wchar_t *wcswcs (const wchar_t *__haystack,
|
|
const wchar_t *__needle)
|
|
__THROW __asm ("wcswcs") __attribute_pure__;
|
|
# else
|
|
extern wchar_t *wcswcs (const wchar_t *__haystack, const wchar_t *__needle)
|
|
__THROW __attribute_pure__;
|
|
# endif
|
|
#endif
|
|
|
|
#ifdef __USE_XOPEN2K8
|
|
/* Return the number of wide characters in S, but at most MAXLEN. */
|
|
extern size_t wcsnlen (const wchar_t *__s, size_t __maxlen)
|
|
__THROW __attribute_pure__;
|
|
#endif
|
|
|
|
|
|
/* Search N wide characters of S for C. */
|
|
#ifdef __CORRECT_ISO_CPP_WCHAR_H_PROTO
|
|
extern "C++" wchar_t *wmemchr (wchar_t *__s, wchar_t __c, size_t __n)
|
|
__THROW __asm ("wmemchr") __attribute_pure__;
|
|
extern "C++" const wchar_t *wmemchr (const wchar_t *__s, wchar_t __c,
|
|
size_t __n)
|
|
__THROW __asm ("wmemchr") __attribute_pure__;
|
|
#else
|
|
extern wchar_t *wmemchr (const wchar_t *__s, wchar_t __c, size_t __n)
|
|
__THROW __attribute_pure__;
|
|
#endif
|
|
|
|
/* Compare N wide characters of S1 and S2. */
|
|
extern int wmemcmp (const wchar_t *__s1, const wchar_t *__s2, size_t __n)
|
|
__THROW __attribute_pure__;
|
|
|
|
/* Copy N wide characters of SRC to DEST. */
|
|
extern wchar_t *wmemcpy (wchar_t *__restrict __s1,
|
|
const wchar_t *__restrict __s2, size_t __n) __THROW;
|
|
|
|
/* Copy N wide characters of SRC to DEST, guaranteeing
|
|
correct behavior for overlapping strings. */
|
|
extern wchar_t *wmemmove (wchar_t *__s1, const wchar_t *__s2, size_t __n)
|
|
__THROW;
|
|
|
|
/* Set N wide characters of S to C. */
|
|
extern wchar_t *wmemset (wchar_t *__s, wchar_t __c, size_t __n) __THROW;
|
|
|
|
#ifdef __USE_GNU
|
|
/* Copy N wide characters of SRC to DEST and return pointer to following
|
|
wide character. */
|
|
extern wchar_t *wmempcpy (wchar_t *__restrict __s1,
|
|
const wchar_t *__restrict __s2, size_t __n)
|
|
__THROW;
|
|
#endif
|
|
|
|
|
|
/* Determine whether C constitutes a valid (one-byte) multibyte
|
|
character. */
|
|
extern wint_t btowc (int __c) __THROW;
|
|
|
|
/* Determine whether C corresponds to a member of the extended
|
|
character set whose multibyte representation is a single byte. */
|
|
extern int wctob (wint_t __c) __THROW;
|
|
|
|
/* Determine whether PS points to an object representing the initial
|
|
state. */
|
|
extern int mbsinit (const mbstate_t *__ps) __THROW __attribute_pure__;
|
|
|
|
/* Write wide character representation of multibyte character pointed
|
|
to by S to PWC. */
|
|
extern size_t mbrtowc (wchar_t *__restrict __pwc,
|
|
const char *__restrict __s, size_t __n,
|
|
mbstate_t *__restrict __p) __THROW;
|
|
|
|
/* Write multibyte representation of wide character WC to S. */
|
|
extern size_t wcrtomb (char *__restrict __s, wchar_t __wc,
|
|
mbstate_t *__restrict __ps) __THROW;
|
|
|
|
/* Return number of bytes in multibyte character pointed to by S. */
|
|
extern size_t __mbrlen (const char *__restrict __s, size_t __n,
|
|
mbstate_t *__restrict __ps) __THROW;
|
|
extern size_t mbrlen (const char *__restrict __s, size_t __n,
|
|
mbstate_t *__restrict __ps) __THROW;
|
|
|
|
#ifdef __USE_EXTERN_INLINES
|
|
/* Define inline function as optimization. */
|
|
|
|
/* We can use the BTOWC and WCTOB optimizations since we know that all
|
|
locales must use ASCII encoding for the values in the ASCII range
|
|
and because the wchar_t encoding is always ISO 10646. */
|
|
extern wint_t __btowc_alias (int __c) __asm ("btowc");
|
|
__extern_inline wint_t
|
|
__NTH (btowc (int __c))
|
|
{ return (__builtin_constant_p (__c) && __c >= '\0' && __c <= '\x7f'
|
|
? (wint_t) __c : __btowc_alias (__c)); }
|
|
|
|
extern int __wctob_alias (wint_t __c) __asm ("wctob");
|
|
__extern_inline int
|
|
__NTH (wctob (wint_t __wc))
|
|
{ return (__builtin_constant_p (__wc) && __wc >= L'\0' && __wc <= L'\x7f'
|
|
? (int) __wc : __wctob_alias (__wc)); }
|
|
|
|
__extern_inline size_t
|
|
__NTH (mbrlen (const char *__restrict __s, size_t __n,
|
|
mbstate_t *__restrict __ps))
|
|
{ return (__ps != NULL
|
|
? mbrtowc (NULL, __s, __n, __ps) : __mbrlen (__s, __n, NULL)); }
|
|
#endif
|
|
|
|
/* Write wide character representation of multibyte character string
|
|
SRC to DST. */
|
|
extern size_t mbsrtowcs (wchar_t *__restrict __dst,
|
|
const char **__restrict __src, size_t __len,
|
|
mbstate_t *__restrict __ps) __THROW;
|
|
|
|
/* Write multibyte character representation of wide character string
|
|
SRC to DST. */
|
|
extern size_t wcsrtombs (char *__restrict __dst,
|
|
const wchar_t **__restrict __src, size_t __len,
|
|
mbstate_t *__restrict __ps) __THROW;
|
|
|
|
|
|
#ifdef __USE_XOPEN2K8
|
|
/* Write wide character representation of at most NMC bytes of the
|
|
multibyte character string SRC to DST. */
|
|
extern size_t mbsnrtowcs (wchar_t *__restrict __dst,
|
|
const char **__restrict __src, size_t __nmc,
|
|
size_t __len, mbstate_t *__restrict __ps) __THROW;
|
|
|
|
/* Write multibyte character representation of at most NWC characters
|
|
from the wide character string SRC to DST. */
|
|
extern size_t wcsnrtombs (char *__restrict __dst,
|
|
const wchar_t **__restrict __src,
|
|
size_t __nwc, size_t __len,
|
|
mbstate_t *__restrict __ps) __THROW;
|
|
#endif /* use POSIX 2008 */
|
|
|
|
|
|
/* The following functions are extensions found in X/Open CAE. */
|
|
#ifdef __USE_XOPEN
|
|
/* Determine number of column positions required for C. */
|
|
extern int wcwidth (wchar_t __c) __THROW;
|
|
|
|
/* Determine number of column positions required for first N wide
|
|
characters (or fewer if S ends before this) in S. */
|
|
extern int wcswidth (const wchar_t *__s, size_t __n) __THROW;
|
|
#endif /* Use X/Open. */
|
|
|
|
|
|
/* Convert initial portion of the wide string NPTR to `double'
|
|
representation. */
|
|
extern double wcstod (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr) __THROW;
|
|
|
|
#ifdef __USE_ISOC99
|
|
/* Likewise for `float' and `long double' sizes of floating-point numbers. */
|
|
extern float wcstof (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr) __THROW;
|
|
extern long double wcstold (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr) __THROW;
|
|
#endif /* C99 */
|
|
|
|
/* Likewise for `_FloatN' and `_FloatNx' when support is enabled. */
|
|
|
|
#if __HAVE_FLOAT16 && defined __USE_GNU
|
|
extern _Float16 wcstof16 (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr) __THROW;
|
|
#endif
|
|
|
|
#if __HAVE_FLOAT32 && defined __USE_GNU
|
|
extern _Float32 wcstof32 (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr) __THROW;
|
|
#endif
|
|
|
|
#if __HAVE_FLOAT64 && defined __USE_GNU
|
|
extern _Float64 wcstof64 (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr) __THROW;
|
|
#endif
|
|
|
|
#if __HAVE_FLOAT128 && defined __USE_GNU
|
|
extern _Float128 wcstof128 (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr) __THROW;
|
|
#endif
|
|
|
|
#if __HAVE_FLOAT32X && defined __USE_GNU
|
|
extern _Float32x wcstof32x (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr) __THROW;
|
|
#endif
|
|
|
|
#if __HAVE_FLOAT64X && defined __USE_GNU
|
|
extern _Float64x wcstof64x (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr) __THROW;
|
|
#endif
|
|
|
|
#if __HAVE_FLOAT128X && defined __USE_GNU
|
|
extern _Float128x wcstof128x (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr) __THROW;
|
|
#endif
|
|
|
|
|
|
/* Convert initial portion of wide string NPTR to `long int'
|
|
representation. */
|
|
extern long int wcstol (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr, int __base) __THROW;
|
|
|
|
/* Convert initial portion of wide string NPTR to `unsigned long int'
|
|
representation. */
|
|
extern unsigned long int wcstoul (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr, int __base)
|
|
__THROW;
|
|
|
|
#ifdef __USE_ISOC99
|
|
/* Convert initial portion of wide string NPTR to `long long int'
|
|
representation. */
|
|
__extension__
|
|
extern long long int wcstoll (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr, int __base)
|
|
__THROW;
|
|
|
|
/* Convert initial portion of wide string NPTR to `unsigned long long int'
|
|
representation. */
|
|
__extension__
|
|
extern unsigned long long int wcstoull (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr,
|
|
int __base) __THROW;
|
|
#endif /* ISO C99. */
|
|
|
|
#ifdef __USE_GNU
|
|
/* Convert initial portion of wide string NPTR to `long long int'
|
|
representation. */
|
|
__extension__
|
|
extern long long int wcstoq (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr, int __base)
|
|
__THROW;
|
|
|
|
/* Convert initial portion of wide string NPTR to `unsigned long long int'
|
|
representation. */
|
|
__extension__
|
|
extern unsigned long long int wcstouq (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr,
|
|
int __base) __THROW;
|
|
#endif /* Use GNU. */
|
|
|
|
#ifdef __USE_GNU
|
|
/* Parallel versions of the functions above which take the locale to
|
|
use as an additional parameter. These are GNU extensions inspired
|
|
by the POSIX.1-2008 extended locale API. */
|
|
extern long int wcstol_l (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr, int __base,
|
|
locale_t __loc) __THROW;
|
|
|
|
extern unsigned long int wcstoul_l (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr,
|
|
int __base, locale_t __loc) __THROW;
|
|
|
|
__extension__
|
|
extern long long int wcstoll_l (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr,
|
|
int __base, locale_t __loc) __THROW;
|
|
|
|
__extension__
|
|
extern unsigned long long int wcstoull_l (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr,
|
|
int __base, locale_t __loc)
|
|
__THROW;
|
|
|
|
extern double wcstod_l (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr, locale_t __loc)
|
|
__THROW;
|
|
|
|
extern float wcstof_l (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr, locale_t __loc)
|
|
__THROW;
|
|
|
|
extern long double wcstold_l (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr,
|
|
locale_t __loc) __THROW;
|
|
|
|
# if __HAVE_FLOAT16
|
|
extern _Float16 wcstof16_l (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr,
|
|
locale_t __loc) __THROW;
|
|
# endif
|
|
|
|
# if __HAVE_FLOAT32
|
|
extern _Float32 wcstof32_l (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr,
|
|
locale_t __loc) __THROW;
|
|
# endif
|
|
|
|
# if __HAVE_FLOAT64
|
|
extern _Float64 wcstof64_l (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr,
|
|
locale_t __loc) __THROW;
|
|
# endif
|
|
|
|
# if __HAVE_FLOAT128
|
|
extern _Float128 wcstof128_l (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr,
|
|
locale_t __loc) __THROW;
|
|
# endif
|
|
|
|
# if __HAVE_FLOAT32X
|
|
extern _Float32x wcstof32x_l (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr,
|
|
locale_t __loc) __THROW;
|
|
# endif
|
|
|
|
# if __HAVE_FLOAT64X
|
|
extern _Float64x wcstof64x_l (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr,
|
|
locale_t __loc) __THROW;
|
|
# endif
|
|
|
|
# if __HAVE_FLOAT128X
|
|
extern _Float128x wcstof128x_l (const wchar_t *__restrict __nptr,
|
|
wchar_t **__restrict __endptr,
|
|
locale_t __loc) __THROW;
|
|
# endif
|
|
#endif /* use GNU */
|
|
|
|
|
|
#ifdef __USE_XOPEN2K8
|
|
/* Copy SRC to DEST, returning the address of the terminating L'\0' in
|
|
DEST. */
|
|
extern wchar_t *wcpcpy (wchar_t *__restrict __dest,
|
|
const wchar_t *__restrict __src) __THROW;
|
|
|
|
/* Copy no more than N characters of SRC to DEST, returning the address of
|
|
the last character written into DEST. */
|
|
extern wchar_t *wcpncpy (wchar_t *__restrict __dest,
|
|
const wchar_t *__restrict __src, size_t __n)
|
|
__THROW;
|
|
#endif
|
|
|
|
|
|
/* Wide character I/O functions. */
|
|
|
|
#if defined __USE_XOPEN2K8 || __GLIBC_USE (LIB_EXT2)
|
|
/* Like OPEN_MEMSTREAM, but the stream is wide oriented and produces
|
|
a wide character string. */
|
|
extern __FILE *open_wmemstream (wchar_t **__bufloc, size_t *__sizeloc) __THROW;
|
|
#endif
|
|
|
|
#if defined __USE_ISOC95 || defined __USE_UNIX98
|
|
|
|
/* Select orientation for stream. */
|
|
extern int fwide (__FILE *__fp, int __mode) __THROW;
|
|
|
|
|
|
/* Write formatted output to STREAM.
|
|
|
|
This function is a possible cancellation point and therefore not
|
|
marked with __THROW. */
|
|
extern int fwprintf (__FILE *__restrict __stream,
|
|
const wchar_t *__restrict __format, ...)
|
|
/* __attribute__ ((__format__ (__wprintf__, 2, 3))) */;
|
|
/* Write formatted output to stdout.
|
|
|
|
This function is a possible cancellation point and therefore not
|
|
marked with __THROW. */
|
|
extern int wprintf (const wchar_t *__restrict __format, ...)
|
|
/* __attribute__ ((__format__ (__wprintf__, 1, 2))) */;
|
|
/* Write formatted output of at most N characters to S. */
|
|
extern int swprintf (wchar_t *__restrict __s, size_t __n,
|
|
const wchar_t *__restrict __format, ...)
|
|
__THROW /* __attribute__ ((__format__ (__wprintf__, 3, 4))) */;
|
|
|
|
/* Write formatted output to S from argument list ARG.
|
|
|
|
This function is a possible cancellation point and therefore not
|
|
marked with __THROW. */
|
|
extern int vfwprintf (__FILE *__restrict __s,
|
|
const wchar_t *__restrict __format,
|
|
__gnuc_va_list __arg)
|
|
/* __attribute__ ((__format__ (__wprintf__, 2, 0))) */;
|
|
/* Write formatted output to stdout from argument list ARG.
|
|
|
|
This function is a possible cancellation point and therefore not
|
|
marked with __THROW. */
|
|
extern int vwprintf (const wchar_t *__restrict __format,
|
|
__gnuc_va_list __arg)
|
|
/* __attribute__ ((__format__ (__wprintf__, 1, 0))) */;
|
|
/* Write formatted output of at most N character to S from argument
|
|
list ARG. */
|
|
extern int vswprintf (wchar_t *__restrict __s, size_t __n,
|
|
const wchar_t *__restrict __format,
|
|
__gnuc_va_list __arg)
|
|
__THROW /* __attribute__ ((__format__ (__wprintf__, 3, 0))) */;
|
|
|
|
|
|
/* Read formatted input from STREAM.
|
|
|
|
This function is a possible cancellation point and therefore not
|
|
marked with __THROW. */
|
|
extern int fwscanf (__FILE *__restrict __stream,
|
|
const wchar_t *__restrict __format, ...)
|
|
/* __attribute__ ((__format__ (__wscanf__, 2, 3))) */;
|
|
/* Read formatted input from stdin.
|
|
|
|
This function is a possible cancellation point and therefore not
|
|
marked with __THROW. */
|
|
extern int wscanf (const wchar_t *__restrict __format, ...)
|
|
/* __attribute__ ((__format__ (__wscanf__, 1, 2))) */;
|
|
/* Read formatted input from S. */
|
|
extern int swscanf (const wchar_t *__restrict __s,
|
|
const wchar_t *__restrict __format, ...)
|
|
__THROW /* __attribute__ ((__format__ (__wscanf__, 2, 3))) */;
|
|
|
|
/* For historical reasons, the C99-compliant versions of the scanf
|
|
functions are at alternative names. When __LDBL_COMPAT or
|
|
__LDOUBLE_REDIRECTS_TO_FLOAT128_ABI are in effect, this is handled in
|
|
bits/wchar-ldbl.h. */
|
|
#if !__GLIBC_USE (DEPRECATED_SCANF) && !defined __LDBL_COMPAT \
|
|
&& __LDOUBLE_REDIRECTS_TO_FLOAT128_ABI == 0
|
|
# ifdef __REDIRECT
|
|
extern int __REDIRECT (fwscanf, (__FILE *__restrict __stream,
|
|
const wchar_t *__restrict __format, ...),
|
|
__isoc99_fwscanf)
|
|
/* __attribute__ ((__format__ (__wscanf__, 2, 3))) */;
|
|
extern int __REDIRECT (wscanf, (const wchar_t *__restrict __format, ...),
|
|
__isoc99_wscanf)
|
|
/* __attribute__ ((__format__ (__wscanf__, 1, 2))) */;
|
|
extern int __REDIRECT_NTH (swscanf, (const wchar_t *__restrict __s,
|
|
const wchar_t *__restrict __format,
|
|
...), __isoc99_swscanf)
|
|
/* __attribute__ ((__format__ (__wscanf__, 2, 3))) */;
|
|
# else
|
|
extern int __isoc99_fwscanf (__FILE *__restrict __stream,
|
|
const wchar_t *__restrict __format, ...);
|
|
extern int __isoc99_wscanf (const wchar_t *__restrict __format, ...);
|
|
extern int __isoc99_swscanf (const wchar_t *__restrict __s,
|
|
const wchar_t *__restrict __format, ...)
|
|
__THROW;
|
|
# define fwscanf __isoc99_fwscanf
|
|
# define wscanf __isoc99_wscanf
|
|
# define swscanf __isoc99_swscanf
|
|
# endif
|
|
# endif
|
|
|
|
#endif /* Use ISO C95, C99 and Unix98. */
|
|
|
|
#ifdef __USE_ISOC99
|
|
/* Read formatted input from S into argument list ARG.
|
|
|
|
This function is a possible cancellation point and therefore not
|
|
marked with __THROW. */
|
|
extern int vfwscanf (__FILE *__restrict __s,
|
|
const wchar_t *__restrict __format,
|
|
__gnuc_va_list __arg)
|
|
/* __attribute__ ((__format__ (__wscanf__, 2, 0))) */;
|
|
/* Read formatted input from stdin into argument list ARG.
|
|
|
|
This function is a possible cancellation point and therefore not
|
|
marked with __THROW. */
|
|
extern int vwscanf (const wchar_t *__restrict __format,
|
|
__gnuc_va_list __arg)
|
|
/* __attribute__ ((__format__ (__wscanf__, 1, 0))) */;
|
|
/* Read formatted input from S into argument list ARG. */
|
|
extern int vswscanf (const wchar_t *__restrict __s,
|
|
const wchar_t *__restrict __format,
|
|
__gnuc_va_list __arg)
|
|
__THROW /* __attribute__ ((__format__ (__wscanf__, 2, 0))) */;
|
|
|
|
/* Same redirection as above for the v*wscanf family. */
|
|
# if !__GLIBC_USE (DEPRECATED_SCANF) \
|
|
&& (!defined __LDBL_COMPAT || !defined __REDIRECT) \
|
|
&& (defined __STRICT_ANSI__ || defined __USE_XOPEN2K) \
|
|
&& __LDOUBLE_REDIRECTS_TO_FLOAT128_ABI == 0
|
|
# ifdef __REDIRECT
|
|
extern int __REDIRECT (vfwscanf, (__FILE *__restrict __s,
|
|
const wchar_t *__restrict __format,
|
|
__gnuc_va_list __arg), __isoc99_vfwscanf)
|
|
/* __attribute__ ((__format__ (__wscanf__, 2, 0))) */;
|
|
extern int __REDIRECT (vwscanf, (const wchar_t *__restrict __format,
|
|
__gnuc_va_list __arg), __isoc99_vwscanf)
|
|
/* __attribute__ ((__format__ (__wscanf__, 1, 0))) */;
|
|
extern int __REDIRECT_NTH (vswscanf, (const wchar_t *__restrict __s,
|
|
const wchar_t *__restrict __format,
|
|
__gnuc_va_list __arg), __isoc99_vswscanf)
|
|
/* __attribute__ ((__format__ (__wscanf__, 2, 0))) */;
|
|
# else
|
|
extern int __isoc99_vfwscanf (__FILE *__restrict __s,
|
|
const wchar_t *__restrict __format,
|
|
__gnuc_va_list __arg);
|
|
extern int __isoc99_vwscanf (const wchar_t *__restrict __format,
|
|
__gnuc_va_list __arg);
|
|
extern int __isoc99_vswscanf (const wchar_t *__restrict __s,
|
|
const wchar_t *__restrict __format,
|
|
__gnuc_va_list __arg) __THROW;
|
|
# define vfwscanf __isoc99_vfwscanf
|
|
# define vwscanf __isoc99_vwscanf
|
|
# define vswscanf __isoc99_vswscanf
|
|
# endif
|
|
# endif
|
|
|
|
#endif /* Use ISO C99. */
|
|
|
|
|
|
/* Read a character from STREAM.
|
|
|
|
These functions are possible cancellation points and therefore not
|
|
marked with __THROW. */
|
|
extern wint_t fgetwc (__FILE *__stream);
|
|
extern wint_t getwc (__FILE *__stream);
|
|
|
|
/* Read a character from stdin.
|
|
|
|
This function is a possible cancellation point and therefore not
|
|
marked with __THROW. */
|
|
extern wint_t getwchar (void);
|
|
|
|
|
|
/* Write a character to STREAM.
|
|
|
|
These functions are possible cancellation points and therefore not
|
|
marked with __THROW. */
|
|
extern wint_t fputwc (wchar_t __wc, __FILE *__stream);
|
|
extern wint_t putwc (wchar_t __wc, __FILE *__stream);
|
|
|
|
/* Write a character to stdout.
|
|
|
|
This function is a possible cancellation point and therefore not
|
|
marked with __THROW. */
|
|
extern wint_t putwchar (wchar_t __wc);
|
|
|
|
|
|
/* Get a newline-terminated wide character string of finite length
|
|
from STREAM.
|
|
|
|
This function is a possible cancellation point and therefore not
|
|
marked with __THROW. */
|
|
extern wchar_t *fgetws (wchar_t *__restrict __ws, int __n,
|
|
__FILE *__restrict __stream);
|
|
|
|
/* Write a string to STREAM.
|
|
|
|
This function is a possible cancellation point and therefore not
|
|
marked with __THROW. */
|
|
extern int fputws (const wchar_t *__restrict __ws,
|
|
__FILE *__restrict __stream);
|
|
|
|
|
|
/* Push a character back onto the input buffer of STREAM.
|
|
|
|
This function is a possible cancellation point and therefore not
|
|
marked with __THROW. */
|
|
extern wint_t ungetwc (wint_t __wc, __FILE *__stream);
|
|
|
|
|
|
#ifdef __USE_GNU
|
|
/* These are defined to be equivalent to the `char' functions defined
|
|
in POSIX.1:1996.
|
|
|
|
These functions are not part of POSIX and therefore no official
|
|
cancellation point. But due to similarity with an POSIX interface
|
|
or due to the implementation they are cancellation points and
|
|
therefore not marked with __THROW. */
|
|
extern wint_t getwc_unlocked (__FILE *__stream);
|
|
extern wint_t getwchar_unlocked (void);
|
|
|
|
/* This is the wide character version of a GNU extension.
|
|
|
|
This function is not part of POSIX and therefore no official
|
|
cancellation point. But due to similarity with an POSIX interface
|
|
or due to the implementation it is a cancellation point and
|
|
therefore not marked with __THROW. */
|
|
extern wint_t fgetwc_unlocked (__FILE *__stream);
|
|
|
|
/* Faster version when locking is not necessary.
|
|
|
|
This function is not part of POSIX and therefore no official
|
|
cancellation point. But due to similarity with an POSIX interface
|
|
or due to the implementation it is a cancellation point and
|
|
therefore not marked with __THROW. */
|
|
extern wint_t fputwc_unlocked (wchar_t __wc, __FILE *__stream);
|
|
|
|
/* These are defined to be equivalent to the `char' functions defined
|
|
in POSIX.1:1996.
|
|
|
|
These functions are not part of POSIX and therefore no official
|
|
cancellation point. But due to similarity with an POSIX interface
|
|
or due to the implementation they are cancellation points and
|
|
therefore not marked with __THROW. */
|
|
extern wint_t putwc_unlocked (wchar_t __wc, __FILE *__stream);
|
|
extern wint_t putwchar_unlocked (wchar_t __wc);
|
|
|
|
|
|
/* This function does the same as `fgetws' but does not lock the stream.
|
|
|
|
This function is not part of POSIX and therefore no official
|
|
cancellation point. But due to similarity with an POSIX interface
|
|
or due to the implementation it is a cancellation point and
|
|
therefore not marked with __THROW. */
|
|
extern wchar_t *fgetws_unlocked (wchar_t *__restrict __ws, int __n,
|
|
__FILE *__restrict __stream);
|
|
|
|
/* This function does the same as `fputws' but does not lock the stream.
|
|
|
|
This function is not part of POSIX and therefore no official
|
|
cancellation point. But due to similarity with an POSIX interface
|
|
or due to the implementation it is a cancellation point and
|
|
therefore not marked with __THROW. */
|
|
extern int fputws_unlocked (const wchar_t *__restrict __ws,
|
|
__FILE *__restrict __stream);
|
|
#endif
|
|
|
|
|
|
/* Format TP into S according to FORMAT.
|
|
Write no more than MAXSIZE wide characters and return the number
|
|
of wide characters written, or 0 if it would exceed MAXSIZE. */
|
|
extern size_t wcsftime (wchar_t *__restrict __s, size_t __maxsize,
|
|
const wchar_t *__restrict __format,
|
|
const struct tm *__restrict __tp) __THROW;
|
|
|
|
# ifdef __USE_GNU
|
|
/* Similar to `wcsftime' but takes the information from
|
|
the provided locale and not the global locale. */
|
|
extern size_t wcsftime_l (wchar_t *__restrict __s, size_t __maxsize,
|
|
const wchar_t *__restrict __format,
|
|
const struct tm *__restrict __tp,
|
|
locale_t __loc) __THROW;
|
|
# endif
|
|
|
|
/* Define some macros helping to catch buffer overflows. */
|
|
#if __USE_FORTIFY_LEVEL > 0 && defined __fortify_function
|
|
# include <bits/wchar2.h>
|
|
#endif
|
|
|
|
#include <bits/floatn.h>
|
|
#if defined __LDBL_COMPAT || __LDOUBLE_REDIRECTS_TO_FLOAT128_ABI == 1
|
|
# include <bits/wchar-ldbl.h>
|
|
#endif
|
|
|
|
__END_DECLS
|
|
|
|
#endif /* wchar.h */
|