wcsmbs/wchar.h

   1 /* Copyright (C) 1995-1999, 2000 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 Library General Public License as
   6    published by the Free Software Foundation; either version 2 of the
   7    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    Library General Public License for more details.
  13
  14    You should have received a copy of the GNU Library General Public
  15    License along with the GNU C Library; see the file COPYING.LIB.  If not,
  16    write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  17    Boston, MA 02111-1307, USA.  */
  18
  19 /*
  20  *      ISO C Standard, Amendment 1, 7.16.4
  21  *      General wide-string 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 #ifdef _WCHAR_H
  32 /* Get FILE definition.  */
  33 # define __need_FILE
  34 # include <stdio.h>
  35 /* Get va_list definition.  */
  36 # define __need___va_list
  37 # include <stdarg.h>
  38
  39 /* Get size_t, wchar_t, wint_t and NULL from <stddef.h>.  */
  40 # define __need_size_t
  41 # define __need_wchar_t
  42 # define __need_NULL
  43 #endif
  44 #define __need_wint_t
  45 #include <stddef.h>
  46
  47 /* We try to get wint_t from <stddef.h>, but not all GCC versions define it
  48    there.  So define it ourselves if it remains undefined.  */
  49 #ifndef _WINT_T
  50 /* Integral type unchanged by default argument promotions that can
  51    hold any value corresponding to members of the extended character
  52    set, as well as at least one value that does not correspond to any
  53    member of the extended character set.  */
  54 # define _WINT_T
  55 typedef unsigned int wint_t;
  56 #endif
  57
  58
  59 #ifndef __mbstate_t_defined
  60 # define __mbstate_t_defined    1
  61 /* Conversion state information.  */
  62 typedef struct
  63 {
  64   int __count;
  65   union
  66   {
  67     wint_t __wch;
  68     char __wchb[4];
  69   } __value;            /* Value so far.  */
  70 } __mbstate_t;
  71 #endif
  72 #undef __need_mbstate_t
  73
  74
  75 /* The rest of the file is only used if used if __need_mbstate_t is not
  76    defined.  */
  77 #ifdef _WCHAR_H
  78
  79 /* Public type.  */
  80 typedef __mbstate_t mbstate_t;
  81
  82 #ifndef WCHAR_MIN
  83 /* These constants might also be defined in <inttypes.h>.  */
  84 # define WCHAR_MIN (0)
  85 # define WCHAR_MAX (0x7fffffff)
  86 #endif
  87
  88 #ifndef WEOF
  89 # define WEOF (0xffffffffu)
  90 #endif
  91
  92 /* For XPG4 compliance we have to define the stuff from <wctype.h> here
  93    as well.  */
  94 #if defined __USE_XOPEN && !defined __USE_UNIX98
  95 # include <wctype.h>
  96 #endif
  97
  98 /* This incomplete type is defined in <time.h> but needed here because
  99    of `wcsftime'.  */
 100 struct tm;
 101
 102
 103 __BEGIN_DECLS
 104
 105 /* Copy SRC to DEST.  */
 106 extern wchar_t *wcscpy (wchar_t *__restrict __dest,
 107                         __const wchar_t *__restrict __src) __THROW;
 108 /* Copy no more than N wide-characters of SRC to DEST.  */
 109 extern wchar_t *wcsncpy (wchar_t *__restrict __dest,
 110                          __const wchar_t *__restrict __src, size_t __n)
 111      __THROW;
 112
 113 /* Append SRC onto DEST.  */
 114 extern wchar_t *wcscat (wchar_t *__restrict __dest,
 115                         __const wchar_t *__restrict __src) __THROW;
 116 /* Append no more than N wide-characters of SRC onto DEST.  */
 117 extern wchar_t *wcsncat (wchar_t *__restrict __dest,
 118                          __const wchar_t *__restrict __src, size_t __n)
 119      __THROW;
 120
 121 /* Compare S1 and S2.  */
 122 extern int wcscmp (__const wchar_t *__s1, __const wchar_t *__s2) __THROW;
 123 /* Compare N wide-characters of S1 and S2.  */
 124 extern int wcsncmp (__const wchar_t *__s1, __const wchar_t *__s2, size_t __n)
 125      __THROW;
 126
 127 #ifdef __USE_GNU
 128 /* Compare S1 and S2, ignoring case.  */
 129 extern int wcscasecmp (__const wchar_t *__s1, __const wchar_t *__s2) __THROW;
 130
 131 /* Compare no more than N chars of S1 and S2, ignoring case.  */
 132 extern int wcsncasecmp (__const wchar_t *__s1, __const wchar_t *__s2,
 133                         size_t __n) __THROW;
 134
 135 /* Similar to the two functions above but take the information from
 136    the provided locale and not the global locale.  */
 137 # include <xlocale.h>
 138
 139 extern int __wcscasecmp_l (__const wchar_t *__s1, __const wchar_t *__s2,
 140                            __locale_t __loc) __THROW;
 141
 142 extern int __wcsncasecmp_l (__const wchar_t *__s1, __const wchar_t *__s2,
 143                             size_t __n, __locale_t __loc) __THROW;
 144 #endif
 145
 146 /* Compare S1 and S2, both interpreted as appropriate to the
 147    LC_COLLATE category of the current locale.  */
 148 extern int wcscoll (__const wchar_t *__s1, __const wchar_t *__s2) __THROW;
 149 /* Transform S2 into array pointed to by S1 such that if wcscmp is
 150    applied to two transformed strings the result is the as applying
 151    `wcscoll' to the original strings.  */
 152 extern size_t wcsxfrm (wchar_t *__restrict __s1,
 153                        __const wchar_t *__restrict __s2, size_t __n) __THROW;
 154
 155 #ifdef __USE_GNU
 156 /* Similar to the two functions above but take the information from
 157    the provided locale and not the global locale.  */
 158
 159 /* Compare S1 and S2, both interpreted as appropriate to the
 160    LC_COLLATE category of the given locale.  */
 161 extern int __wcscoll_l (__const wchar_t *__s1, __const wchar_t *__s2,
 162                         __locale_t __loc) __THROW;
 163 /* Transform S2 into array pointed to by S1 such that if wcscmp is
 164    applied to two transformed strings the result is the as applying
 165    `wcscoll' to the original strings.  */
 166 extern size_t __wcsxfrm_l (wchar_t *__s1, __const wchar_t *__s2,
 167                            size_t __n, __locale_t __loc) __THROW;
 168
 169 /* Duplicate S, returning an identical malloc'd string.  */
 170 extern wchar_t *wcsdup (__const wchar_t *__s) __THROW;
 171 #endif
 172
 173 /* Find the first occurrence of WC in WCS.  */
 174 extern wchar_t *wcschr (__const wchar_t *__wcs, wchar_t __wc) __THROW;
 175 /* Find the last occurrence of WC in WCS.  */
 176 extern wchar_t *wcsrchr (__const wchar_t *__wcs, wchar_t __wc) __THROW;
 177
 178 #ifdef __USE_GNU
 179 /* This funciton is similar to `wcschr'.  But it returns a pointer to
 180    the closing NUL wide character in case C is not found in S.  */
 181 extern wchar_t *wcschrnul (__const wchar_t *__s, wchar_t __wc) __THROW;
 182 #endif
 183
 184 /* Return the length of the initial segmet of WCS which
 185    consists entirely of wide characters not in REJECT.  */
 186 extern size_t wcscspn (__const wchar_t *__wcs, __const wchar_t *__reject)
 187      __THROW;
 188 /* Return the length of the initial segmet of WCS which
 189    consists entirely of wide characters in  ACCEPT.  */
 190 extern size_t wcsspn (__const wchar_t *__wcs, __const wchar_t *__accept)
 191      __THROW;
 192 /* Find the first occurrence in WCS of any character in ACCEPT.  */
 193 extern wchar_t *wcspbrk (__const wchar_t *__wcs, __const wchar_t *__accept)
 194      __THROW;
 195 /* Find the first occurrence of NEEDLE in HAYSTACK.  */
 196 extern wchar_t *wcsstr (__const wchar_t *__haystack, __const wchar_t *__needle)
 197      __THROW;
 198
 199 #if defined __USE_XOPEN && !defined __USE_UNIX98
 200 /* Another name for `wcsstr' from XPG4.  */
 201 extern wchar_t *wcswcs (__const wchar_t *__haystack, __const wchar_t *__needle)
 202      __THROW;
 203 #endif
 204
 205 /* Divide WCS into tokens separated by characters in DELIM.  */
 206 extern wchar_t *wcstok (wchar_t *__restrict __s,
 207                         __const wchar_t *__restrict __delim,
 208                         wchar_t **__restrict __ptr) __THROW;
 209
 210 /* Return the number of wide characters in S.  */
 211 extern size_t __wcslen (__const wchar_t *__s) __THROW;
 212 extern size_t wcslen (__const wchar_t *__s) __THROW;
 213
 214 #ifdef __USE_GNU
 215 /* Return the number of wide characters in S, but at most MAXLEN.  */
 216 extern size_t wcsnlen (__const wchar_t *__s, size_t __maxlen) __THROW;
 217 #endif
 218
 219
 220 /* Search N wide characters of S for C.  */
 221 extern wchar_t *wmemchr (__const wchar_t *__s, wchar_t __c, size_t __n)
 222      __THROW;
 223
 224 /* Compare N wide characters of S1 and S2.  */
 225 extern int wmemcmp (__const wchar_t *__restrict __s1,
 226                     __const wchar_t *__restrict __s2, size_t __n) __THROW;
 227
 228 /* Copy N wide characters of SRC to DEST.  */
 229 extern wchar_t *wmemcpy (wchar_t *__restrict __s1,
 230                          __const wchar_t *__restrict __s2, size_t __n) __THROW;
 231
 232 /* Copy N wide characters of SRC to DEST, guaranteeing
 233    correct behavior for overlapping strings.  */
 234 extern wchar_t *wmemmove (wchar_t *__s1, __const wchar_t *__s2, size_t __n)
 235      __THROW;
 236
 237 /* Set N wide characters of S to C.  */
 238 extern wchar_t *wmemset (wchar_t *__s, wchar_t __c, size_t __n) __THROW;
 239
 240 #ifdef __USE_GNU
 241 /* Copy N wide characters of SRC to DEST and return pointer to following
 242    wide character.  */
 243 extern wchar_t *wmempcpy (wchar_t *__restrict __s1,
 244                           __const wchar_t *__restrict __s2, size_t __n)
 245      __THROW;
 246 #endif
 247
 248
 249 /* Determine whether C constitutes a valid (one-byte) multibyte
 250    character.  */
 251 extern wint_t btowc (int __c) __THROW;
 252
 253 /* Determine whether C corresponds to a member of the extended
 254    character set whose multibyte representation is a single byte.  */
 255 extern int wctob (wint_t __c) __THROW;
 256
 257 /* Determine whether PS points to an object representing the initial
 258    state.  */
 259 extern int mbsinit (__const mbstate_t *__ps) __THROW;
 260
 261 /* Write wide character representation of multibyte character pointed
 262    to by S to PWC.  */
 263 extern size_t mbrtowc (wchar_t *__restrict __pwc,
 264                        __const char *__restrict __s, size_t __n,
 265                        mbstate_t *__p) __THROW;
 266
 267 /* Write multibyte representation of wide character WC to S.  */
 268 extern size_t wcrtomb (char *__restrict __s, wchar_t __wc,
 269                        mbstate_t *__restrict __ps) __THROW;
 270
 271 /* Return number of bytes in multibyte character pointed to by S.  */
 272 extern size_t __mbrlen (__const char *__restrict __s, size_t __n,
 273                         mbstate_t *__restrict __ps) __THROW;
 274 extern size_t mbrlen (__const char *__restrict __s, size_t __n,
 275                       mbstate_t *__restrict __ps) __THROW;
 276
 277 #if defined __OPTIMIZE__ && !defined __OPTIMIZE_SIZE__ \
 278     && defined __USE_EXTERN_INLINES
 279 /* Define inline function as optimization.  */
 280 extern __inline size_t mbrlen (__const char *__restrict __s, size_t __n,
 281                                mbstate_t *__restrict __ps) __THROW
 282 { return (__ps != NULL
 283           ? mbrtowc (NULL, __s, __n, __ps) : __mbrlen (__s, __n, NULL)); }
 284 #endif
 285
 286 /* Write wide character representation of multibyte character string
 287    SRC to DST.  */
 288 extern size_t mbsrtowcs (wchar_t *__restrict __dst,
 289                          __const char **__restrict __src, size_t __len,
 290                          mbstate_t *__restrict __ps) __THROW;
 291
 292 /* Write multibyte character representation of wide character string
 293    SRC to DST.  */
 294 extern size_t wcsrtombs (char *__restrict __dst,
 295                          __const wchar_t **__restrict __src, size_t __len,
 296                          mbstate_t *__restrict __ps) __THROW;
 297
 298
 299 #ifdef  __USE_GNU
 300 /* Write wide character representation of at most NMC bytes of the
 301    multibyte character string SRC to DST.  */
 302 extern size_t mbsnrtowcs (wchar_t *__restrict __dst,
 303                           __const char **__restrict __src, size_t __nmc,
 304                           size_t __len, mbstate_t *__restrict __ps) __THROW;
 305
 306 /* Write multibyte character representation of at most NWC characters
 307    from the wide character string SRC to DST.  */
 308 extern size_t wcsnrtombs (char *__restrict __dst,
 309                           __const wchar_t **__restrict __src,
 310                           size_t __nwc, size_t __len,
 311                           mbstate_t *__restrict __ps) __THROW;
 312 #endif  /* use GNU */
 313
 314
 315 /* The following functions are extensions found in X/Open CAE.  */
 316 #ifdef __USE_XOPEN
 317 /* Determine number of column positions required for C.  */
 318 extern int wcwidth (wint_t __c) __THROW;
 319
 320 /* Determine number of column positions required for first N wide
 321    characters (or fewer if S ends before this) in S.  */
 322 extern int wcswidth (__const wchar_t *__s, size_t __n) __THROW;
 323 #endif  /* Use X/Open.  */
 324
 325
 326 /* Convert initial portion of the wide string NPTR to `double'
 327    representation.  */
 328 extern double wcstod (__const wchar_t *__restrict __nptr,
 329                       wchar_t **__restrict __endptr) __THROW;
 330
 331 #ifdef __USE_ISOC99
 332 /* Likewise for `float' and `long double' sizes of floating-point numbers.  */
 333 extern float wcstof (__const wchar_t *__restrict __nptr,
 334                      wchar_t **__restrict __endptr) __THROW;
 335 extern long double wcstold (__const wchar_t *__restrict __nptr,
 336                             wchar_t **__restrict __endptr) __THROW;
 337 #endif /* C9x */
 338
 339
 340 /* Convert initial portion of wide string NPTR to `long int'
 341    representation.  */
 342 extern long int wcstol (__const wchar_t *__restrict __nptr,
 343                         wchar_t **__restrict __endptr, int __base) __THROW;
 344
 345 /* Convert initial portion of wide string NPTR to `unsigned long int'
 346    representation.  */
 347 extern unsigned long int wcstoul (__const wchar_t *__restrict __nptr,
 348                                   wchar_t **__restrict __endptr, int __base)
 349      __THROW;
 350
 351 #if defined __GNUC__ && defined __USE_GNU
 352 /* Convert initial portion of wide string NPTR to `long int'
 353    representation.  */
 354 __extension__
 355 extern long long int wcstoq (__const wchar_t *__restrict __nptr,
 356                              wchar_t **__restrict __endptr, int __base)
 357      __THROW;
 358
 359 /* Convert initial portion of wide string NPTR to `unsigned long long int'
 360    representation.  */
 361 __extension__
 362 extern unsigned long long int wcstouq (__const wchar_t *__restrict __nptr,
 363                                        wchar_t **__restrict __endptr,
 364                                        int __base) __THROW;
 365 #endif /* GCC and use GNU.  */
 366
 367 #if defined __USE_ISOC99 || (defined __GNUC__ && defined __USE_GNU)
 368 /* Convert initial portion of wide string NPTR to `long int'
 369    representation.  */
 370 __extension__
 371 extern long long int wcstoll (__const wchar_t *__restrict __nptr,
 372                               wchar_t **__restrict __endptr, int __base)
 373      __THROW;
 374
 375 /* Convert initial portion of wide string NPTR to `unsigned long long int'
 376    representation.  */
 377 __extension__
 378 extern unsigned long long int wcstoull (__const wchar_t *__restrict __nptr,
 379                                         wchar_t **__restrict __endptr,
 380                                         int __base) __THROW;
 381 #endif /* ISO C99 or GCC and GNU.  */
 382
 383 #ifdef __USE_GNU
 384 /* The concept of one static locale per category is not very well
 385    thought out.  Many applications will need to process its data using
 386    information from several different locales.  Another application is
 387    the implementation of the internationalization handling in the
 388    upcoming ISO C++ standard library.  To support this another set of
 389    the functions using locale data exist which have an additional
 390    argument.
 391
 392    Attention: all these functions are *not* standardized in any form.
 393    This is a proof-of-concept implementation.  */
 394
 395 /* Structure for reentrant locale using functions.  This is an
 396    (almost) opaque type for the user level programs.  */
 397 # include <xlocale.h>
 398
 399 /* Special versions of the functions above which take the locale to
 400    use as an additional parameter.  */
 401 extern long int __wcstol_l (__const wchar_t *__restrict __nptr,
 402                             wchar_t **__restrict __endptr, int __base,
 403                             __locale_t __loc) __THROW;
 404
 405 extern unsigned long int __wcstoul_l (__const wchar_t *__restrict __nptr,
 406                                       wchar_t **__restrict __endptr,
 407                                       int __base, __locale_t __loc) __THROW;
 408
 409 __extension__
 410 extern long long int __wcstoll_l (__const wchar_t *__restrict __nptr,
 411                                   wchar_t **__restrict __endptr,
 412                                   int __base, __locale_t __loc) __THROW;
 413
 414 __extension__
 415 extern unsigned long long int __wcstoull_l (__const wchar_t *__restrict __nptr,
 416                                             wchar_t **__restrict __endptr,
 417                                             int __base, __locale_t __loc)
 418      __THROW;
 419
 420 extern double __wcstod_l (__const wchar_t *__restrict __nptr,
 421                           wchar_t **__restrict __endptr, __locale_t __loc)
 422      __THROW;
 423
 424 extern float __wcstof_l (__const wchar_t *__restrict __nptr,
 425                          wchar_t **__restrict __endptr, __locale_t __loc)
 426      __THROW;
 427
 428 extern long double __wcstold_l (__const wchar_t *__restrict __nptr,
 429                                 wchar_t **__restrict __endptr,
 430                                 __locale_t __loc) __THROW;
 431 #endif /* GNU */
 432
 433
 434 /* The internal entry points for `wcstoX' take an extra flag argument
 435    saying whether or not to parse locale-dependent number grouping.  */
 436 extern double __wcstod_internal (__const wchar_t *__restrict __nptr,
 437                                  wchar_t **__restrict __endptr, int __group)
 438      __THROW;
 439 extern float __wcstof_internal (__const wchar_t *__restrict __nptr,
 440                                 wchar_t **__restrict __endptr, int __group)
 441      __THROW;
 442 extern long double __wcstold_internal (__const wchar_t *__restrict __nptr,
 443                                        wchar_t **__restrict __endptr,
 444                                        int __group) __THROW;
 445
 446 #ifndef __wcstol_internal_defined
 447 extern long int __wcstol_internal (__const wchar_t *__restrict __nptr,
 448                                    wchar_t **__restrict __endptr,
 449                                    int __base, int __group) __THROW;
 450 # define __wcstol_internal_defined      1
 451 #endif
 452 #ifndef __wcstoul_internal_defined
 453 extern unsigned long int __wcstoul_internal (__const wchar_t *__restrict __npt,
 454                                              wchar_t **__restrict __endptr,
 455                                              int __base, int __group) __THROW;
 456 # define __wcstoul_internal_defined     1
 457 #endif
 458 #ifndef __wcstoll_internal_defined
 459 __extension__
 460 extern long long int __wcstoll_internal (__const wchar_t *__restrict __nptr,
 461                                          wchar_t **__restrict __endptr,
 462                                          int __base, int __group) __THROW;
 463 # define __wcstoll_internal_defined     1
 464 #endif
 465 #ifndef __wcstoull_internal_defined
 466 __extension__
 467 extern unsigned long long int __wcstoull_internal (__const wchar_t *
 468                                                    __restrict __nptr,
 469                                                    wchar_t **
 470                                                    __restrict __endptr,
 471                                                    int __base,
 472                                                    int __group) __THROW;
 473 # define __wcstoull_internal_defined    1
 474 #endif
 475
 476
 477 #if defined __OPTIMIZE__ && __GNUC__ >= 2
 478 /* Define inline functions which call the internal entry points.  */
 479
 480 extern __inline double wcstod (__const wchar_t *__restrict __nptr,
 481                                wchar_t **__restrict __endptr) __THROW
 482 { return __wcstod_internal (__nptr, __endptr, 0); }
 483 extern __inline long int wcstol (__const wchar_t *__restrict __nptr,
 484                                  wchar_t **__restrict __endptr,
 485                                  int __base) __THROW
 486 { return __wcstol_internal (__nptr, __endptr, __base, 0); }
 487 extern __inline unsigned long int wcstoul (__const wchar_t *__restrict __nptr,
 488                                            wchar_t **__restrict __endptr,
 489                                            int __base) __THROW
 490 { return __wcstoul_internal (__nptr, __endptr, __base, 0); }
 491
 492 # ifdef __USE_GNU
 493 extern __inline float wcstof (__const wchar_t *__restrict __nptr,
 494                               wchar_t **__restrict __endptr) __THROW
 495 { return __wcstof_internal (__nptr, __endptr, 0); }
 496 extern __inline long double wcstold (__const wchar_t *__restrict __nptr,
 497                                      wchar_t **__restrict __endptr) __THROW
 498 { return __wcstold_internal (__nptr, __endptr, 0); }
 499
 500
 501 __extension__
 502 extern __inline long long int wcstoq (__const wchar_t *__restrict __nptr,
 503                                       wchar_t **__restrict __endptr,
 504                                       int __base) __THROW
 505 { return __wcstoll_internal (__nptr, __endptr, __base, 0); }
 506 __extension__
 507 extern __inline unsigned long long int wcstouq (__const wchar_t *
 508                                                 __restrict __nptr,
 509                                                 wchar_t **__restrict __endptr,
 510                                                 int __base) __THROW
 511 { return __wcstoull_internal (__nptr, __endptr, __base, 0); }
 512 # endif /* Use GNU.  */
 513 #endif /* Optimizing GCC >=2.  */
 514
 515
 516 #ifdef  __USE_GNU
 517 /* Copy SRC to DEST, returning the address of the terminating L'\0' in
 518    DEST.  */
 519 extern wchar_t *wcpcpy (wchar_t *__dest, __const wchar_t *__src) __THROW;
 520
 521 /* Copy no more than N characters of SRC to DEST, returning the address of
 522    the last character written into DEST.  */
 523 extern wchar_t *wcpncpy (wchar_t *__dest, __const wchar_t *__src, size_t __n)
 524      __THROW;
 525 #endif  /* use GNU */
 526
 527
 528 /* Wide character I/O functions.  */
 529 #ifdef __USE_ISOC99
 530
 531 /* Select orientation for stream.  */
 532 extern int fwide (FILE *__fp, int __mode) __THROW;
 533
 534
 535 /* Write formatted output to STREAM.  */
 536 extern int fwprintf (FILE *__restrict __stream,
 537                      __const wchar_t *__restrict __format, ...)
 538      __THROW /* __attribute__ ((__format__ (__wprintf__, 2, 3))) */;
 539 /* Write formatted output to stdout.  */
 540 extern int wprintf (__const wchar_t *__restrict __format, ...)
 541      __THROW /* __attribute__ ((__format__ (__wprintf__, 1, 2))) */;
 542 /* Write formatted output of at most N characters to S.  */
 543 extern int swprintf (wchar_t *__restrict __s, size_t __n,
 544                      __const wchar_t *__restrict __format, ...)
 545      __THROW /* __attribute__ ((__format__ (__wprintf__, 3, 4))) */;
 546
 547 /* Write formatted output to S from argument list ARG.  */
 548 extern int vfwprintf (FILE *__restrict __s,
 549                       __const wchar_t *__restrict __format,
 550                       __gnuc_va_list __arg)
 551      __THROW /* __attribute__ ((__format__ (__wprintf__, 2, 0))) */;
 552 /* Write formatted output to stdout from argument list ARG.  */
 553 extern int vwprintf (__const wchar_t *__restrict __format,
 554                      __gnuc_va_list __arg)
 555      __THROW /* __attribute__ ((__format__ (__wprintf__, 1, 0))) */;
 556 /* Write formatted output of at most N character to S from argument
 557    list ARG.  */
 558 extern int vswprintf (wchar_t *__restrict __s, size_t __n,
 559                       __const wchar_t *__restrict __format,
 560                       __gnuc_va_list __arg)
 561      __THROW /* __attribute__ ((__format__ (__wprintf__, 3, 0))) */;
 562
 563
 564 /* Read formatted input from STREAM.  */
 565 extern int fwscanf (FILE *__restrict __stream,
 566                     __const wchar_t *__restrict __format, ...)
 567      __THROW /* __attribute__ ((__format__ (__wscanf__, 2, 3))) */;
 568 /* Read formatted input from stdin.  */
 569 extern int wscanf (__const wchar_t *__restrict __format, ...)
 570      __THROW /* __attribute__ ((__format__ (__wscanf__, 1, 2))) */;
 571 /* Read formatted input from S.  */
 572 extern int swscanf (__const wchar_t *__restrict __s,
 573                     __const wchar_t *__restrict __format, ...)
 574      __THROW /* __attribute__ ((__format__ (__wscanf__, 2, 3))) */;
 575
 576 /* Read formatted input from S into argument list ARG.  */
 577 extern int vfwscanf (FILE *__restrict __s,
 578                      __const wchar_t *__restrict __format,
 579                      __gnuc_va_list __arg)
 580      __THROW /* __attribute__ ((__format__ (__wscanf__, 2, 0))) */;
 581 /* Read formatted input from stdin into argument list ARG.  */
 582 extern int vwscanf (__const wchar_t *__restrict __format,
 583                     __gnuc_va_list __arg)
 584      __THROW /* __attribute__ ((__format__ (__wscanf__, 1, 0))) */;
 585 /* Read formatted input from S into argument list ARG.  */
 586 extern int vswscanf (__const wchar_t *__restrict __s,
 587                      __const wchar_t *__restrict __format,
 588                      __gnuc_va_list __arg)
 589      __THROW /* __attribute__ ((__format__ (__wscanf__, 2, 0))) */;
 590
 591
 592 /* Read a character from STREAM.  */
 593 extern wint_t fgetwc (FILE *__stream);
 594 extern wint_t getwc (FILE *__stream);
 595
 596 /* Read a character from stdin.  */
 597 extern wint_t getwchar (void);
 598
 599 #ifdef __USE_GNU
 600 /* These are defined to be equivalent to the `char' functions defined
 601    in POSIX.1:1996.  */
 602 extern wint_t getwc_unlocked (FILE *__stream);
 603 extern wint_t getwchar_unlocked (void);
 604
 605 /* This is the wide character version of a GNU extension.  */
 606 extern wint_t fgetwc_unlocked (FILE *__stream);
 607 #endif /* Use POSIX or MISC.  */
 608
 609
 610 /* Write a character to STREAM.  */
 611 extern wint_t fputwc (wchar_t __wc, FILE *__stream);
 612 extern wint_t putwc (wchar_t __wc, FILE *__stream);
 613
 614 /* Write a character to stdout.  */
 615 extern wint_t putwchar (wchar_t __wc);
 616
 617 #ifdef __USE_GNU
 618 /* Faster version when locking is not necessary.  */
 619 extern wint_t fputwc_unlocked (wchar_t __wc, FILE *__stream);
 620
 621 /* These are defined to be equivalent to the `char' functions defined
 622    in POSIX.1:1996.  */
 623 extern wint_t putwc_unlocked (wchar_t __wc, FILE *__stream);
 624 extern wint_t putwchar_unlocked (wchar_t __wc);
 625 #endif
 626
 627
 628 /* Get a newline-terminated wide character string of finite length
 629    from STREAM.  */
 630 extern wchar_t *fgetws (wchar_t *__restrict __ws, int __n,
 631                         FILE *__restrict __stream);
 632
 633 #ifdef __USE_GNU
 634 /* This function does the same as `fgetws' but does not lock the stream.  */
 635 extern wchar_t *fgetws_unlocked (wchar_t *__restrict __ws, int __n,
 636                                  FILE *__restrict __stream);
 637 #endif
 638
 639
 640 /* Write a string to STREAM.  */
 641 extern int fputws (__const wchar_t *__restrict __ws,
 642                    FILE *__restrict __stream);
 643
 644 #ifdef __USE_GNU
 645 /* This function does the same as `fputws' but does not lock the stream.  */
 646 extern int fputws_unlocked (__const wchar_t *__restrict __ws,
 647                             FILE *__restrict __stream);
 648 #endif
 649
 650
 651 /* Push a character back onto the input buffer of STREAM.  */
 652 extern wint_t ungetwc (wint_t __wc, FILE *__stream);
 653
 654
 655 /* Format TP into S according to FORMAT.
 656    Write no more than MAXSIZE wide characters and return the number
 657    of wide characters written, or 0 if it would exceed MAXSIZE.  */
 658 extern size_t wcsftime (wchar_t *__restrict __s, size_t __maxsize,
 659                         __const wchar_t *__restrict __format,
 660                         __const struct tm *__restrict __tp);
 661 #endif /* Use ISO C9x. */
 662
 663 /* The X/Open standard demands that most of the functions defined in
 664    the <wctype.h> header must also appear here.  This is probably
 665    because some X/Open members wrote their implementation before the
 666    ISO C standard was published and introduced the better solution.
 667    We have to provide these definitions for compliance reasons but we
 668    do this nonsense only if really necessary.  */
 669 #if defined __USE_UNIX98 && !defined __USE_GNU
 670 # define __need_iswxxx
 671 # include <wctype.h>
 672 #endif
 673
 674 __END_DECLS
 675
 676 #endif  /* _WCHAR_H defined */
 677
 678 #endif /* wchar.h  */