blob: 267158058858f191a2c5da22b586794ce80d734b [file] [log] [blame]
The Android Open Source Project1dc9e472009-03-03 19:28:35 -08001/*
2 * Copyright (C) 2008 The Android Open Source Project
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 * * Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * * Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in
12 * the documentation and/or other materials provided with the
13 * distribution.
14 *
15 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
16 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
17 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
18 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
19 * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
20 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
21 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
22 * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
23 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
24 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
25 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26 * SUCH DAMAGE.
27 */
Elliott Hughesff26a162017-08-17 22:34:21 +000028
The Android Open Source Project1dc9e472009-03-03 19:28:35 -080029#ifndef _WCHAR_H_
30#define _WCHAR_H_
31
32#include <sys/cdefs.h>
33#include <stdio.h>
34
The Android Open Source Project1dc9e472009-03-03 19:28:35 -080035#include <stdarg.h>
Elliott Hughes0cc0d252012-10-01 15:12:40 -070036#include <stddef.h>
The Android Open Source Project1dc9e472009-03-03 19:28:35 -080037#include <time.h>
Elliott Hughesb20c2442014-11-06 15:04:08 -080038#include <xlocale.h>
Elliott Hughes83c07b52014-04-21 18:09:46 -070039
Elliott Hughes0fe88852016-07-27 10:45:05 -070040#include <bits/mbstate_t.h>
Elliott Hughes5704c422016-01-25 18:06:24 -080041#include <bits/wchar_limits.h>
Elliott Hughes7ba106c2016-04-28 18:22:06 -070042#include <bits/wctype.h>
The Android Open Source Project1dc9e472009-03-03 19:28:35 -080043
The Android Open Source Project1dc9e472009-03-03 19:28:35 -080044__BEGIN_DECLS
45
Elliott Hughesff26a162017-08-17 22:34:21 +000046wint_t btowc(int __ch);
zijunzhao7ce2f952023-04-03 23:13:57 +000047int fwprintf(FILE* _Nonnull __fp, const wchar_t* _Nonnull __fmt, ...);
48int fwscanf(FILE* _Nonnull __fp, const wchar_t* _Nonnull __fmt, ...);
49wint_t fgetwc(FILE* _Nonnull __fp);
50wchar_t* _Nullable fgetws(wchar_t* _Nonnull __buf, int __size, FILE* _Nonnull __fp);
51wint_t fputwc(wchar_t __wc, FILE* _Nonnull __fp);
52int fputws(const wchar_t* _Nonnull __s, FILE* _Nonnull __fp);
53int fwide(FILE* _Nonnull __fp, int __mode);
54wint_t getwc(FILE* _Nonnull __fp);
Elliott Hughesff26a162017-08-17 22:34:21 +000055wint_t getwchar(void);
zijunzhao7ce2f952023-04-03 23:13:57 +000056int mbsinit(const mbstate_t* _Nullable __ps);
57size_t mbrlen(const char* _Nullable __s, size_t __n, mbstate_t* _Nullable __ps);
58size_t mbrtowc(wchar_t* _Nullable __buf, const char* _Nullable __s, size_t __n, mbstate_t* _Nullable __ps);
59size_t mbsrtowcs(wchar_t* _Nullable __dst, const char* _Nullable * _Nonnull __src, size_t __dst_n, mbstate_t* _Nullable __ps);
Elliott Hughes2bd43162023-06-15 13:17:08 -070060size_t mbsrtowcs_l(wchar_t* _Nullable __dst, const char* _Nullable * _Nonnull __src, size_t __dst_n, mbstate_t* _Nullable __ps, locale_t _Nonnull __l) __INTRODUCED_IN(35);
Elliott Hughes655e4302023-06-16 12:39:33 -070061size_t mbsnrtowcs(wchar_t* _Nullable __dst, const char* _Nullable * _Nullable __src, size_t __src_n, size_t __dst_n, mbstate_t* _Nullable __ps);
zijunzhao7ce2f952023-04-03 23:13:57 +000062wint_t putwc(wchar_t __wc, FILE* _Nonnull __fp);
Elliott Hughesff26a162017-08-17 22:34:21 +000063wint_t putwchar(wchar_t __wc);
zijunzhao7ce2f952023-04-03 23:13:57 +000064int swprintf(wchar_t* _Nonnull __buf, size_t __n, const wchar_t* _Nonnull __fmt, ...);
65int swscanf(const wchar_t* _Nonnull __s, const wchar_t* _Nonnull __fmt, ...);
66wint_t ungetwc(wint_t __wc, FILE* _Nonnull __fp);
67int vfwprintf(FILE* _Nonnull __fp, const wchar_t* _Nonnull __fmt, va_list __args);
Elliott Hughes655e4302023-06-16 12:39:33 -070068int vfwscanf(FILE* _Nonnull __fp, const wchar_t* _Nonnull __fmt, va_list __args);
zijunzhao7ce2f952023-04-03 23:13:57 +000069int vswprintf(wchar_t* _Nonnull __buf, size_t __n, const wchar_t* _Nonnull __fmt, va_list __args);
Elliott Hughes655e4302023-06-16 12:39:33 -070070int vswscanf(const wchar_t* _Nonnull __s, const wchar_t* _Nonnull __fmt, va_list __args);
zijunzhao7ce2f952023-04-03 23:13:57 +000071int vwprintf(const wchar_t* _Nonnull __fmt, va_list __args);
Elliott Hughes655e4302023-06-16 12:39:33 -070072int vwscanf(const wchar_t* _Nonnull __fmt, va_list __args);
zijunzhao7ce2f952023-04-03 23:13:57 +000073wchar_t* _Nonnull wcpcpy(wchar_t* _Nonnull __dst, const wchar_t* _Nonnull __src);
74wchar_t* _Nonnull wcpncpy(wchar_t* _Nonnull __dst, const wchar_t* _Nonnull __src, size_t __n);
75size_t wcrtomb(char* _Nullable __buf, wchar_t __wc, mbstate_t* _Nullable __ps);
76int wcscasecmp(const wchar_t* _Nonnull __lhs, const wchar_t* _Nonnull __rhs);
77int wcscasecmp_l(const wchar_t* _Nonnull __lhs, const wchar_t* _Nonnull __rhs, locale_t _Nonnull __l) __INTRODUCED_IN(23);
78wchar_t* _Nonnull wcscat(wchar_t* _Nonnull __dst, const wchar_t* _Nonnull __src);
79wchar_t* _Nullable wcschr(const wchar_t * _Nonnull __s, wchar_t __wc);
80int wcscmp(const wchar_t* _Nonnull __lhs, const wchar_t* _Nonnull __rhs);
81int wcscoll(const wchar_t* _Nonnull __lhs, const wchar_t* _Nonnull __rhs);
82wchar_t* _Nonnull wcscpy(wchar_t* _Nonnull __dst, const wchar_t* _Nonnull __src);
83size_t wcscspn(const wchar_t* _Nonnull __s, const wchar_t* _Nonnull __accept);
84size_t wcsftime(wchar_t* _Nonnull __buf, size_t __n, const wchar_t* _Nullable __fmt, const struct tm* _Nonnull __tm);
85size_t wcsftime_l(wchar_t* _Nonnull __buf, size_t __n, const wchar_t* _Nullable __fmt, const struct tm* _Nonnull __tm, locale_t _Nonnull __l) __INTRODUCED_IN(28);
86size_t wcslen(const wchar_t* _Nonnull __s);
87int wcsncasecmp(const wchar_t* _Nonnull __lhs, const wchar_t* _Nonnull __rhs, size_t __n);
88int wcsncasecmp_l(const wchar_t* _Nonnull __lhs, const wchar_t* _Nonnull __rhs, size_t __n, locale_t _Nonnull __l) __INTRODUCED_IN(23);
89wchar_t* _Nonnull wcsncat(wchar_t* _Nonnull __dst, const wchar_t* _Nonnull __src, size_t __n);
90int wcsncmp(const wchar_t* _Nonnull __lhs, const wchar_t* _Nonnull __rhs, size_t __n);
91wchar_t* _Nonnull wcsncpy(wchar_t* _Nonnull __dst, const wchar_t* _Nonnull __src, size_t __n);
Elliott Hughes655e4302023-06-16 12:39:33 -070092size_t wcsnrtombs(char* _Nullable __dst, const wchar_t* __BIONIC_COMPLICATED_NULLNESS * _Nullable __src, size_t __src_n, size_t __dst_n, mbstate_t* _Nullable __ps);
zijunzhao7ce2f952023-04-03 23:13:57 +000093wchar_t* _Nullable wcspbrk(const wchar_t* _Nonnull __s, const wchar_t* _Nonnull __accept);
94wchar_t* _Nullable wcsrchr(const wchar_t* _Nonnull __s, wchar_t __wc);
95size_t wcsrtombs(char* _Nullable __dst, const wchar_t* __BIONIC_COMPLICATED_NULLNESS * _Nullable __src, size_t __dst_n, mbstate_t* _Nullable __ps);
Elliott Hughes2bd43162023-06-15 13:17:08 -070096size_t wcsrtombs_l(char* _Nullable __dst, const wchar_t* __BIONIC_COMPLICATED_NULLNESS * _Nullable __src, size_t __dst_n, mbstate_t* _Nullable __ps, locale_t _Nonnull __l) __INTRODUCED_IN(35);
zijunzhao7ce2f952023-04-03 23:13:57 +000097size_t wcsspn(const wchar_t* _Nonnull __s, const wchar_t* _Nonnull __accept);
98wchar_t* _Nullable wcsstr(const wchar_t* _Nonnull __haystack, const wchar_t* _Nonnull __needle);
99double wcstod(const wchar_t* _Nonnull __s, wchar_t* __BIONIC_COMPLICATED_NULLNESS * _Nullable __end_ptr);
100double wcstod_l(const wchar_t* _Nonnull __s, wchar_t* __BIONIC_COMPLICATED_NULLNESS * _Nullable __end_ptr, locale_t _Nonnull __l) __INTRODUCED_IN(28);
Elliott Hughes655e4302023-06-16 12:39:33 -0700101float wcstof(const wchar_t* _Nonnull __s, wchar_t* __BIONIC_COMPLICATED_NULLNESS * _Nullable __end_ptr);
zijunzhao7ce2f952023-04-03 23:13:57 +0000102float wcstof_l(const wchar_t* _Nonnull __s, wchar_t* __BIONIC_COMPLICATED_NULLNESS * _Nullable __end_ptr, locale_t _Nonnull __l) __INTRODUCED_IN(28);
103wchar_t* _Nullable wcstok(wchar_t* _Nullable __s, const wchar_t* _Nonnull __delimiter, wchar_t* _Nonnull * _Nonnull __ptr);
104long wcstol(const wchar_t* _Nonnull __s, wchar_t* __BIONIC_COMPLICATED_NULLNESS * _Nullable __end_ptr, int __base);
105long wcstol_l(const wchar_t* _Nonnull __s, wchar_t* __BIONIC_COMPLICATED_NULLNESS * _Nullable __end_ptr, int __base, locale_t _Nonnull __l) __INTRODUCED_IN(28);
Elliott Hughes655e4302023-06-16 12:39:33 -0700106long long wcstoll(const wchar_t* _Nonnull __s, wchar_t* __BIONIC_COMPLICATED_NULLNESS * _Nullable __end_ptr, int __base);
107long double wcstold(const wchar_t* _Nonnull __s, wchar_t* __BIONIC_COMPLICATED_NULLNESS * _Nullable __end_ptr);
zijunzhao7ce2f952023-04-03 23:13:57 +0000108unsigned long wcstoul(const wchar_t* _Nonnull __s, wchar_t* __BIONIC_COMPLICATED_NULLNESS * _Nullable __end_ptr, int __base);
109unsigned long wcstoul_l(const wchar_t* _Nonnull __s, wchar_t* __BIONIC_COMPLICATED_NULLNESS * _Nullable __end_ptr, int __base, locale_t _Nonnull __l) __INTRODUCED_IN(28);
Elliott Hughes655e4302023-06-16 12:39:33 -0700110unsigned long long wcstoull(const wchar_t* _Nonnull __s, wchar_t* __BIONIC_COMPLICATED_NULLNESS * _Nullable __end_ptr, int __base);
zijunzhao7ce2f952023-04-03 23:13:57 +0000111int wcswidth(const wchar_t* _Nonnull __s, size_t __n);
112size_t wcsxfrm(wchar_t* __BIONIC_COMPLICATED_NULLNESS __dst, const wchar_t* _Nonnull __src, size_t __n);
Elliott Hughesff26a162017-08-17 22:34:21 +0000113int wctob(wint_t __wc);
114int wcwidth(wchar_t __wc);
zijunzhao7ce2f952023-04-03 23:13:57 +0000115wchar_t* _Nullable wmemchr(const wchar_t* _Nonnull __src, wchar_t __wc, size_t __n);
116int wmemcmp(const wchar_t* _Nullable __lhs, const wchar_t* _Nullable __rhs, size_t __n);
117wchar_t* _Nonnull wmemcpy(wchar_t* _Nonnull __dst, const wchar_t* _Nonnull __src, size_t __n);
Elliott Hughes3cfb52a2015-02-18 21:29:13 -0800118#if defined(__USE_GNU)
zijunzhao7ce2f952023-04-03 23:13:57 +0000119wchar_t* _Nonnull wmempcpy(wchar_t* _Nonnull __dst, const wchar_t* _Nonnull __src, size_t __n) __INTRODUCED_IN(23);
Elliott Hughes3cfb52a2015-02-18 21:29:13 -0800120#endif
zijunzhao7ce2f952023-04-03 23:13:57 +0000121wchar_t* _Nonnull wmemmove(wchar_t* _Nonnull __dst, const wchar_t* _Nonnull __src, size_t __n);
122wchar_t* _Nonnull wmemset(wchar_t* _Nonnull __dst, wchar_t __wc, size_t __n);
123int wprintf(const wchar_t* _Nonnull __fmt, ...);
124int wscanf(const wchar_t* _Nonnull __fmt, ...);
The Android Open Source Project1dc9e472009-03-03 19:28:35 -0800125
Elliott Hughes655e4302023-06-16 12:39:33 -0700126long long wcstoll_l(const wchar_t* _Nonnull __s, wchar_t* _Nullable * _Nullable __end_ptr, int __base, locale_t _Nonnull __l);
127unsigned long long wcstoull_l(const wchar_t* _Nonnull __s, wchar_t* _Nullable * _Nullable __end_ptr, int __base, locale_t _Nonnull __l);
128long double wcstold_l(const wchar_t* _Nonnull __s, wchar_t* _Nullable * _Nullable __end_ptr, locale_t _Nonnull __l);
Dan Albertdfb5ce42014-07-09 22:51:34 +0000129
Elliott Hughes655e4302023-06-16 12:39:33 -0700130int wcscoll_l(const wchar_t* _Nonnull __lhs, const wchar_t* _Nonnull __rhs, locale_t _Nonnull __l) __attribute_pure__;
131size_t wcsxfrm_l(wchar_t* __BIONIC_COMPLICATED_NULLNESS __dst, const wchar_t* _Nonnull __src, size_t __n, locale_t _Nonnull __l);
zijunzhao7ce2f952023-04-03 23:13:57 +0000132size_t wcslcat(wchar_t* _Nonnull __dst, const wchar_t* _Nonnull __src, size_t __n);
133size_t wcslcpy(wchar_t* _Nonnull __dst, const wchar_t* _Nonnull __src, size_t __n);
Dan Albertdfb5ce42014-07-09 22:51:34 +0000134
zijunzhao7ce2f952023-04-03 23:13:57 +0000135FILE* _Nullable open_wmemstream(wchar_t* _Nonnull * _Nonnull __ptr, size_t* _Nonnull __size_ptr) __INTRODUCED_IN(23);
136wchar_t* _Nullable wcsdup(const wchar_t* _Nonnull __s);
137size_t wcsnlen(const wchar_t* _Nonnull __s, size_t __n);
Elliott Hugheseb93ebf2013-03-01 18:35:56 -0800138
The Android Open Source Project1dc9e472009-03-03 19:28:35 -0800139__END_DECLS
140
Elliott Hughesff26a162017-08-17 22:34:21 +0000141#endif