xref: /freebsd/contrib/llvm-project/libcxx/include/cwchar (revision 700637cbb5e582861067a11aaca4d053546871d2)
1// -*- C++ -*-
2//===----------------------------------------------------------------------===//
3//
4// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
5// See https://llvm.org/LICENSE.txt for license information.
6// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
7//
8//===----------------------------------------------------------------------===//
9
10#ifndef _LIBCPP_CWCHAR
11#define _LIBCPP_CWCHAR
12
13/*
14    cwchar synopsis
15
16Macros:
17
18    NULL
19    WCHAR_MAX
20    WCHAR_MIN
21    WEOF
22
23namespace std
24{
25
26Types:
27
28    mbstate_t
29    size_t
30    tm
31    wint_t
32
33int fwprintf(FILE* restrict stream, const wchar_t* restrict format, ...);
34int fwscanf(FILE* restrict stream, const wchar_t* restrict format, ...);
35int swprintf(wchar_t* restrict s, size_t n, const wchar_t* restrict format, ...);
36int swscanf(const wchar_t* restrict s, const wchar_t* restrict format, ...);
37int vfwprintf(FILE* restrict stream, const wchar_t* restrict format, va_list arg);
38int vfwscanf(FILE* restrict stream, const wchar_t* restrict format, va_list arg);  // C99
39int vswprintf(wchar_t* restrict s, size_t n, const wchar_t* restrict format, va_list arg);
40int vswscanf(const wchar_t* restrict s, const wchar_t* restrict format, va_list arg);  // C99
41int vwprintf(const wchar_t* restrict format, va_list arg);
42int vwscanf(const wchar_t* restrict format, va_list arg);  // C99
43int wprintf(const wchar_t* restrict format, ...);
44int wscanf(const wchar_t* restrict format, ...);
45wint_t fgetwc(FILE* stream);
46wchar_t* fgetws(wchar_t* restrict s, int n, FILE* restrict stream);
47wint_t fputwc(wchar_t c, FILE* stream);
48int fputws(const wchar_t* restrict s, FILE* restrict stream);
49int fwide(FILE* stream, int mode);
50wint_t getwc(FILE* stream);
51wint_t getwchar();
52wint_t putwc(wchar_t c, FILE* stream);
53wint_t putwchar(wchar_t c);
54wint_t ungetwc(wint_t c, FILE* stream);
55double wcstod(const wchar_t* restrict nptr, wchar_t** restrict endptr);
56float wcstof(const wchar_t* restrict nptr, wchar_t** restrict endptr);         // C99
57long double wcstold(const wchar_t* restrict nptr, wchar_t** restrict endptr);  // C99
58long wcstol(const wchar_t* restrict nptr, wchar_t** restrict endptr, int base);
59long long wcstoll(const wchar_t* restrict nptr, wchar_t** restrict endptr, int base);  // C99
60unsigned long wcstoul(const wchar_t* restrict nptr, wchar_t** restrict endptr, int base);
61unsigned long long wcstoull(const wchar_t* restrict nptr, wchar_t** restrict endptr, int base);  // C99
62wchar_t* wcscpy(wchar_t* restrict s1, const wchar_t* restrict s2);
63wchar_t* wcsncpy(wchar_t* restrict s1, const wchar_t* restrict s2, size_t n);
64wchar_t* wcscat(wchar_t* restrict s1, const wchar_t* restrict s2);
65wchar_t* wcsncat(wchar_t* restrict s1, const wchar_t* restrict s2, size_t n);
66int wcscmp(const wchar_t* s1, const wchar_t* s2);
67int wcscoll(const wchar_t* s1, const wchar_t* s2);
68int wcsncmp(const wchar_t* s1, const wchar_t* s2, size_t n);
69size_t wcsxfrm(wchar_t* restrict s1, const wchar_t* restrict s2, size_t n);
70const wchar_t* wcschr(const wchar_t* s, wchar_t c);
71      wchar_t* wcschr(      wchar_t* s, wchar_t c);
72size_t wcscspn(const wchar_t* s1, const wchar_t* s2);
73size_t wcslen(const wchar_t* s);
74const wchar_t* wcspbrk(const wchar_t* s1, const wchar_t* s2);
75      wchar_t* wcspbrk(      wchar_t* s1, const wchar_t* s2);
76const wchar_t* wcsrchr(const wchar_t* s, wchar_t c);
77      wchar_t* wcsrchr(      wchar_t* s, wchar_t c);
78size_t wcsspn(const wchar_t* s1, const wchar_t* s2);
79const wchar_t* wcsstr(const wchar_t* s1, const wchar_t* s2);
80      wchar_t* wcsstr(      wchar_t* s1, const wchar_t* s2);
81wchar_t* wcstok(wchar_t* restrict s1, const wchar_t* restrict s2, wchar_t** restrict ptr);
82const wchar_t* wmemchr(const wchar_t* s, wchar_t c, size_t n);
83      wchar_t* wmemchr(      wchar_t* s, wchar_t c, size_t n);
84int wmemcmp(wchar_t* restrict s1, const wchar_t* restrict s2, size_t n);
85wchar_t* wmemcpy(wchar_t* restrict s1, const wchar_t* restrict s2, size_t n);
86wchar_t* wmemmove(wchar_t* s1, const wchar_t* s2, size_t n);
87wchar_t* wmemset(wchar_t* s, wchar_t c, size_t n);
88size_t wcsftime(wchar_t* restrict s, size_t maxsize, const wchar_t* restrict format,
89                const tm* restrict timeptr);
90wint_t btowc(int c);
91int wctob(wint_t c);
92int mbsinit(const mbstate_t* ps);
93size_t mbrlen(const char* restrict s, size_t n, mbstate_t* restrict ps);
94size_t mbrtowc(wchar_t* restrict pwc, const char* restrict s, size_t n, mbstate_t* restrict ps);
95size_t wcrtomb(char* restrict s, wchar_t wc, mbstate_t* restrict ps);
96size_t mbsrtowcs(wchar_t* restrict dst, const char** restrict src, size_t len,
97                 mbstate_t* restrict ps);
98size_t wcsrtombs(char* restrict dst, const wchar_t** restrict src, size_t len,
99                 mbstate_t* restrict ps);
100
101}  // std
102
103*/
104
105#if __cplusplus < 201103L && defined(_LIBCPP_USE_FROZEN_CXX03_HEADERS)
106#  include <__cxx03/cwchar>
107#else
108#  include <__config>
109#  include <__cstddef/size_t.h>
110#  include <__memory/addressof.h>
111#  include <__type_traits/copy_cv.h>
112#  include <__type_traits/is_constant_evaluated.h>
113#  include <__type_traits/is_equality_comparable.h>
114#  include <__type_traits/is_same.h>
115#  include <__type_traits/remove_cv.h>
116#  include <cwctype>
117
118#  include <wchar.h>
119
120#  ifndef _LIBCPP_WCHAR_H
121#   error <cwchar> tried including <wchar.h> but didn't find libc++'s <wchar.h> header. \
122          This usually means that your header search paths are not configured properly. \
123          The header search paths should contain the C++ Standard Library headers before \
124          any C Standard Library, and you are probably using compiler flags that make that \
125          not be the case.
126#  endif
127
128#  if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
129#    pragma GCC system_header
130#  endif
131
132_LIBCPP_BEGIN_NAMESPACE_STD
133
134using ::mbstate_t _LIBCPP_USING_IF_EXISTS;
135using ::tm _LIBCPP_USING_IF_EXISTS;
136using ::wint_t _LIBCPP_USING_IF_EXISTS;
137using ::FILE _LIBCPP_USING_IF_EXISTS;
138using ::fwprintf _LIBCPP_USING_IF_EXISTS;
139using ::fwscanf _LIBCPP_USING_IF_EXISTS;
140using ::swprintf _LIBCPP_USING_IF_EXISTS;
141using ::vfwprintf _LIBCPP_USING_IF_EXISTS;
142using ::vswprintf _LIBCPP_USING_IF_EXISTS;
143using ::swscanf _LIBCPP_USING_IF_EXISTS;
144using ::vfwscanf _LIBCPP_USING_IF_EXISTS;
145using ::vswscanf _LIBCPP_USING_IF_EXISTS;
146using ::fgetwc _LIBCPP_USING_IF_EXISTS;
147using ::fgetws _LIBCPP_USING_IF_EXISTS;
148using ::fputwc _LIBCPP_USING_IF_EXISTS;
149using ::fputws _LIBCPP_USING_IF_EXISTS;
150using ::fwide _LIBCPP_USING_IF_EXISTS;
151using ::getwc _LIBCPP_USING_IF_EXISTS;
152using ::putwc _LIBCPP_USING_IF_EXISTS;
153using ::ungetwc _LIBCPP_USING_IF_EXISTS;
154using ::wcstod _LIBCPP_USING_IF_EXISTS;
155using ::wcstof _LIBCPP_USING_IF_EXISTS;
156using ::wcstold _LIBCPP_USING_IF_EXISTS;
157using ::wcstol _LIBCPP_USING_IF_EXISTS;
158#if defined(__FreeBSD__) && defined(__LONG_LONG_SUPPORTED)
159using ::wcstoll _LIBCPP_USING_IF_EXISTS;
160#endif
161using ::wcstoul _LIBCPP_USING_IF_EXISTS;
162#if defined(__FreeBSD__) && defined(__LONG_LONG_SUPPORTED)
163using ::wcstoull _LIBCPP_USING_IF_EXISTS;
164#endif
165using ::wcscpy _LIBCPP_USING_IF_EXISTS;
166using ::wcsncpy _LIBCPP_USING_IF_EXISTS;
167using ::wcscat _LIBCPP_USING_IF_EXISTS;
168using ::wcsncat _LIBCPP_USING_IF_EXISTS;
169using ::wcscmp _LIBCPP_USING_IF_EXISTS;
170using ::wcscoll _LIBCPP_USING_IF_EXISTS;
171using ::wcsncmp _LIBCPP_USING_IF_EXISTS;
172using ::wcsxfrm _LIBCPP_USING_IF_EXISTS;
173using ::wcschr _LIBCPP_USING_IF_EXISTS;
174using ::wcspbrk _LIBCPP_USING_IF_EXISTS;
175using ::wcsrchr _LIBCPP_USING_IF_EXISTS;
176using ::wcsstr _LIBCPP_USING_IF_EXISTS;
177using ::wmemchr _LIBCPP_USING_IF_EXISTS;
178using ::wcscspn _LIBCPP_USING_IF_EXISTS;
179using ::wcslen _LIBCPP_USING_IF_EXISTS;
180using ::wcsspn _LIBCPP_USING_IF_EXISTS;
181using ::wcstok _LIBCPP_USING_IF_EXISTS;
182using ::wmemcmp _LIBCPP_USING_IF_EXISTS;
183using ::wmemcpy _LIBCPP_USING_IF_EXISTS;
184using ::wmemmove _LIBCPP_USING_IF_EXISTS;
185using ::wmemset _LIBCPP_USING_IF_EXISTS;
186using ::wcsftime _LIBCPP_USING_IF_EXISTS;
187using ::btowc _LIBCPP_USING_IF_EXISTS;
188using ::wctob _LIBCPP_USING_IF_EXISTS;
189using ::mbsinit _LIBCPP_USING_IF_EXISTS;
190using ::mbrlen _LIBCPP_USING_IF_EXISTS;
191using ::mbrtowc _LIBCPP_USING_IF_EXISTS;
192using ::wcrtomb _LIBCPP_USING_IF_EXISTS;
193using ::mbsrtowcs _LIBCPP_USING_IF_EXISTS;
194using ::wcsrtombs _LIBCPP_USING_IF_EXISTS;
195
196using ::getwchar _LIBCPP_USING_IF_EXISTS;
197using ::vwscanf _LIBCPP_USING_IF_EXISTS;
198using ::wscanf _LIBCPP_USING_IF_EXISTS;
199
200using ::putwchar _LIBCPP_USING_IF_EXISTS;
201using ::vwprintf _LIBCPP_USING_IF_EXISTS;
202using ::wprintf _LIBCPP_USING_IF_EXISTS;
203
204inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX14 size_t __constexpr_wcslen(const wchar_t* __str) {
205#  if __has_builtin(__builtin_wcslen)
206  return __builtin_wcslen(__str);
207#  else
208  if (!__libcpp_is_constant_evaluated())
209    return std::wcslen(__str);
210
211  size_t __len = 0;
212  for (; *__str != L'\0'; ++__str)
213    ++__len;
214  return __len;
215#  endif
216}
217
218inline _LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX14 int
219__constexpr_wmemcmp(const wchar_t* __lhs, const wchar_t* __rhs, size_t __count) {
220#  if __has_builtin(__builtin_wmemcmp)
221  return __builtin_wmemcmp(__lhs, __rhs, __count);
222#  else
223  if (!__libcpp_is_constant_evaluated())
224    return std::wmemcmp(__lhs, __rhs, __count);
225
226  for (; __count; --__count, ++__lhs, ++__rhs) {
227    if (*__lhs < *__rhs)
228      return -1;
229    if (*__rhs < *__lhs)
230      return 1;
231  }
232  return 0;
233#  endif
234}
235
236template <class _Tp, class _Up>
237_LIBCPP_HIDE_FROM_ABI _LIBCPP_CONSTEXPR_SINCE_CXX14 _Tp* __constexpr_wmemchr(_Tp* __str, _Up __value, size_t __count) {
238  static_assert(sizeof(_Tp) == sizeof(wchar_t)&& _LIBCPP_ALIGNOF(_Tp) >= _LIBCPP_ALIGNOF(wchar_t) &&
239                    __libcpp_is_trivially_equality_comparable<_Tp, _Tp>::value,
240                "Calling wmemchr on non-trivially equality comparable types is unsafe.");
241
242#  if __has_builtin(__builtin_wmemchr)
243  if (!__libcpp_is_constant_evaluated()) {
244    wchar_t __value_buffer = 0;
245    __builtin_memcpy(&__value_buffer, std::addressof(__value), sizeof(wchar_t));
246    return reinterpret_cast<_Tp*>(
247        __builtin_wmemchr(reinterpret_cast<__copy_cv_t<_Tp, wchar_t>*>(__str), __value_buffer, __count));
248  }
249#    if _LIBCPP_STD_VER >= 17
250  else if constexpr (is_same_v<remove_cv_t<_Tp>, wchar_t>)
251    return __builtin_wmemchr(__str, __value, __count);
252#    endif
253#  endif // __has_builtin(__builtin_wmemchr)
254
255  for (; __count; --__count) {
256    if (*__str == __value)
257      return __str;
258    ++__str;
259  }
260  return nullptr;
261}
262
263_LIBCPP_END_NAMESPACE_STD
264
265#  if !defined(_LIBCPP_REMOVE_TRANSITIVE_INCLUDES) && _LIBCPP_STD_VER <= 20
266#    include <cstddef>
267#  endif
268#endif // __cplusplus < 201103L && defined(_LIBCPP_USE_FROZEN_CXX03_HEADERS)
269
270#endif // _LIBCPP_CWCHAR
271