]> git.saurik.com Git - apple/libc.git/blame - include/wchar.h
Libc-1158.1.2.tar.gz
[apple/libc.git] / include / wchar.h
CommitLineData
9385eb3d
A
1/*-
2 * Copyright (c)1999 Citrus 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 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
13 *
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24 * SUCH DAMAGE.
25 *
26 * $FreeBSD: /repoman/r/ncvs/src/include/wchar.h,v 1.34 2003/03/13 06:29:53 tjr Exp $
27 */
28
29/*-
30 * Copyright (c) 1999, 2000 The NetBSD Foundation, Inc.
31 * All rights reserved.
32 *
33 * This code is derived from software contributed to The NetBSD Foundation
34 * by Julian Coleman.
35 *
36 * Redistribution and use in source and binary forms, with or without
37 * modification, are permitted provided that the following conditions
38 * are met:
39 * 1. Redistributions of source code must retain the above copyright
40 * notice, this list of conditions and the following disclaimer.
41 * 2. Redistributions in binary form must reproduce the above copyright
42 * notice, this list of conditions and the following disclaimer in the
43 * documentation and/or other materials provided with the distribution.
44 * 3. All advertising materials mentioning features or use of this software
45 * must display the following acknowledgement:
46 * This product includes software developed by the NetBSD
47 * Foundation, Inc. and its contributors.
48 * 4. Neither the name of The NetBSD Foundation nor the names of its
49 * contributors may be used to endorse or promote products derived
50 * from this software without specific prior written permission.
51 *
52 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
53 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
54 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
55 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
56 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
57 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
58 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
59 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
60 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
61 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
62 * POSSIBILITY OF SUCH DAMAGE.
63 *
64 * $NetBSD: wchar.h,v 1.8 2000/12/22 05:31:42 itojun Exp $
65 */
66
67#ifndef _WCHAR_H_
68#define _WCHAR_H_
69
59e0d9fe 70#include <_types.h>
1f2f436a
A
71#include <sys/cdefs.h>
72#include <Availability.h>
9385eb3d 73
6465356a
A
74#include <sys/_types/_null.h>
75#include <sys/_types/_size_t.h>
76#include <sys/_types/_mbstate_t.h>
77#include <sys/_types/_ct_rune_t.h>
78#include <sys/_types/_rune_t.h>
79#include <sys/_types/_wchar_t.h>
9385eb3d 80
9385eb3d 81#ifndef WCHAR_MIN
3d9156a7 82#define WCHAR_MIN __DARWIN_WCHAR_MIN
9385eb3d
A
83#endif
84
85#ifndef WCHAR_MAX
3d9156a7 86#define WCHAR_MAX __DARWIN_WCHAR_MAX
9385eb3d
A
87#endif
88
3d9156a7
A
89#include <stdarg.h>
90#include <stdio.h>
91#include <time.h>
92#include <_wctype.h>
93
1f2f436a
A
94
95/* Initially added in Issue 4 */
9385eb3d
A
96__BEGIN_DECLS
97wint_t btowc(int);
59e0d9fe
A
98wint_t fgetwc(FILE *);
99wchar_t *fgetws(wchar_t * __restrict, int, FILE * __restrict);
100wint_t fputwc(wchar_t, FILE *);
101int fputws(const wchar_t * __restrict, FILE * __restrict);
102int fwide(FILE *, int);
ad3c9f2a
A
103int fwprintf(FILE * __restrict, const wchar_t * __restrict, ...);
104int fwscanf(FILE * __restrict, const wchar_t * __restrict, ...);
59e0d9fe 105wint_t getwc(FILE *);
9385eb3d
A
106wint_t getwchar(void);
107size_t mbrlen(const char * __restrict, size_t, mbstate_t * __restrict);
108size_t mbrtowc(wchar_t * __restrict, const char * __restrict, size_t,
109 mbstate_t * __restrict);
110int mbsinit(const mbstate_t *);
111size_t mbsrtowcs(wchar_t * __restrict, const char ** __restrict, size_t,
112 mbstate_t * __restrict);
59e0d9fe 113wint_t putwc(wchar_t, FILE *);
9385eb3d 114wint_t putwchar(wchar_t);
ad3c9f2a
A
115int swprintf(wchar_t * __restrict, size_t, const wchar_t * __restrict, ...);
116int swscanf(const wchar_t * __restrict, const wchar_t * __restrict, ...);
59e0d9fe
A
117wint_t ungetwc(wint_t, FILE *);
118int vfwprintf(FILE * __restrict, const wchar_t * __restrict,
ad3c9f2a 119 __darwin_va_list);
224c7076 120int vswprintf(wchar_t * __restrict, size_t, const wchar_t * __restrict,
ad3c9f2a
A
121 __darwin_va_list);
122int vwprintf(const wchar_t * __restrict, __darwin_va_list);
9385eb3d
A
123size_t wcrtomb(char * __restrict, wchar_t, mbstate_t * __restrict);
124wchar_t *wcscat(wchar_t * __restrict, const wchar_t * __restrict);
125wchar_t *wcschr(const wchar_t *, wchar_t);
126int wcscmp(const wchar_t *, const wchar_t *);
127int wcscoll(const wchar_t *, const wchar_t *);
128wchar_t *wcscpy(wchar_t * __restrict, const wchar_t * __restrict);
129size_t wcscspn(const wchar_t *, const wchar_t *);
224c7076
A
130//Begin-Libc
131#ifndef LIBC_ALIAS_WCSFTIME
132//End-Libc
9385eb3d 133size_t wcsftime(wchar_t * __restrict, size_t, const wchar_t * __restrict,
224c7076
A
134 const struct tm * __restrict) __DARWIN_ALIAS(wcsftime);
135//Begin-Libc
136#else /* LIBC_ALIAS_WCSFTIME */
137size_t wcsftime(wchar_t * __restrict, size_t, const wchar_t * __restrict,
138 const struct tm * __restrict) LIBC_ALIAS(wcsftime);
139#endif /* !LIBC_ALIAS_WCSFTIME */
140//End-Libc
9385eb3d
A
141size_t wcslen(const wchar_t *);
142wchar_t *wcsncat(wchar_t * __restrict, const wchar_t * __restrict, size_t);
143int wcsncmp(const wchar_t *, const wchar_t *, size_t);
144wchar_t *wcsncpy(wchar_t * __restrict , const wchar_t * __restrict, size_t);
145wchar_t *wcspbrk(const wchar_t *, const wchar_t *);
146wchar_t *wcsrchr(const wchar_t *, wchar_t);
147size_t wcsrtombs(char * __restrict, const wchar_t ** __restrict, size_t,
148 mbstate_t * __restrict);
149size_t wcsspn(const wchar_t *, const wchar_t *);
150wchar_t *wcsstr(const wchar_t * __restrict, const wchar_t * __restrict);
151size_t wcsxfrm(wchar_t * __restrict, const wchar_t * __restrict, size_t);
152int wctob(wint_t);
153double wcstod(const wchar_t * __restrict, wchar_t ** __restrict);
154wchar_t *wcstok(wchar_t * __restrict, const wchar_t * __restrict,
155 wchar_t ** __restrict);
156long wcstol(const wchar_t * __restrict, wchar_t ** __restrict, int);
157unsigned long
158 wcstoul(const wchar_t * __restrict, wchar_t ** __restrict, int);
159wchar_t *wmemchr(const wchar_t *, wchar_t, size_t);
160int wmemcmp(const wchar_t *, const wchar_t *, size_t);
161wchar_t *wmemcpy(wchar_t * __restrict, const wchar_t * __restrict, size_t);
162wchar_t *wmemmove(wchar_t *, const wchar_t *, size_t);
163wchar_t *wmemset(wchar_t *, wchar_t, size_t);
ad3c9f2a
A
164int wprintf(const wchar_t * __restrict, ...);
165int wscanf(const wchar_t * __restrict, ...);
1f2f436a
A
166int wcswidth(const wchar_t *, size_t);
167int wcwidth(wchar_t);
168__END_DECLS
169
170
171
172/* Additional functionality provided by:
173 * POSIX.1-2001
174 * ISO C99
175 */
9385eb3d 176
1f2f436a
A
177#if __DARWIN_C_LEVEL >= 200112L || defined(_C99_SOURCE) || defined(__cplusplus)
178__BEGIN_DECLS
59e0d9fe 179int vfwscanf(FILE * __restrict, const wchar_t * __restrict,
ad3c9f2a 180 __darwin_va_list);
9385eb3d 181int vswscanf(const wchar_t * __restrict, const wchar_t * __restrict,
ad3c9f2a
A
182 __darwin_va_list);
183int vwscanf(const wchar_t * __restrict, __darwin_va_list);
9385eb3d
A
184float wcstof(const wchar_t * __restrict, wchar_t ** __restrict);
185long double
ad3c9f2a 186 wcstold(const wchar_t * __restrict, wchar_t ** __restrict);
3d9156a7 187#if !__DARWIN_NO_LONG_LONG
9385eb3d
A
188long long
189 wcstoll(const wchar_t * __restrict, wchar_t ** __restrict, int);
190unsigned long long
191 wcstoull(const wchar_t * __restrict, wchar_t ** __restrict, int);
3d9156a7 192#endif /* !__DARWIN_NO_LONG_LONG */
1f2f436a
A
193__END_DECLS
194#endif
195
3d9156a7 196
1f2f436a
A
197
198/* Additional functionality provided by:
199 * POSIX.1-2008
200 */
201
202#if __DARWIN_C_LEVEL >= 200809L
203__BEGIN_DECLS
204size_t mbsnrtowcs(wchar_t * __restrict, const char ** __restrict, size_t,
205 size_t, mbstate_t * __restrict);
206wchar_t *wcpcpy(wchar_t * __restrict, const wchar_t * __restrict) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
207wchar_t *wcpncpy(wchar_t * __restrict, const wchar_t * __restrict, size_t) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
208wchar_t *wcsdup(const wchar_t *) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
209int wcscasecmp(const wchar_t *, const wchar_t *) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
210int wcsncasecmp(const wchar_t *, const wchar_t *, size_t n) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
211size_t wcsnlen(const wchar_t *, size_t) __pure __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
212size_t wcsnrtombs(char * __restrict, const wchar_t ** __restrict, size_t,
213 size_t, mbstate_t * __restrict);
214__END_DECLS
215#endif /* __DARWIN_C_LEVEL >= 200809L */
216
217
218
219/* Darwin extensions */
220
221#if __DARWIN_C_LEVEL >= __DARWIN_C_FULL
222__BEGIN_DECLS
223wchar_t *fgetwln(FILE * __restrict, size_t *) __OSX_AVAILABLE_STARTING(__MAC_10_7, __IPHONE_4_3);
9385eb3d
A
224size_t wcslcat(wchar_t *, const wchar_t *, size_t);
225size_t wcslcpy(wchar_t *, const wchar_t *, size_t);
1f2f436a
A
226__END_DECLS
227#endif /* __DARWIN_C_LEVEL >= __DARWIN_C_FULL */
228
224c7076
A
229
230/* Poison the following routines if -fshort-wchar is set */
231#if !defined(__cplusplus) && defined(__WCHAR_MAX__) && __WCHAR_MAX__ <= 0xffffU
1f2f436a 232#pragma GCC poison fgetwln fgetws fputwc fputws fwprintf fwscanf mbrtowc mbsnrtowcs mbsrtowcs putwc putwchar swprintf swscanf vfwprintf vfwscanf vswprintf vswscanf vwprintf vwscanf wcrtomb wcscat wcschr wcscmp wcscoll wcscpy wcscspn wcsftime wcsftime wcslcat wcslcpy wcslen wcsncat wcsncmp wcsncpy wcsnrtombs wcspbrk wcsrchr wcsrtombs wcsspn wcsstr wcstod wcstof wcstok wcstol wcstold wcstoll wcstoul wcstoull wcswidth wcsxfrm wcwidth wmemchr wmemcmp wmemcpy wmemmove wmemset wprintf wscanf
224c7076 233#endif
9385eb3d 234
3d9156a7
A
235#ifdef _USE_EXTENDED_LOCALES_
236#include <xlocale/_wchar.h>
237#endif /* _USE_EXTENDED_LOCALES_ */
238
9385eb3d 239#endif /* !_WCHAR_H_ */