Annotation of src/include/wchar.h, Revision 1.25
1.25 ! martynas 1: /* $OpenBSD: wchar.h,v 1.24 2013/03/28 16:37:14 eric Exp $ */
1.1 espie 2: /* $NetBSD: wchar.h,v 1.16 2003/03/07 07:11:35 tshiozak Exp $ */
3:
4: /*-
5: * Copyright (c)1999 Citrus Project,
6: * All rights reserved.
7: *
8: * Redistribution and use in source and binary forms, with or without
9: * modification, are permitted provided that the following conditions
10: * are met:
11: * 1. Redistributions of source code must retain the above copyright
12: * notice, this list of conditions and the following disclaimer.
13: * 2. Redistributions in binary form must reproduce the above copyright
14: * notice, this list of conditions and the following disclaimer in the
15: * documentation and/or other materials provided with the distribution.
16: *
17: * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
18: * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20: * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
21: * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22: * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23: * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24: * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25: * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26: * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27: * SUCH DAMAGE.
28: */
29:
30: /*-
31: * Copyright (c) 1999, 2000 The NetBSD Foundation, Inc.
32: * All rights reserved.
33: *
34: * This code is derived from software contributed to The NetBSD Foundation
35: * by Julian Coleman.
36: *
37: * Redistribution and use in source and binary forms, with or without
38: * modification, are permitted provided that the following conditions
39: * are met:
40: * 1. Redistributions of source code must retain the above copyright
41: * notice, this list of conditions and the following disclaimer.
42: * 2. Redistributions in binary form must reproduce the above copyright
43: * notice, this list of conditions and the following disclaimer in the
44: * documentation and/or other materials provided with the distribution.
45: *
46: * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
47: * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
48: * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
49: * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
50: * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
51: * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
52: * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
53: * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
54: * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
55: * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
56: * POSSIBILITY OF SUCH DAMAGE.
57: */
58:
59: #ifndef _WCHAR_H_
60: #define _WCHAR_H_
61:
62: #include <sys/cdefs.h>
1.8 millert 63: #include <sys/_types.h>
1.1 espie 64:
65: #ifndef NULL
66: #ifdef __GNUG__
67: #define NULL __null
1.18 jsg 68: #elif defined(__cplusplus)
69: #define NULL 0L
1.1 espie 70: #else
1.12 miod 71: #define NULL ((void *)0)
1.1 espie 72: #endif
73: #endif
74:
75: #include <stdio.h> /* for FILE* */
76:
1.8 millert 77: #if !defined(_WCHAR_T_DEFINED_) && !defined(__cplusplus)
78: #define _WCHAR_T_DEFINED_
79: typedef __wchar_t wchar_t;
1.1 espie 80: #endif
81:
1.8 millert 82: #ifndef _MBSTATE_T_DEFINED_
83: #define _MBSTATE_T_DEFINED_
84: typedef __mbstate_t mbstate_t;
1.2 espie 85: #endif
86:
1.8 millert 87: #ifndef _WINT_T_DEFINED_
88: #define _WINT_T_DEFINED_
89: typedef __wint_t wint_t;
1.1 espie 90: #endif
91:
1.8 millert 92: #ifndef _SIZE_T_DEFINED_
93: #define _SIZE_T_DEFINED_
94: typedef __size_t size_t;
1.1 espie 95: #endif
96:
1.22 kettenis 97: #ifndef WEOF
1.1 espie 98: #define WEOF ((wint_t)-1)
1.22 kettenis 99: #endif
100:
101: #ifndef WCHAR_MIN
102: #define WCHAR_MIN (-0x7fffffff - 1)
103: #endif
104: #ifndef WCHAR_MAX
105: #define WCHAR_MAX 0x7fffffff
1.1 espie 106: #endif
107:
108: __BEGIN_DECLS
1.2 espie 109: wint_t btowc(int);
110: size_t mbrlen(const char * __restrict, size_t, mbstate_t * __restrict);
111: size_t mbrtowc(wchar_t * __restrict, const char * __restrict, size_t,
112: mbstate_t * __restrict);
113: int mbsinit(const mbstate_t *);
114: size_t mbsrtowcs(wchar_t * __restrict, const char ** __restrict, size_t,
1.25 ! martynas 115: mbstate_t * __restrict)
! 116: __attribute__ ((__bounded__(__wcstring__,1,3)));
1.2 espie 117: size_t wcrtomb(char * __restrict, wchar_t, mbstate_t * __restrict);
1.1 espie 118: wchar_t *wcscat(wchar_t * __restrict, const wchar_t * __restrict);
119: wchar_t *wcschr(const wchar_t *, wchar_t);
120: int wcscmp(const wchar_t *, const wchar_t *);
121: int wcscoll(const wchar_t *, const wchar_t *);
122: wchar_t *wcscpy(wchar_t * __restrict, const wchar_t * __restrict);
123: size_t wcscspn(const wchar_t *, const wchar_t *);
124: size_t wcslen(const wchar_t *);
125: wchar_t *wcsncat(wchar_t * __restrict, const wchar_t * __restrict,
1.25 ! martynas 126: size_t)
! 127: __attribute__ ((__bounded__(__wcstring__,1,3)));
1.1 espie 128: int wcsncmp(const wchar_t *, const wchar_t *, size_t);
129: wchar_t *wcsncpy(wchar_t * __restrict , const wchar_t * __restrict,
1.25 ! martynas 130: size_t)
! 131: __attribute__ ((__bounded__(__wcstring__,1,3)));
1.1 espie 132: wchar_t *wcspbrk(const wchar_t *, const wchar_t *);
133: wchar_t *wcsrchr(const wchar_t *, wchar_t);
1.2 espie 134: size_t wcsrtombs(char * __restrict, const wchar_t ** __restrict, size_t,
1.25 ! martynas 135: mbstate_t * __restrict)
! 136: __attribute__ ((__bounded__(__wcstring__,1,3)));
1.1 espie 137: size_t wcsspn(const wchar_t *, const wchar_t *);
138: wchar_t *wcsstr(const wchar_t *, const wchar_t *);
139: wchar_t *wcstok(wchar_t * __restrict, const wchar_t * __restrict,
140: wchar_t ** __restrict);
1.6 espie 141: size_t wcsxfrm(wchar_t *, const wchar_t *, size_t);
1.1 espie 142: wchar_t *wcswcs(const wchar_t *, const wchar_t *);
143: wchar_t *wmemchr(const wchar_t *, wchar_t, size_t);
144: int wmemcmp(const wchar_t *, const wchar_t *, size_t);
145: wchar_t *wmemcpy(wchar_t * __restrict, const wchar_t * __restrict,
1.25 ! martynas 146: size_t)
! 147: __attribute__ ((__bounded__(__wcstring__,1,3)))
! 148: __attribute__ ((__bounded__(__wcstring__,2,3)));
! 149: wchar_t *wmemmove(wchar_t *, const wchar_t *, size_t)
! 150: __attribute__ ((__bounded__(__wcstring__,1,3)))
! 151: __attribute__ ((__bounded__(__wcstring__,2,3)));
! 152: wchar_t *wmemset(wchar_t *, wchar_t, size_t)
! 153: __attribute__ ((__bounded__(__wcstring__,1,3)));
! 154:
! 155: size_t wcslcat(wchar_t *, const wchar_t *, size_t)
! 156: __attribute__ ((__bounded__(__wcstring__,1,3)));
! 157: size_t wcslcpy(wchar_t *, const wchar_t *, size_t)
! 158: __attribute__ ((__bounded__(__wcstring__,1,3)));
1.6 espie 159: int wcswidth(const wchar_t *, size_t);
1.2 espie 160: int wctob(wint_t);
1.6 espie 161: int wcwidth(wchar_t);
162:
163: double wcstod(const wchar_t * __restrict, wchar_t ** __restrict);
164: long int wcstol(const wchar_t * __restrict, wchar_t ** __restrict, int base);
165: unsigned long int wcstoul(const wchar_t * __restrict, wchar_t ** __restrict,
166: int base);
1.16 espie 167:
1.17 millert 168: #if __POSIX_VISIBLE >= 200809
1.24 eric 169: FILE *open_wmemstream(wchar_t **, size_t *);
170:
1.19 nicm 171: wchar_t *wcsdup(const wchar_t *);
1.16 espie 172: int wcscasecmp(const wchar_t *, const wchar_t *);
173: int wcsncasecmp(const wchar_t *, const wchar_t *, size_t);
1.23 matthew 174:
175: size_t mbsnrtowcs(wchar_t * __restrict, const char ** __restrict, size_t,
1.25 ! martynas 176: size_t, mbstate_t * __restrict)
! 177: __attribute__ ((__bounded__(__wcstring__,1,4)));
1.23 matthew 178: size_t wcsnrtombs(char * __restrict, const wchar_t ** __restrict, size_t,
1.25 ! martynas 179: size_t, mbstate_t * __restrict)
! 180: __attribute__ ((__bounded__(__wcstring__,1,4)));
1.16 espie 181: #endif
1.10 kettenis 182:
183: #if __ISO_C_VISIBLE >= 1999
184: float wcstof(const wchar_t * __restrict, wchar_t ** __restrict);
185: long double wcstold(const wchar_t * __restrict, wchar_t ** __restrict);
1.21 stsp 186: size_t wcsftime(wchar_t * __restrict, size_t, const wchar_t *__restrict,
187: const struct tm *__restrict);
1.10 kettenis 188: #endif
1.6 espie 189:
1.7 millert 190: #if (defined(__GNUC__) && __GNUC__ >= 2 && !defined(__STRICT_ANSI__)) || \
191: __ISO_C_VISIBLE >= 1999
1.6 espie 192: /* LONGLONG */
193: long long int wcstoll(const wchar_t * __restrict,
194: wchar_t ** __restrict, int base);
195: /* LONGLONG */
196: unsigned long long int wcstoull(const wchar_t * __restrict,
197: wchar_t ** __restrict, int base);
198: #endif
1.4 espie 199:
200: wint_t ungetwc(wint_t, FILE *);
201: wint_t fgetwc(FILE *);
1.25 ! martynas 202: wchar_t *fgetws(wchar_t * __restrict, int, FILE * __restrict)
! 203: __attribute__ ((__bounded__(__wcstring__,1,2)));
1.4 espie 204: wint_t getwc(FILE *);
205: wint_t getwchar(void);
206: wint_t fputwc(wchar_t, FILE *);
207: int fputws(const wchar_t * __restrict, FILE * __restrict);
208: wint_t putwc(wchar_t, FILE *);
209: wint_t putwchar(wchar_t);
210:
211: int fwide(FILE *, int);
1.15 stsp 212:
213: int fwprintf(FILE * __restrict, const wchar_t * __restrict, ...);
214: int swprintf(wchar_t * __restrict, size_t, const wchar_t * __restrict, ...);
215: int vfwprintf(FILE * __restrict, const wchar_t * __restrict, __va_list);
216: int vswprintf(wchar_t * __restrict, size_t, const wchar_t * __restrict,
217: __va_list);
218: int vwprintf(const wchar_t * __restrict, __va_list);
219: int wprintf(const wchar_t * __restrict, ...);
1.20 stsp 220:
221: int fwscanf(FILE * __restrict, const wchar_t * __restrict, ...);
222: int swscanf(const wchar_t * __restrict, const wchar_t * __restrict, ...);
223: int vfwscanf(FILE * __restrict, const wchar_t * __restrict, __va_list);
224: int vswscanf(const wchar_t * __restrict, const wchar_t * __restrict, __va_list);
225: int vwscanf(const wchar_t * __restrict, __va_list);
226: int wscanf(const wchar_t * __restrict, ...);
1.13 stsp 227:
1.4 espie 228: #define getwc(f) fgetwc(f)
229: #define getwchar() getwc(stdin)
230: #define putwc(wc, f) fputwc((wc), (f))
231: #define putwchar(wc) putwc((wc), stdout)
1.1 espie 232: __END_DECLS
233:
234: #endif /* !_WCHAR_H_ */