标准库标头 <cwchar>

来自cppreference.com

此标头原作为 <wchar.h> 存在于 C 标准库。

此头文件是空终止宽及多字节字符串库的一部分。它也提供了一些 C 风格输入/输出函数和源自 C 风格日期的转换。

字符串操纵
wcscpy	复制宽字符串到另一个 (函数) [编辑]
wcsncpy	复制来自宽字符串的一定量宽字符到另一个 (函数) [编辑]
wcscat	追加宽字符串的副本到另一个 (函数) [编辑]
wcsncat	追加来自宽字符串的一定量宽字符到另一个 (函数) [编辑]
wcsxfrm	变换宽字符串，使得 `wcscmp` 会产生与 `wsccoll` 相同的结果 (函数) [编辑]
字符串检验
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	在宽字符输入/输出和窄字符输入/输出间切换文件流 (函数) [编辑]
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>

[编辑] Synopsis

namespace std {
  using size_t =    /* 见描述 */; // 独立
  using mbstate_t = /* 见描述 */; // 独立
  using wint_t =    /* 见描述 */; // 独立
 
  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);                // 独立
  wchar_t* wcsncpy(wchar_t* s1, const wchar_t* s2, size_t n);     // 独立
  wchar_t* wmemcpy(wchar_t* s1, const wchar_t* s2, size_t n);     // 独立
  wchar_t* wmemmove(wchar_t* s1, const wchar_t* s2, size_t n);    // 独立
  wchar_t* wcscat(wchar_t* s1, const wchar_t* s2);                // 独立
  wchar_t* wcsncat(wchar_t* s1, const wchar_t* s2, size_t n);     // 独立
  int wcscmp(const wchar_t* s1, const wchar_t* s2);               // 独立
  int wcscoll(const wchar_t* s1, const wchar_t* s2);
  int wcsncmp(const wchar_t* s1, const wchar_t* s2, size_t n);    // 独立
  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);    // 独立
  const wchar_t* wcschr(const wchar_t* s, wchar_t c);             // 独立
  wchar_t* wcschr(wchar_t* s, wchar_t c);                         // 独立
  size_t wcscspn(const wchar_t* s1, const wchar_t* s2);           // 独立
  const wchar_t* wcspbrk(const wchar_t* s1, const wchar_t* s2);   // 独立
  wchar_t* wcspbrk(wchar_t* s1, const wchar_t* s2);               // 独立
  const wchar_t* wcsrchr(const wchar_t* s, wchar_t c);            // 独立
  wchar_t* wcsrchr(wchar_t* s, wchar_t c);                        // 独立
  size_t wcsspn(const wchar_t* s1, const wchar_t* s2);            // 独立
  const wchar_t* wcsstr(const wchar_t* s1, const wchar_t* s2);    // 独立
  wchar_t* wcsstr(wchar_t* s1, const wchar_t* s2);                // 独立
  wchar_t* wcstok(wchar_t* s1, const wchar_t* s2, wchar_t** ptr); // 独立
  const wchar_t* wmemchr(const wchar_t* s, wchar_t c, size_t n);  // 独立
  wchar_t* wmemchr(wchar_t* s, wchar_t c, size_t n);              // 独立
  size_t wcslen(const wchar_t* s);                                // 独立
  wchar_t* wmemset(wchar_t* s, wchar_t c, size_t n);              // 独立
  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      /* 见描述 */ // 独立
#define WCHAR_MAX /* 见描述 */ // 独立
#define WCHAR_MIN /* 见描述 */ // 独立
#define WEOF      /* 见描述 */ // 独立

[编辑] 缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告	应用于	出版时的行为	正确行为
LWG 345	C++98	`<cwchar>` 没有提供 std::tm	已提供

来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/header/cwchar&oldid=94632”

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

mbstate_t	迭代多字节字符串所需的转换状态信息 (类) [编辑]
size_t	`sizeof` 运算符返回的无符号整数类型 (typedef) [编辑]
`wint_t`	能保有任何合法宽字符和至少多一个值的整数类型
tm	日历时间类型 (类) [编辑]

cppreference.com

名字空间

变换

查看

操作

标准库标头 <cwchar>

目录

[编辑] 宏

[编辑] 类型

[编辑] 函数

字符串操纵

字符串检验

宽字符数组操纵

多字节/宽字符转换

输入/输出

字符串转换

[编辑] 注解

[编辑] Synopsis

[编辑] 缺陷报告

导航

工具箱

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