123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862 |
- /* Copyright (C) 1995-2021 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 */
|