标准库头文件 <cwchar>

此头文件最初在 C 标准库中为 <wchar.h>。

此头文件是空终止宽字符串和多字节字符串库的一部分。它还提供了一些C 风格 I/O 函数以及从C 风格日期的转换。

字符串操作
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	将宽字符串转换为窄多字节字符串，给定状态 (函数) [编辑]
输入/输出
fgetwcgetwc	从文件流中获取一个宽字符 (函数) [编辑]
fgetws	从文件流中获取一个宽字符串 (函数) [编辑]
fputwcputwc	将一个宽字符写入文件流 (函数) [编辑]
fputws	将一个宽字符串写入文件流 (函数) [编辑]
getwchar	从 stdin 读取一个宽字符 (函数) [编辑]
putwchar	将一个宽字符写入 stdout (函数) [编辑]
ungetwc	将一个宽字符放回文件流 (函数) [编辑]
fwide	在宽字符 I/O 和窄字符 I/O 之间切换文件流 (函数) [编辑]
wscanffwscanfswscanf	从 stdin、文件流或缓冲区读取格式化的宽字符输入 (函数) [编辑]
vwscanfvfwscanfvswscanf (C++11)(C++11)(C++11)	使用可变参数列表从 stdin、文件流或缓冲区读取格式化的宽字符输入 (函数) [编辑]
wprintffwprintfswprintf	将格式化的宽字符输出打印到 stdout、文件流或缓冲区 (函数) [编辑]
vwprintfvfwprintfvswprintf	将格式化的宽字符输出打印到 stdout、文件流或缓冲区读取格式化的宽字符输入 (函数) [编辑]
字符串转换
wcsftime	将 std::tm 对象转换为自定义宽字符串文本表示形式 (函数) [编辑]
wcstolwcstoll	将宽字符串转换为整数值 (函数) [编辑]
wcstoulwcstoull	将宽字符串转换为无符号整数值 (函数) [编辑]
wcstofwcstodwcstold	将宽字符串转换为浮点数值 (函数) [编辑]

[编辑] 注解

NULL 也在以下头文件中定义
std::size_t 也在以下头文件中定义
std::wint_t 也在以下头文件中定义
- <cwctype>
std::tm 也在以下头文件中定义
- <ctime>

[编辑] 概要

namespace std {
  using size_t =    /* see description */; // freestanding
  using mbstate_t = /* see description */; // freestanding
  using wint_t =    /* see description */; // 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);
 
  // multibyte / wide string and character conversion functions
  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      /* see description */ // freestanding
#define WCHAR_MAX /* see description */ // freestanding
#define WCHAR_MIN /* see description */ // freestanding
#define WEOF      /* see description */ // freestanding

[编辑] 缺陷报告

以下行为变更的缺陷报告被追溯应用于先前发布的 C++ 标准。

DR	应用于	已发布行为	正确行为
LWG 345	C++98	std::tm 未在 `<cwchar>` 中提供	已提供

编译器支持
独立和宿主式
语言
标准库
标准库头文件
具名要求
特性测试宏 (C++20)
语言支持库
概念库 (C++20)
诊断库
内存管理库
元编程库 (C++11)
通用工具库
容器库
迭代器库
范围库 (C++20)
算法库
字符串库
文本处理库
数值库
日期和时间库
输入/输出库
文件系统库 (C++17)
并发支持库 (C++11)
执行控制库 (C++26)
技术规范
符号索引
外部库

mbstate_t	迭代多字节字符串所需的转换状态信息 (类) [编辑]
size_t	`sizeof` 运算符返回的无符号整数类型 (类型别名) [编辑]
`wint_t`	可以容纳任何有效的宽字符以及至少一个额外值的整数类型
tm	日历时间类型 (类) [编辑]

cppreference.cn

命名空间

变体

视图

操作

标准库头文件 <cwchar>

目录

[编辑] 宏

[编辑] 类型

[编辑] 函数

字符串操作

字符串检查

宽字符数组操作

多字节/宽字符转换

输入/输出

字符串转换

[编辑] 注解

[编辑] 概要

[编辑] 缺陷报告

导航

工具箱

NULL	实现定义的空指针常量 (宏常量) [编辑]
WEOF	类型为 `std::wint_t` 的非字符值，用于指示错误 (宏常量)
WCHAR_MIN	wchar_t 的最小有效值 (宏常量)
WCHAR_MAX	wchar_t 的最大有效值 (宏常量)