blob: 3d477ba23c895c2046df53eab3e2f48810a6e300 [file] [log] [blame]
lh9ed821d2023-04-07 01:36:19 -07001/* Copyright (C) 1995-2002, 2003 Free Software Foundation, Inc.
2 This file is part of the GNU C Library.
3
4 The GNU C Library is free software; you can redistribute it and/or
5 modify it under the terms of the GNU Lesser General Public
6 License as published by the Free Software Foundation; either
7 version 2.1 of the License, or (at your option) any later version.
8
9 The GNU C Library is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 Lesser General Public License for more details.
13
14 You should have received a copy of the GNU Lesser General Public
15 License along with the GNU C Library; if not, write to the Free
16 Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
17 02111-1307 USA. */
18
19/*
20 * ISO C99 Standard: 7.24
21 * Extended multibyte and wide character utilities <wchar.h>
22 */
23
24#ifndef _WCHAR_H
25
26#ifndef __need_mbstate_t
27# define _WCHAR_H 1
28# include <features.h>
29#endif
30
31#ifndef __UCLIBC_HAS_WCHAR__
32#error Attempted to include wchar.h when uClibc built without wide char support.
33#endif
34
35#ifdef _WCHAR_H
36/* Get FILE definition. */
37# define __need___FILE
38# ifdef __USE_UNIX98
39# define __need_FILE
40# endif
41# include <stdio.h>
42/* Get va_list definition. */
43# define __need___va_list
44# include <stdarg.h>
45
46/* Get size_t, wchar_t, wint_t and NULL from <stddef.h>. */
47# define __need_size_t
48# define __need_wchar_t
49# define __need_NULL
50#endif
51#define __need_wint_t
52#include <stddef.h>
53
54#include <bits/wchar.h>
55
56/* We try to get wint_t from <stddef.h>, but not all GCC versions define it
57 there. So define it ourselves if it remains undefined. */
58#ifndef _WINT_T
59/* Integral type unchanged by default argument promotions that can
60 hold any value corresponding to members of the extended character
61 set, as well as at least one value that does not correspond to any
62 member of the extended character set. */
63# define _WINT_T
64typedef unsigned int wint_t;
65#else
66/* Work around problems with the <stddef.h> file which doesn't put
67 wint_t in the std namespace. */
68# if defined __cplusplus && defined _GLIBCPP_USE_NAMESPACES \
69 && defined __WINT_TYPE__
70__BEGIN_NAMESPACE_STD
71typedef __WINT_TYPE__ wint_t;
72__END_NAMESPACE_STD
73# endif
74#endif
75
76
77#ifndef __mbstate_t_defined
78# define __mbstate_t_defined 1
79/* Conversion state information. */
80#if 1
81typedef struct
82{
83 wchar_t __mask;
84 wchar_t __wc;
85} __mbstate_t;
86#else
87typedef struct
88{
89 int __count;
90 union
91 {
92 wint_t __wch;
93 char __wchb[4];
94 } __value; /* Value so far. */
95} __mbstate_t;
96#endif
97#endif
98#undef __need_mbstate_t
99
100
101/* The rest of the file is only used if used if __need_mbstate_t is not
102 defined. */
103#ifdef _WCHAR_H
104
105__BEGIN_NAMESPACE_C99
106/* Public type. */
107typedef __mbstate_t mbstate_t;
108__END_NAMESPACE_C99
109#ifdef __USE_GNU
110__USING_NAMESPACE_C99(mbstate_t)
111#endif
112
113#ifndef WCHAR_MIN
114/* These constants might also be defined in <inttypes.h>. */
115# define WCHAR_MIN __WCHAR_MIN
116# define WCHAR_MAX __WCHAR_MAX
117#endif
118
119#ifndef WEOF
120# define WEOF (0xffffffffu)
121#endif
122
123/* For XPG4 compliance we have to define the stuff from <wctype.h> here
124 as well. */
125#if defined __USE_XOPEN && !defined __USE_UNIX98
126# include <wctype.h>
127#endif
128
129
130__BEGIN_DECLS
131
132__BEGIN_NAMESPACE_STD
133/* This incomplete type is defined in <time.h> but needed here because
134 of `wcsftime'. */
135struct tm;
136/* XXX We have to clean this up at some point. Since tm is in the std
137 namespace but wcsftime is in __c99 the type wouldn't be found
138 without inserting it in the global namespace. */
139__USING_NAMESPACE_STD(tm)
140__END_NAMESPACE_STD
141
142
143__BEGIN_NAMESPACE_C99
144/* Copy SRC to DEST. */
145extern wchar_t *wcscpy (wchar_t *__restrict __dest,
146 __const wchar_t *__restrict __src) __THROW;
147/* Copy no more than N wide-characters of SRC to DEST. */
148extern wchar_t *wcsncpy (wchar_t *__restrict __dest,
149 __const wchar_t *__restrict __src, size_t __n)
150 __THROW;
151
152/* Append SRC onto DEST. */
153extern wchar_t *wcscat (wchar_t *__restrict __dest,
154 __const wchar_t *__restrict __src) __THROW;
155libc_hidden_proto(wcscat)
156/* Append no more than N wide-characters of SRC onto DEST. */
157extern wchar_t *wcsncat (wchar_t *__restrict __dest,
158 __const wchar_t *__restrict __src, size_t __n)
159 __THROW;
160
161/* Compare S1 and S2. */
162extern int wcscmp (__const wchar_t *__s1, __const wchar_t *__s2)
163 __THROW __attribute_pure__;
164libc_hidden_proto(wcscmp)
165/* Compare N wide-characters of S1 and S2. */
166extern int wcsncmp (__const wchar_t *__s1, __const wchar_t *__s2, size_t __n)
167 __THROW __attribute_pure__;
168__END_NAMESPACE_C99
169
170#ifdef __USE_GNU
171/* Compare S1 and S2, ignoring case. */
172extern int wcscasecmp (__const wchar_t *__s1, __const wchar_t *__s2) __THROW;
173
174/* Compare no more than N chars of S1 and S2, ignoring case. */
175extern int wcsncasecmp (__const wchar_t *__s1, __const wchar_t *__s2,
176 size_t __n) __THROW;
177
178#ifdef __UCLIBC_HAS_XLOCALE__
179/* Similar to the two functions above but take the information from
180 the provided locale and not the global locale. */
181# include <xlocale.h>
182
183extern int wcscasecmp_l (__const wchar_t *__s1, __const wchar_t *__s2,
184 __locale_t __loc) __THROW;
185libc_hidden_proto(wcscasecmp_l)
186
187extern int wcsncasecmp_l (__const wchar_t *__s1, __const wchar_t *__s2,
188 size_t __n, __locale_t __loc) __THROW;
189libc_hidden_proto(wcsncasecmp_l)
190#endif /* __UCLIBC_HAS_XLOCALE__ */
191#endif
192
193__BEGIN_NAMESPACE_C99
194/* Compare S1 and S2, both interpreted as appropriate to the
195 LC_COLLATE category of the current locale. */
196extern int wcscoll (__const wchar_t *__s1, __const wchar_t *__s2) __THROW;
197libc_hidden_proto(wcscoll)
198/* Transform S2 into array pointed to by S1 such that if wcscmp is
199 applied to two transformed strings the result is the as applying
200 `wcscoll' to the original strings. */
201extern size_t wcsxfrm (wchar_t *__restrict __s1,
202 __const wchar_t *__restrict __s2, size_t __n) __THROW;
203__END_NAMESPACE_C99
204
205#ifdef __USE_GNU
206#ifdef __UCLIBC_HAS_XLOCALE__
207/* Similar to the two functions above but take the information from
208 the provided locale and not the global locale. */
209
210/* Compare S1 and S2, both interpreted as appropriate to the
211 LC_COLLATE category of the given locale. */
212extern int wcscoll_l (__const wchar_t *__s1, __const wchar_t *__s2,
213 __locale_t __loc) __THROW;
214libc_hidden_proto(wcscoll_l)
215
216/* Transform S2 into array pointed to by S1 such that if wcscmp is
217 applied to two transformed strings the result is the as applying
218 `wcscoll' to the original strings. */
219extern size_t wcsxfrm_l (wchar_t *__s1, __const wchar_t *__s2,
220 size_t __n, __locale_t __loc) __THROW;
221libc_hidden_proto(wcsxfrm_l)
222
223#endif /* __UCLIBC_HAS_XLOCALE__ */
224
225/* Duplicate S, returning an identical malloc'd string. */
226extern wchar_t *wcsdup (__const wchar_t *__s) __THROW __attribute_malloc__;
227#endif
228
229__BEGIN_NAMESPACE_C99
230/* Find the first occurrence of WC in WCS. */
231extern wchar_t *wcschr (__const wchar_t *__wcs, wchar_t __wc)
232 __THROW __attribute_pure__;
233/* Find the last occurrence of WC in WCS. */
234extern wchar_t *wcsrchr (__const wchar_t *__wcs, wchar_t __wc)
235 __THROW __attribute_pure__;
236__END_NAMESPACE_C99
237
238#ifdef __USE_GNU
239/* This function is similar to `wcschr'. But it returns a pointer to
240 the closing NUL wide character in case C is not found in S. */
241extern wchar_t *wcschrnul (__const wchar_t *__s, wchar_t __wc)
242 __THROW __attribute_pure__;
243#endif
244
245__BEGIN_NAMESPACE_C99
246/* Return the length of the initial segmet of WCS which
247 consists entirely of wide characters not in REJECT. */
248extern size_t wcscspn (__const wchar_t *__wcs, __const wchar_t *__reject)
249 __THROW __attribute_pure__;
250/* Return the length of the initial segmet of WCS which
251 consists entirely of wide characters in ACCEPT. */
252extern size_t wcsspn (__const wchar_t *__wcs, __const wchar_t *__accept)
253 __THROW __attribute_pure__;
254libc_hidden_proto(wcsspn)
255/* Find the first occurrence in WCS of any character in ACCEPT. */
256extern wchar_t *wcspbrk (__const wchar_t *__wcs, __const wchar_t *__accept)
257 __THROW __attribute_pure__;
258libc_hidden_proto(wcspbrk)
259/* Find the first occurrence of NEEDLE in HAYSTACK. */
260extern wchar_t *wcsstr (__const wchar_t *__haystack, __const wchar_t *__needle)
261 __THROW __attribute_pure__;
262
263/* Divide WCS into tokens separated by characters in DELIM. */
264extern wchar_t *wcstok (wchar_t *__restrict __s,
265 __const wchar_t *__restrict __delim,
266 wchar_t **__restrict __ptr) __THROW;
267
268/* Return the number of wide characters in S. */
269extern size_t wcslen (__const wchar_t *__s) __THROW __attribute_pure__;
270libc_hidden_proto(wcslen)
271__END_NAMESPACE_C99
272
273#if defined __USE_XOPEN && defined __UCLIBC_SUSV3_LEGACY__
274/* Another name for `wcsstr' from XPG4. */
275extern wchar_t *wcswcs (__const wchar_t *__haystack, __const wchar_t *__needle)
276 __THROW __attribute_pure__;
277#endif
278
279#ifdef __USE_GNU
280/* Return the number of wide characters in S, but at most MAXLEN. */
281extern size_t wcsnlen (__const wchar_t *__s, size_t __maxlen)
282 __THROW __attribute_pure__;
283libc_hidden_proto(wcsnlen)
284#endif
285
286
287__BEGIN_NAMESPACE_C99
288/* Search N wide characters of S for C. */
289extern wchar_t *wmemchr (__const wchar_t *__s, wchar_t __c, size_t __n)
290 __THROW __attribute_pure__;
291libc_hidden_proto(wmemchr)
292
293/* Compare N wide characters of S1 and S2. */
294extern int wmemcmp (__const wchar_t *__restrict __s1,
295 __const wchar_t *__restrict __s2, size_t __n)
296 __THROW __attribute_pure__;
297
298/* Copy N wide characters of SRC to DEST. */
299extern wchar_t *wmemcpy (wchar_t *__restrict __s1,
300 __const wchar_t *__restrict __s2, size_t __n) __THROW;
301libc_hidden_proto(wmemcpy)
302
303/* Copy N wide characters of SRC to DEST, guaranteeing
304 correct behavior for overlapping strings. */
305extern wchar_t *wmemmove (wchar_t *__s1, __const wchar_t *__s2, size_t __n)
306 __THROW;
307
308/* Set N wide characters of S to C. */
309extern wchar_t *wmemset (wchar_t *__s, wchar_t __c, size_t __n) __THROW;
310__END_NAMESPACE_C99
311
312#ifdef __USE_GNU
313/* Copy N wide characters of SRC to DEST and return pointer to following
314 wide character. */
315extern wchar_t *wmempcpy (wchar_t *__restrict __s1,
316 __const wchar_t *__restrict __s2, size_t __n)
317 __THROW;
318libc_hidden_proto(wmempcpy)
319#endif
320
321
322__BEGIN_NAMESPACE_C99
323/* Determine whether C constitutes a valid (one-byte) multibyte
324 character. */
325extern wint_t btowc (int __c) __THROW;
326libc_hidden_proto(btowc)
327
328/* Determine whether C corresponds to a member of the extended
329 character set whose multibyte representation is a single byte. */
330extern int wctob (wint_t __c) __THROW;
331
332/* Determine whether PS points to an object representing the initial
333 state. */
334extern int mbsinit (__const mbstate_t *__ps) __THROW __attribute_pure__;
335libc_hidden_proto(mbsinit)
336
337/* Write wide character representation of multibyte character pointed
338 to by S to PWC. */
339extern size_t mbrtowc (wchar_t *__restrict __pwc,
340 __const char *__restrict __s, size_t __n,
341 mbstate_t *__p) __THROW;
342libc_hidden_proto(mbrtowc)
343
344/* Write multibyte representation of wide character WC to S. */
345extern size_t wcrtomb (char *__restrict __s, wchar_t __wc,
346 mbstate_t *__restrict __ps) __THROW;
347libc_hidden_proto(wcrtomb)
348
349/* Return number of bytes in multibyte character pointed to by S. */
350#if 0 /* uClibc: disabled */
351extern size_t __mbrlen (__const char *__restrict __s, size_t __n,
352 mbstate_t *__restrict __ps) __THROW;
353#endif
354extern size_t mbrlen (__const char *__restrict __s, size_t __n,
355 mbstate_t *__restrict __ps) __THROW;
356libc_hidden_proto(mbrlen)
357
358/* Write wide character representation of multibyte character string
359 SRC to DST. */
360extern size_t mbsrtowcs (wchar_t *__restrict __dst,
361 __const char **__restrict __src, size_t __len,
362 mbstate_t *__restrict __ps) __THROW;
363libc_hidden_proto(mbsrtowcs)
364
365/* Write multibyte character representation of wide character string
366 SRC to DST. */
367extern size_t wcsrtombs (char *__restrict __dst,
368 __const wchar_t **__restrict __src, size_t __len,
369 mbstate_t *__restrict __ps) __THROW;
370libc_hidden_proto(wcsrtombs)
371__END_NAMESPACE_C99
372
373
374#ifdef __USE_GNU
375/* Write wide character representation of at most NMC bytes of the
376 multibyte character string SRC to DST. */
377extern size_t mbsnrtowcs (wchar_t *__restrict __dst,
378 __const char **__restrict __src, size_t __nmc,
379 size_t __len, mbstate_t *__restrict __ps) __THROW;
380libc_hidden_proto(mbsnrtowcs)
381
382/* Write multibyte character representation of at most NWC characters
383 from the wide character string SRC to DST. */
384extern size_t wcsnrtombs (char *__restrict __dst,
385 __const wchar_t **__restrict __src,
386 size_t __nwc, size_t __len,
387 mbstate_t *__restrict __ps) __THROW;
388libc_hidden_proto(wcsnrtombs)
389#endif /* use GNU */
390
391
392/* The following functions are extensions found in X/Open CAE. */
393#ifdef __USE_XOPEN
394/* Determine number of column positions required for C. */
395extern int wcwidth (wchar_t __c) __THROW;
396
397/* Determine number of column positions required for first N wide
398 characters (or fewer if S ends before this) in S. */
399extern int wcswidth (__const wchar_t *__s, size_t __n) __THROW;
400libc_hidden_proto(wcswidth)
401#endif /* Use X/Open. */
402
403
404__BEGIN_NAMESPACE_C99
405#ifdef __UCLIBC_HAS_FLOATS__
406/* Convert initial portion of the wide string NPTR to `double'
407 representation. */
408extern double wcstod (__const wchar_t *__restrict __nptr,
409 wchar_t **__restrict __endptr) __THROW;
410
411#ifdef __USE_ISOC99
412/* Likewise for `float' and `long double' sizes of floating-point numbers. */
413extern float wcstof (__const wchar_t *__restrict __nptr,
414 wchar_t **__restrict __endptr) __THROW;
415extern long double wcstold (__const wchar_t *__restrict __nptr,
416 wchar_t **__restrict __endptr) __THROW;
417#endif /* C99 */
418#endif /* __UCLIBC_HAS_FLOATS__ */
419
420
421/* Convert initial portion of wide string NPTR to `long int'
422 representation. */
423extern long int wcstol (__const wchar_t *__restrict __nptr,
424 wchar_t **__restrict __endptr, int __base) __THROW;
425
426/* Convert initial portion of wide string NPTR to `unsigned long int'
427 representation. */
428extern unsigned long int wcstoul (__const wchar_t *__restrict __nptr,
429 wchar_t **__restrict __endptr, int __base)
430 __THROW;
431
432#if defined __USE_ISOC99 || (defined __GNUC__ && defined __USE_GNU)
433/* Convert initial portion of wide string NPTR to `long int'
434 representation. */
435__extension__
436extern long long int wcstoll (__const wchar_t *__restrict __nptr,
437 wchar_t **__restrict __endptr, int __base)
438 __THROW;
439
440/* Convert initial portion of wide string NPTR to `unsigned long long int'
441 representation. */
442__extension__
443extern unsigned long long int wcstoull (__const wchar_t *__restrict __nptr,
444 wchar_t **__restrict __endptr,
445 int __base) __THROW;
446#endif /* ISO C99 or GCC and GNU. */
447__END_NAMESPACE_C99
448
449#if defined __GNUC__ && defined __USE_GNU
450/* Convert initial portion of wide string NPTR to `long int'
451 representation. */
452__extension__
453extern long long int wcstoq (__const wchar_t *__restrict __nptr,
454 wchar_t **__restrict __endptr, int __base)
455 __THROW;
456
457/* Convert initial portion of wide string NPTR to `unsigned long long int'
458 representation. */
459__extension__
460extern unsigned long long int wcstouq (__const wchar_t *__restrict __nptr,
461 wchar_t **__restrict __endptr,
462 int __base) __THROW;
463#endif /* GCC and use GNU. */
464
465#ifdef __USE_GNU
466#ifdef __UCLIBC_HAS_XLOCALE__
467/* The concept of one static locale per category is not very well
468 thought out. Many applications will need to process its data using
469 information from several different locales. Another application is
470 the implementation of the internationalization handling in the
471 upcoming ISO C++ standard library. To support this another set of
472 the functions using locale data exist which have an additional
473 argument.
474
475 Attention: all these functions are *not* standardized in any form.
476 This is a proof-of-concept implementation. */
477
478/* Structure for reentrant locale using functions. This is an
479 (almost) opaque type for the user level programs. */
480# include <xlocale.h>
481
482/* Special versions of the functions above which take the locale to
483 use as an additional parameter. */
484extern long int wcstol_l (__const wchar_t *__restrict __nptr,
485 wchar_t **__restrict __endptr, int __base,
486 __locale_t __loc) __THROW;
487
488extern unsigned long int wcstoul_l (__const wchar_t *__restrict __nptr,
489 wchar_t **__restrict __endptr,
490 int __base, __locale_t __loc) __THROW;
491
492__extension__
493extern long long int wcstoll_l (__const wchar_t *__restrict __nptr,
494 wchar_t **__restrict __endptr,
495 int __base, __locale_t __loc) __THROW;
496
497__extension__
498extern unsigned long long int wcstoull_l (__const wchar_t *__restrict __nptr,
499 wchar_t **__restrict __endptr,
500 int __base, __locale_t __loc)
501 __THROW;
502
503#ifdef __UCLIBC_HAS_FLOATS__
504extern double wcstod_l (__const wchar_t *__restrict __nptr,
505 wchar_t **__restrict __endptr, __locale_t __loc)
506 __THROW;
507
508extern float wcstof_l (__const wchar_t *__restrict __nptr,
509 wchar_t **__restrict __endptr, __locale_t __loc)
510 __THROW;
511
512extern long double wcstold_l (__const wchar_t *__restrict __nptr,
513 wchar_t **__restrict __endptr,
514 __locale_t __loc) __THROW;
515#endif /* __UCLIBC_HAS_FLOATS__ */
516#endif /* __UCLIBC_HAS_XLOCALE__ */
517#endif /* GNU */
518
519
520#ifdef __USE_GNU
521/* Copy SRC to DEST, returning the address of the terminating L'\0' in
522 DEST. */
523extern wchar_t *wcpcpy (wchar_t *__dest, __const wchar_t *__src) __THROW;
524
525/* Copy no more than N characters of SRC to DEST, returning the address of
526 the last character written into DEST. */
527extern wchar_t *wcpncpy (wchar_t *__dest, __const wchar_t *__src, size_t __n)
528 __THROW;
529#endif /* use GNU */
530
531
532/* Wide character I/O functions. */
533#if defined __USE_ISOC99 || defined __USE_UNIX98
534__BEGIN_NAMESPACE_C99
535
536/* Select orientation for stream. */
537extern int fwide (__FILE *__fp, int __mode) __THROW;
538
539
540/* Write formatted output to STREAM.
541
542 This function is a possible cancellation point and therefore not
543 marked with __THROW. */
544extern int fwprintf (__FILE *__restrict __stream,
545 __const wchar_t *__restrict __format, ...)
546 /* __attribute__ ((__format__ (__wprintf__, 2, 3))) */;
547/* Write formatted output to stdout.
548
549 This function is a possible cancellation point and therefore not
550 marked with __THROW. */
551extern int wprintf (__const wchar_t *__restrict __format, ...)
552 /* __attribute__ ((__format__ (__wprintf__, 1, 2))) */;
553/* Write formatted output of at most N characters to S. */
554extern int swprintf (wchar_t *__restrict __s, size_t __n,
555 __const wchar_t *__restrict __format, ...)
556 __THROW /* __attribute__ ((__format__ (__wprintf__, 3, 4))) */;
557
558/* Write formatted output to S from argument list ARG.
559
560 This function is a possible cancellation point and therefore not
561 marked with __THROW. */
562extern int vfwprintf (__FILE *__restrict __s,
563 __const wchar_t *__restrict __format,
564 __gnuc_va_list __arg)
565 /* __attribute__ ((__format__ (__wprintf__, 2, 0))) */;
566libc_hidden_proto(vfwprintf)
567/* Write formatted output to stdout from argument list ARG.
568
569 This function is a possible cancellation point and therefore not
570 marked with __THROW. */
571extern int vwprintf (__const wchar_t *__restrict __format,
572 __gnuc_va_list __arg)
573 /* __attribute__ ((__format__ (__wprintf__, 1, 0))) */;
574/* Write formatted output of at most N character to S from argument
575 list ARG. */
576extern int vswprintf (wchar_t *__restrict __s, size_t __n,
577 __const wchar_t *__restrict __format,
578 __gnuc_va_list __arg)
579 __THROW /* __attribute__ ((__format__ (__wprintf__, 3, 0))) */;
580libc_hidden_proto(vswprintf)
581
582
583/* Read formatted input from STREAM.
584
585 This function is a possible cancellation point and therefore not
586 marked with __THROW. */
587extern int fwscanf (__FILE *__restrict __stream,
588 __const wchar_t *__restrict __format, ...)
589 /* __attribute__ ((__format__ (__wscanf__, 2, 3))) */;
590/* Read formatted input from stdin.
591
592 This function is a possible cancellation point and therefore not
593 marked with __THROW. */
594extern int wscanf (__const wchar_t *__restrict __format, ...)
595 /* __attribute__ ((__format__ (__wscanf__, 1, 2))) */;
596/* Read formatted input from S. */
597extern int swscanf (__const wchar_t *__restrict __s,
598 __const wchar_t *__restrict __format, ...)
599 __THROW /* __attribute__ ((__format__ (__wscanf__, 2, 3))) */;
600
601__END_NAMESPACE_C99
602#endif /* Use ISO C99 and Unix98. */
603
604#ifdef __USE_ISOC99
605__BEGIN_NAMESPACE_C99
606
607/* Read formatted input from S into argument list ARG.
608
609 This function is a possible cancellation point and therefore not
610 marked with __THROW. */
611extern int vfwscanf (__FILE *__restrict __s,
612 __const wchar_t *__restrict __format,
613 __gnuc_va_list __arg)
614 /* __attribute__ ((__format__ (__wscanf__, 2, 0))) */;
615libc_hidden_proto(vfwscanf)
616/* Read formatted input from stdin into argument list ARG.
617
618 This function is a possible cancellation point and therefore not
619 marked with __THROW. */
620extern int vwscanf (__const wchar_t *__restrict __format,
621 __gnuc_va_list __arg)
622 /* __attribute__ ((__format__ (__wscanf__, 1, 0))) */;
623/* Read formatted input from S into argument list ARG. */
624extern int vswscanf (__const wchar_t *__restrict __s,
625 __const wchar_t *__restrict __format,
626 __gnuc_va_list __arg)
627 __THROW /* __attribute__ ((__format__ (__wscanf__, 2, 0))) */;
628libc_hidden_proto(vswscanf)
629
630__END_NAMESPACE_C99
631#endif /* Use ISO C99. */
632
633
634__BEGIN_NAMESPACE_C99
635/* Read a character from STREAM.
636
637 These functions are possible cancellation points and therefore not
638 marked with __THROW. */
639extern wint_t fgetwc (__FILE *__stream);
640libc_hidden_proto(fgetwc)
641extern wint_t getwc (__FILE *__stream);
642
643/* Read a character from stdin.
644
645 This function is a possible cancellation point and therefore not
646 marked with __THROW. */
647extern wint_t getwchar (void);
648
649
650/* Write a character to STREAM.
651
652 These functions are possible cancellation points and therefore not
653 marked with __THROW. */
654extern wint_t fputwc (wchar_t __wc, __FILE *__stream);
655extern wint_t putwc (wchar_t __wc, __FILE *__stream);
656
657/* Write a character to stdout.
658
659 This function is a possible cancellation points and therefore not
660 marked with __THROW. */
661extern wint_t putwchar (wchar_t __wc);
662
663
664/* Get a newline-terminated wide character string of finite length
665 from STREAM.
666
667 This function is a possible cancellation points and therefore not
668 marked with __THROW. */
669extern wchar_t *fgetws (wchar_t *__restrict __ws, int __n,
670 __FILE *__restrict __stream);
671
672/* Write a string to STREAM.
673
674 This function is a possible cancellation points and therefore not
675 marked with __THROW. */
676extern int fputws (__const wchar_t *__restrict __ws,
677 __FILE *__restrict __stream);
678libc_hidden_proto(fputws)
679
680
681/* Push a character back onto the input buffer of STREAM.
682
683 This function is a possible cancellation points and therefore not
684 marked with __THROW. */
685extern wint_t ungetwc (wint_t __wc, __FILE *__stream);
686libc_hidden_proto(ungetwc)
687__END_NAMESPACE_C99
688
689
690#ifdef __USE_GNU
691/* These are defined to be equivalent to the `char' functions defined
692 in POSIX.1:1996.
693
694 These functions are not part of POSIX and therefore no official
695 cancellation point. But due to similarity with an POSIX interface
696 or due to the implementation they are cancellation points and
697 therefore not marked with __THROW. */
698extern wint_t getwc_unlocked (__FILE *__stream);
699extern wint_t getwchar_unlocked (void);
700
701/* This is the wide character version of a GNU extension.
702
703 This function is not part of POSIX and therefore no official
704 cancellation point. But due to similarity with an POSIX interface
705 or due to the implementation it is a cancellation point and
706 therefore not marked with __THROW. */
707extern wint_t fgetwc_unlocked (__FILE *__stream);
708libc_hidden_proto(fgetwc_unlocked)
709
710/* Faster version when locking is not necessary.
711
712 This function is not part of POSIX and therefore no official
713 cancellation point. But due to similarity with an POSIX interface
714 or due to the implementation it is a cancellation point and
715 therefore not marked with __THROW. */
716extern wint_t fputwc_unlocked (wchar_t __wc, __FILE *__stream);
717libc_hidden_proto(fputwc_unlocked)
718
719/* These are defined to be equivalent to the `char' functions defined
720 in POSIX.1:1996.
721
722 These functions are not part of POSIX and therefore no official
723 cancellation point. But due to similarity with an POSIX interface
724 or due to the implementation they are cancellation points and
725 therefore not marked with __THROW. */
726extern wint_t putwc_unlocked (wchar_t __wc, __FILE *__stream);
727extern wint_t putwchar_unlocked (wchar_t __wc);
728
729
730/* This function does the same as `fgetws' but does not lock the stream.
731
732 This function is not part of POSIX and therefore no official
733 cancellation point. But due to similarity with an POSIX interface
734 or due to the implementation it is a cancellation point and
735 therefore not marked with __THROW. */
736extern wchar_t *fgetws_unlocked (wchar_t *__restrict __ws, int __n,
737 __FILE *__restrict __stream);
738libc_hidden_proto(fgetws_unlocked)
739
740/* This function does the same as `fputws' but does not lock the stream.
741
742 This function is not part of POSIX and therefore no official
743 cancellation point. But due to similarity with an POSIX interface
744 or due to the implementation it is a cancellation point and
745 therefore not marked with __THROW. */
746extern int fputws_unlocked (__const wchar_t *__restrict __ws,
747 __FILE *__restrict __stream);
748libc_hidden_proto(fputws_unlocked)
749#endif
750
751
752__BEGIN_NAMESPACE_C99
753/* Format TP into S according to FORMAT.
754 Write no more than MAXSIZE wide characters and return the number
755 of wide characters written, or 0 if it would exceed MAXSIZE. */
756extern size_t wcsftime (wchar_t *__restrict __s, size_t __maxsize,
757 __const wchar_t *__restrict __format,
758 __const struct tm *__restrict __tp) __THROW;
759__END_NAMESPACE_C99
760
761# if defined __USE_GNU && defined __UCLIBC_HAS_XLOCALE__
762# include <xlocale.h>
763
764/* Similar to `wcsftime' but takes the information from
765 the provided locale and not the global locale. */
766extern size_t wcsftime_l (wchar_t *__restrict __s, size_t __maxsize,
767 __const wchar_t *__restrict __format,
768 __const struct tm *__restrict __tp,
769 __locale_t __loc) __THROW;
770libc_hidden_proto(wcsftime_l)
771# endif
772
773/* The X/Open standard demands that most of the functions defined in
774 the <wctype.h> header must also appear here. This is probably
775 because some X/Open members wrote their implementation before the
776 ISO C standard was published and introduced the better solution.
777 We have to provide these definitions for compliance reasons but we
778 do this nonsense only if really necessary. */
779#if defined __USE_UNIX98 && !defined __USE_GNU
780# define __need_iswxxx
781# include <wctype.h>
782#endif
783
784#ifdef _LIBC
785extern size_t __wcslcpy(wchar_t *__restrict dst,
786 const wchar_t *__restrict src, size_t n) attribute_hidden;
787#endif
788
789__END_DECLS
790
791#endif /* _WCHAR_H defined */
792
793#endif /* wchar.h */