Standard library header <cwchar>

From cppreference.net

Этот заголовок изначально находился в стандартной библиотеке C как <wchar.h> .

Этот заголовок является частью библиотек wide и multibyte строк с нулевым завершением. Он также предоставляет некоторые функции C-style I/O и преобразование из C-style Date .

Содержание

Макросы

NULL	определяемая реализацией константа нулевого указателя (макроконстанта)
WEOF	несимвольное значение типа `std::wint_t` используемое для указания ошибок (макроконстанта)
WCHAR_MIN	наименьшее допустимое значение wchar_t (макроконстанта)
WCHAR_MAX	наибольшее допустимое значение wchar_t (макроконстанта)

Типы

mbstate_t	информация о состоянии преобразования, необходимая для итерации многобайтовых строк символов (класс)
size_t	беззнаковый целочисленный тип, возвращаемый оператором `sizeof` (typedef)
`wint_t`	целочисленный тип, который может содержать любой допустимый широкий символ и как минимум одно дополнительное значение
tm	тип календарного времени (класс)

Функции

Манипуляции со строками
wcscpy	копирует одну широкую строку в другую (функция)
wcsncpy	копирует определённое количество широких символов из одной строки в другую (функция)
wcscat	добавляет копию одной широкой строки к другой (функция)
wcsncat	добавляет определённое количество широких символов из одной широкой строки в другую (функция)
wcsxfrm	преобразует широкую строку так, чтобы `wcscmp` выдавал тот же результат, что и `wcscoll` (функция)
Исследование строк
wcslen	возвращает длину широкой строки (функция)
wcscmp	сравнивает две широкие строки (функция)
wcsncmp	сравнивает определённое количество символов из двух широких строк (функция)
wcscoll	сравнивает две широкие строки в соответствии с текущей локалью (функция)
wcschr	находит первое вхождение широкого символа в широкой строке (функция)
wcsrchr	находит последнее вхождение широкого символа в широкой строке (функция)
wcsspn	возвращает длину максимального начального сегмента, который состоит только из широких символов, найденных в другой широкой строке (функция)
wcscspn	возвращает длину максимального начального сегмента, который состоит только из широких символов, не найденных в другой широкой строке (функция)
wcspbrk	находит первое вхождение любого широкого символа из одной широкой строки в другой широкой строке (функция)
wcsstr	находит первое вхождение широкой строки в другой широкой строке (функция)
wcstok	находит следующий токен в широкой строке (функция)
Манипуляции с массивами широких символов
wmemcpy	копирует определённое количество широких символов между двумя неперекрывающимися массивами (функция)
wmemmove	копирует определённое количество широких символов между двумя, возможно перекрывающимися, массивами (функция)
wmemcmp	сравнивает определённое количество широких символов из двух массивов (функция)
wmemchr	находит первое вхождение широкого символа в массиве широких символов (функция)
wmemset	копирует заданный широкий символ в каждую позицию массива широких символов (функция)
Преобразование многобайтовых/широких символов
mbsinit	проверяет, представляет ли объект std::mbstate_t начальное состояние сдвига (функция)
btowc	преобразует однобайтовый узкий символ в широкий символ, если возможно (функция)
wctob	преобразует широкий символ в однобайтовый узкий символ, если возможно (функция)
mbrlen	возвращает количество байтов в следующем многобайтовом символе с учетом состояния (функция)
mbrtowc	преобразует следующий многобайтовый символ в широкий символ с учетом состояния (функция)
wcrtomb	преобразует широкий символ в его многобайтовое представление с учётом состояния (функция)
mbsrtowcs	преобразует узкую многобайтовую строку символов в широкую строку с учетом состояния (функция)
wcsrtombs	преобразует широкую строку в узкую многобайтовую строку символов с учетом состояния (функция)
Ввод/Вывод
fgetwc getwc	получает широкий символ из файлового потока (функция)
fgetws	получает широкую строку из файлового потока (функция)
fputwc putwc	записывает широкий символ в файловый поток (функция)
fputws	записывает широкую строку в файловый поток (функция)
getwchar	считывает широкий символ из stdin (функция)
putwchar	записывает широкий символ в stdout (функция)
ungetwc	возвращает широкий символ обратно в файловый поток (функция)
fwide	переключает файловый поток между широкосимвольным вводом-выводом и узкосимвольным вводом-выводом (функция)
wscanf fwscanf swscanf	считывает форматированный широкосимвольный ввод из stdin , файлового потока или буфера (функция)
vwscanf vfwscanf vswscanf (C++11) (C++11) (C++11)	читает форматированный ввод широких символов из stdin , файлового потока или буфера с использованием списка переменных аргументов (функция)
wprintf fwprintf swprintf	выводит форматированные широкие символы в stdout , файловый поток или буфер (функция)
vwprintf vfwprintf vswprintf	выводит форматированные широкосимвольные данные в stdout , файловый поток или буфер, используя список переменных аргументов (функция)
Преобразования строк
wcsftime	преобразует объект std::tm в пользовательское широкосимвольное строковое представление (функция)
wcstol wcstoll	преобразует широкую строку в целочисленное значение (функция)
wcstoul wcstoull	преобразует широкую строку в целое число без знака (функция)
wcstof wcstod wcstold	преобразует широкую строку в значение с плавающей запятой (функция)

Примечания

NULL также определён в следующих заголовочных файлах:
std::size_t также определён в следующих заголовочных файлах:
std::wint_t также определён в следующих заголовочных файлах:
- <cwctype>
std::tm также определён в следующих заголовочных файлах:
- <ctime>

Синопсис

namespace std {
  using size_t =    /* см. описание */; // freestanding
  using mbstate_t = /* см. описание */; // freestanding
  using wint_t =    /* см. описание */; // freestanding
  struct tm;
  int fwprintf(FILE* stream, const wchar_t* format, ...);
  int fwscanf(FILE* stream, const wchar_t* format, ...);
  int swprintf(wchar_t* s, size_t n, const wchar_t* format, ...);
  int swscanf(const wchar_t* s, const wchar_t* format, ...);
  int vfwprintf(FILE* stream, const wchar_t* format, va_list arg);
  int vfwscanf(FILE* stream, const wchar_t* format, va_list arg);
  int vswprintf(wchar_t* s, size_t n, const wchar_t* format, va_list arg);
  int vswscanf(const wchar_t* s, const wchar_t* format, va_list arg);
  int vwprintf(const wchar_t* format, va_list arg);
  int vwscanf(const wchar_t* format, va_list arg);
  int wprintf(const wchar_t* format, ...);
  int wscanf(const wchar_t* format, ...);
  wint_t fgetwc(FILE* stream);
  wchar_t* fgetws(wchar_t* s, int n, FILE* stream);
  wint_t fputwc(wchar_t c, FILE* stream);
  int fputws(const wchar_t* s, FILE* stream);
  int fwide(FILE* stream, int mode);
  wint_t getwc(FILE* stream);
  wint_t getwchar();
  wint_t putwc(wchar_t c, FILE* stream);
  wint_t putwchar(wchar_t c);
  wint_t ungetwc(wint_t c, FILE* stream);
  double wcstod(const wchar_t* nptr, wchar_t** endptr);
  float wcstof(const wchar_t* nptr, wchar_t** endptr);
  long double wcstold(const wchar_t* nptr, wchar_t** endptr);
  long int wcstol(const wchar_t* nptr, wchar_t** endptr, int base);
  long long int wcstoll(const wchar_t* nptr, wchar_t** endptr, int base);
  unsigned long int wcstoul(const wchar_t* nptr, wchar_t** endptr, int base);
  unsigned long long int wcstoull(const wchar_t* nptr, wchar_t** endptr, int base);
  wchar_t* wcscpy(wchar_t* s1, const wchar_t* s2);                // freestanding
  wchar_t* wcsncpy(wchar_t* s1, const wchar_t* s2, size_t n);     // freestanding
  wchar_t* wmemcpy(wchar_t* s1, const wchar_t* s2, size_t n);     // freestanding
  wchar_t* wmemmove(wchar_t* s1, const wchar_t* s2, size_t n);    // freestanding
  wchar_t* wcscat(wchar_t* s1, const wchar_t* s2);                // freestanding
  wchar_t* wcsncat(wchar_t* s1, const wchar_t* s2, size_t n);     // freestanding
  int wcscmp(const wchar_t* s1, const wchar_t* s2);               // freestanding
  int wcscoll(const wchar_t* s1, const wchar_t* s2);
  int wcsncmp(const wchar_t* s1, const wchar_t* s2, size_t n);    // freestanding
  size_t wcsxfrm(wchar_t* s1, const wchar_t* s2, size_t n);
  int wmemcmp(const wchar_t* s1, const wchar_t* s2, size_t n);    // freestanding
  const wchar_t* wcschr(const wchar_t* s, wchar_t c);             // freestanding
  wchar_t* wcschr(wchar_t* s, wchar_t c);                         // freestanding
  size_t wcscspn(const wchar_t* s1, const wchar_t* s2);           // freestanding
  const wchar_t* wcspbrk(const wchar_t* s1, const wchar_t* s2);   // freestanding
  wchar_t* wcspbrk(wchar_t* s1, const wchar_t* s2);               // freestanding
  const wchar_t* wcsrchr(const wchar_t* s, wchar_t c);            // freestanding
  wchar_t* wcsrchr(wchar_t* s, wchar_t c);                        // freestanding
  size_t wcsspn(const wchar_t* s1, const wchar_t* s2);            // freestanding
  const wchar_t* wcsstr(const wchar_t* s1, const wchar_t* s2);    // freestanding
  wchar_t* wcsstr(wchar_t* s1, const wchar_t* s2);                // freestanding
  wchar_t* wcstok(wchar_t* s1, const wchar_t* s2, wchar_t** ptr); // freestanding
  const wchar_t* wmemchr(const wchar_t* s, wchar_t c, size_t n);  // freestanding
  wchar_t* wmemchr(wchar_t* s, wchar_t c, size_t n);              // freestanding
  size_t wcslen(const wchar_t* s);                                // freestanding
  wchar_t* wmemset(wchar_t* s, wchar_t c, size_t n);              // freestanding
  size_t wcsftime(wchar_t* s, size_t maxsize, const wchar_t* format, const tm* timeptr);
  wint_t btowc(int c);
  int wctob(wint_t c);
  // функции преобразования многобайтовых/широких строк и символов
  int mbsinit(const mbstate_t* ps);
  size_t mbrlen(const char* s, size_t n, mbstate_t* ps);
  size_t mbrtowc(wchar_t* pwc, const char* s, size_t n, mbstate_t* ps);
  size_t wcrtomb(char* s, wchar_t wc, mbstate_t* ps);
  size_t mbsrtowcs(wchar_t* dst, const char** src, size_t len, mbstate_t* ps);
  size_t wcsrtombs(char* dst, const wchar_t** src, size_t len, mbstate_t* ps);
}
#define NULL      /* см. описание */ // freestanding
#define WCHAR_MAX /* см. описание */ // freestanding
#define WCHAR_MIN /* см. описание */ // freestanding
#define WEOF      /* см. описание */ // freestanding

Отчеты о дефектах

Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.

DR	Применяется к	Поведение в опубликованной версии	Корректное поведение
LWG 345	C++98	std::tm не предоставлялся в `<cwchar>`	предоставляется

Compiler support
Freestanding and hosted
Language
Standard library
Standard library headers
Named requirements
Feature test macros (C++20)
Language support library
Concepts library (C++20)
Diagnostics library
Memory management library
Metaprogramming library (C++11)
General utilities library
Containers library
Iterators library
Ranges library (C++20)
Algorithms library
Strings library
Text processing library
Numerics library
Date and time library
Input/output library
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
Technical specifications
Symbols index
External libraries

cppreference.net

Namespaces

Variants

Standard library header <cwchar>

Содержание

Макросы

Типы

Функции

Манипуляции со строками

Исследование строк

Манипуляции с массивами широких символов

Преобразование многобайтовых/широких символов

Ввод/Вывод

Преобразования строк

Примечания

Синопсис

Отчеты о дефектах