| /* 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 */ |