lh | 9ed821d | 2023-04-07 01:36:19 -0700 | [diff] [blame^] | 1 | /* 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 |
| 64 | typedef 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 |
| 71 | typedef __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 |
| 81 | typedef struct |
| 82 | { |
| 83 | wchar_t __mask; |
| 84 | wchar_t __wc; |
| 85 | } __mbstate_t; |
| 86 | #else |
| 87 | typedef 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. */ |
| 107 | typedef __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'. */ |
| 135 | struct 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. */ |
| 145 | extern 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. */ |
| 148 | extern wchar_t *wcsncpy (wchar_t *__restrict __dest, |
| 149 | __const wchar_t *__restrict __src, size_t __n) |
| 150 | __THROW; |
| 151 | |
| 152 | /* Append SRC onto DEST. */ |
| 153 | extern wchar_t *wcscat (wchar_t *__restrict __dest, |
| 154 | __const wchar_t *__restrict __src) __THROW; |
| 155 | libc_hidden_proto(wcscat) |
| 156 | /* Append no more than N wide-characters of SRC onto DEST. */ |
| 157 | extern wchar_t *wcsncat (wchar_t *__restrict __dest, |
| 158 | __const wchar_t *__restrict __src, size_t __n) |
| 159 | __THROW; |
| 160 | |
| 161 | /* Compare S1 and S2. */ |
| 162 | extern int wcscmp (__const wchar_t *__s1, __const wchar_t *__s2) |
| 163 | __THROW __attribute_pure__; |
| 164 | libc_hidden_proto(wcscmp) |
| 165 | /* Compare N wide-characters of S1 and S2. */ |
| 166 | extern 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. */ |
| 172 | extern 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. */ |
| 175 | extern 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 | |
| 183 | extern int wcscasecmp_l (__const wchar_t *__s1, __const wchar_t *__s2, |
| 184 | __locale_t __loc) __THROW; |
| 185 | libc_hidden_proto(wcscasecmp_l) |
| 186 | |
| 187 | extern int wcsncasecmp_l (__const wchar_t *__s1, __const wchar_t *__s2, |
| 188 | size_t __n, __locale_t __loc) __THROW; |
| 189 | libc_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. */ |
| 196 | extern int wcscoll (__const wchar_t *__s1, __const wchar_t *__s2) __THROW; |
| 197 | libc_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. */ |
| 201 | extern 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. */ |
| 212 | extern int wcscoll_l (__const wchar_t *__s1, __const wchar_t *__s2, |
| 213 | __locale_t __loc) __THROW; |
| 214 | libc_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. */ |
| 219 | extern size_t wcsxfrm_l (wchar_t *__s1, __const wchar_t *__s2, |
| 220 | size_t __n, __locale_t __loc) __THROW; |
| 221 | libc_hidden_proto(wcsxfrm_l) |
| 222 | |
| 223 | #endif /* __UCLIBC_HAS_XLOCALE__ */ |
| 224 | |
| 225 | /* Duplicate S, returning an identical malloc'd string. */ |
| 226 | extern 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. */ |
| 231 | extern wchar_t *wcschr (__const wchar_t *__wcs, wchar_t __wc) |
| 232 | __THROW __attribute_pure__; |
| 233 | /* Find the last occurrence of WC in WCS. */ |
| 234 | extern 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. */ |
| 241 | extern 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. */ |
| 248 | extern 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. */ |
| 252 | extern size_t wcsspn (__const wchar_t *__wcs, __const wchar_t *__accept) |
| 253 | __THROW __attribute_pure__; |
| 254 | libc_hidden_proto(wcsspn) |
| 255 | /* Find the first occurrence in WCS of any character in ACCEPT. */ |
| 256 | extern wchar_t *wcspbrk (__const wchar_t *__wcs, __const wchar_t *__accept) |
| 257 | __THROW __attribute_pure__; |
| 258 | libc_hidden_proto(wcspbrk) |
| 259 | /* Find the first occurrence of NEEDLE in HAYSTACK. */ |
| 260 | extern 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. */ |
| 264 | extern 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. */ |
| 269 | extern size_t wcslen (__const wchar_t *__s) __THROW __attribute_pure__; |
| 270 | libc_hidden_proto(wcslen) |
| 271 | __END_NAMESPACE_C99 |
| 272 | |
| 273 | #if defined __USE_XOPEN && defined __UCLIBC_SUSV3_LEGACY__ |
| 274 | /* Another name for `wcsstr' from XPG4. */ |
| 275 | extern 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. */ |
| 281 | extern size_t wcsnlen (__const wchar_t *__s, size_t __maxlen) |
| 282 | __THROW __attribute_pure__; |
| 283 | libc_hidden_proto(wcsnlen) |
| 284 | #endif |
| 285 | |
| 286 | |
| 287 | __BEGIN_NAMESPACE_C99 |
| 288 | /* Search N wide characters of S for C. */ |
| 289 | extern wchar_t *wmemchr (__const wchar_t *__s, wchar_t __c, size_t __n) |
| 290 | __THROW __attribute_pure__; |
| 291 | libc_hidden_proto(wmemchr) |
| 292 | |
| 293 | /* Compare N wide characters of S1 and S2. */ |
| 294 | extern 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. */ |
| 299 | extern wchar_t *wmemcpy (wchar_t *__restrict __s1, |
| 300 | __const wchar_t *__restrict __s2, size_t __n) __THROW; |
| 301 | libc_hidden_proto(wmemcpy) |
| 302 | |
| 303 | /* Copy N wide characters of SRC to DEST, guaranteeing |
| 304 | correct behavior for overlapping strings. */ |
| 305 | extern 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. */ |
| 309 | extern 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. */ |
| 315 | extern wchar_t *wmempcpy (wchar_t *__restrict __s1, |
| 316 | __const wchar_t *__restrict __s2, size_t __n) |
| 317 | __THROW; |
| 318 | libc_hidden_proto(wmempcpy) |
| 319 | #endif |
| 320 | |
| 321 | |
| 322 | __BEGIN_NAMESPACE_C99 |
| 323 | /* Determine whether C constitutes a valid (one-byte) multibyte |
| 324 | character. */ |
| 325 | extern wint_t btowc (int __c) __THROW; |
| 326 | libc_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. */ |
| 330 | extern int wctob (wint_t __c) __THROW; |
| 331 | |
| 332 | /* Determine whether PS points to an object representing the initial |
| 333 | state. */ |
| 334 | extern int mbsinit (__const mbstate_t *__ps) __THROW __attribute_pure__; |
| 335 | libc_hidden_proto(mbsinit) |
| 336 | |
| 337 | /* Write wide character representation of multibyte character pointed |
| 338 | to by S to PWC. */ |
| 339 | extern size_t mbrtowc (wchar_t *__restrict __pwc, |
| 340 | __const char *__restrict __s, size_t __n, |
| 341 | mbstate_t *__p) __THROW; |
| 342 | libc_hidden_proto(mbrtowc) |
| 343 | |
| 344 | /* Write multibyte representation of wide character WC to S. */ |
| 345 | extern size_t wcrtomb (char *__restrict __s, wchar_t __wc, |
| 346 | mbstate_t *__restrict __ps) __THROW; |
| 347 | libc_hidden_proto(wcrtomb) |
| 348 | |
| 349 | /* Return number of bytes in multibyte character pointed to by S. */ |
| 350 | #if 0 /* uClibc: disabled */ |
| 351 | extern size_t __mbrlen (__const char *__restrict __s, size_t __n, |
| 352 | mbstate_t *__restrict __ps) __THROW; |
| 353 | #endif |
| 354 | extern size_t mbrlen (__const char *__restrict __s, size_t __n, |
| 355 | mbstate_t *__restrict __ps) __THROW; |
| 356 | libc_hidden_proto(mbrlen) |
| 357 | |
| 358 | /* Write wide character representation of multibyte character string |
| 359 | SRC to DST. */ |
| 360 | extern size_t mbsrtowcs (wchar_t *__restrict __dst, |
| 361 | __const char **__restrict __src, size_t __len, |
| 362 | mbstate_t *__restrict __ps) __THROW; |
| 363 | libc_hidden_proto(mbsrtowcs) |
| 364 | |
| 365 | /* Write multibyte character representation of wide character string |
| 366 | SRC to DST. */ |
| 367 | extern size_t wcsrtombs (char *__restrict __dst, |
| 368 | __const wchar_t **__restrict __src, size_t __len, |
| 369 | mbstate_t *__restrict __ps) __THROW; |
| 370 | libc_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. */ |
| 377 | extern size_t mbsnrtowcs (wchar_t *__restrict __dst, |
| 378 | __const char **__restrict __src, size_t __nmc, |
| 379 | size_t __len, mbstate_t *__restrict __ps) __THROW; |
| 380 | libc_hidden_proto(mbsnrtowcs) |
| 381 | |
| 382 | /* Write multibyte character representation of at most NWC characters |
| 383 | from the wide character string SRC to DST. */ |
| 384 | extern 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; |
| 388 | libc_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. */ |
| 395 | extern 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. */ |
| 399 | extern int wcswidth (__const wchar_t *__s, size_t __n) __THROW; |
| 400 | libc_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. */ |
| 408 | extern 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. */ |
| 413 | extern float wcstof (__const wchar_t *__restrict __nptr, |
| 414 | wchar_t **__restrict __endptr) __THROW; |
| 415 | extern 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. */ |
| 423 | extern 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. */ |
| 428 | extern 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__ |
| 436 | extern 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__ |
| 443 | extern 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__ |
| 453 | extern 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__ |
| 460 | extern 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. */ |
| 484 | extern long int wcstol_l (__const wchar_t *__restrict __nptr, |
| 485 | wchar_t **__restrict __endptr, int __base, |
| 486 | __locale_t __loc) __THROW; |
| 487 | |
| 488 | extern 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__ |
| 493 | extern 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__ |
| 498 | extern 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__ |
| 504 | extern double wcstod_l (__const wchar_t *__restrict __nptr, |
| 505 | wchar_t **__restrict __endptr, __locale_t __loc) |
| 506 | __THROW; |
| 507 | |
| 508 | extern float wcstof_l (__const wchar_t *__restrict __nptr, |
| 509 | wchar_t **__restrict __endptr, __locale_t __loc) |
| 510 | __THROW; |
| 511 | |
| 512 | extern 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. */ |
| 523 | extern 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. */ |
| 527 | extern 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. */ |
| 537 | extern 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. */ |
| 544 | extern 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. */ |
| 551 | extern int wprintf (__const wchar_t *__restrict __format, ...) |
| 552 | /* __attribute__ ((__format__ (__wprintf__, 1, 2))) */; |
| 553 | /* Write formatted output of at most N characters to S. */ |
| 554 | extern 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. */ |
| 562 | extern int vfwprintf (__FILE *__restrict __s, |
| 563 | __const wchar_t *__restrict __format, |
| 564 | __gnuc_va_list __arg) |
| 565 | /* __attribute__ ((__format__ (__wprintf__, 2, 0))) */; |
| 566 | libc_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. */ |
| 571 | extern 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. */ |
| 576 | extern 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))) */; |
| 580 | libc_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. */ |
| 587 | extern 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. */ |
| 594 | extern int wscanf (__const wchar_t *__restrict __format, ...) |
| 595 | /* __attribute__ ((__format__ (__wscanf__, 1, 2))) */; |
| 596 | /* Read formatted input from S. */ |
| 597 | extern 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. */ |
| 611 | extern int vfwscanf (__FILE *__restrict __s, |
| 612 | __const wchar_t *__restrict __format, |
| 613 | __gnuc_va_list __arg) |
| 614 | /* __attribute__ ((__format__ (__wscanf__, 2, 0))) */; |
| 615 | libc_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. */ |
| 620 | extern 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. */ |
| 624 | extern 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))) */; |
| 628 | libc_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. */ |
| 639 | extern wint_t fgetwc (__FILE *__stream); |
| 640 | libc_hidden_proto(fgetwc) |
| 641 | extern 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. */ |
| 647 | extern 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. */ |
| 654 | extern wint_t fputwc (wchar_t __wc, __FILE *__stream); |
| 655 | extern 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. */ |
| 661 | extern 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. */ |
| 669 | extern 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. */ |
| 676 | extern int fputws (__const wchar_t *__restrict __ws, |
| 677 | __FILE *__restrict __stream); |
| 678 | libc_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. */ |
| 685 | extern wint_t ungetwc (wint_t __wc, __FILE *__stream); |
| 686 | libc_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. */ |
| 698 | extern wint_t getwc_unlocked (__FILE *__stream); |
| 699 | extern 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. */ |
| 707 | extern wint_t fgetwc_unlocked (__FILE *__stream); |
| 708 | libc_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. */ |
| 716 | extern wint_t fputwc_unlocked (wchar_t __wc, __FILE *__stream); |
| 717 | libc_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. */ |
| 726 | extern wint_t putwc_unlocked (wchar_t __wc, __FILE *__stream); |
| 727 | extern 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. */ |
| 736 | extern wchar_t *fgetws_unlocked (wchar_t *__restrict __ws, int __n, |
| 737 | __FILE *__restrict __stream); |
| 738 | libc_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. */ |
| 746 | extern int fputws_unlocked (__const wchar_t *__restrict __ws, |
| 747 | __FILE *__restrict __stream); |
| 748 | libc_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. */ |
| 756 | extern 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. */ |
| 766 | extern 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; |
| 770 | libc_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 |
| 785 | extern 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 */ |