標準ライブラリヘッダー <cwchar>

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

標準ライブラリヘッダー

言語サポート <cfloat> <climits> <compare> (C++20) <contracts> (C++26) <coroutine> (C++20) <csetjmp> <csignal> <cstdarg> <cstddef> <cstdint> (C++11) <cstdlib> <exception> <initializer_list> (C++11)    <limits> <new> <source_location> (C++20) <stdfloat> (C++23) <typeinfo> <version> (C++20) コンセプト <concepts> (C++20) 診断 <cassert> <cerrno> <debugging> (C++26) <stacktrace> (C++23) <stdexcept> <system_error> (C++11) メモリ管理 <memory> <memory_resource> (C++17) <scoped_allocator> (C++11) メタプログラミング <type_traits> (C++11) <ratio> (C++11)

汎用ユーティリティ <any> (C++17) <bitset> <bit> (C++20) <charconv> (C++17) <expected> (C++23) <format> (C++20) <functional> <optional> (C++17) <tuple> (C++11) <typeindex> (C++11) <utility> <variant> (C++17) コンテナ <array> (C++11) <deque> <flat_map> (C++23) <flat_set> (C++23) <forward_list> (C++11) <hive> (C++26) <inplace_vector> (C++26)    <list> <map> <mdspan> (C++23) <queue> <set> <span> (C++20) <stack> <unordered_map> (C++11) <unordered_set> (C++11) <vector> イテレータ <iterator> Ranges <generator> (C++23) <ranges> (C++20)

アルゴリズム <algorithm> <numeric> 文字列 <cctype> <cstring> <cuchar> (C++11) <cwchar> <cwctype> <string_view> (C++17) <string> テキスト処理 <clocale> <codecvt> (C++11/17/26*) <locale> <regex> (C++11) <text_encoding> (C++26)    数値 <cfenv> (C++11) <cmath> <complex> <linalg> (C++26) <numbers> (C++20) <random> (C++11) <simd> (C++26) <valarray> 時間 <chrono> (C++11) <ctime> C互換 <ccomplex> (C++11/17/20*) <ciso646> (C++20 まで) <cstdalign> (C++11/17/20*) <cstdbool> (C++11/17/20*) <ctgmath> (C++11/17/20*)

入出力 <cinttypes> (C++11) <cstdio> <filesystem> (C++17) <fstream> <iomanip> <iosfwd> <iostream> <ios> <istream> <ostream> <print> (C++23) <spanstream> (C++23) <sstream> <streambuf> <strstream> (C++98/26*) <syncstream> (C++20) 並行性サポート <atomic> (C++11) <barrier> (C++20) <condition_variable> (C++11) <future> (C++11) <hazard_pointer> (C++26) <latch> (C++20) <mutex> (C++11) <rcu> (C++26) <semaphore> (C++20) <shared_mutex> (C++14) <stdatomic.h> (C++23) <stop_token> (C++20) <thread> (C++11) 実行サポート <execution> (C++17)

 

このヘッダーは元々C標準ライブラリに<wchar.h>として含まれていました。

このヘッダーは、NULL終端のワイド文字列およびマルチバイト文字列ライブラリの一部です。また、いくつかのC形式のI/O関数と、C形式の日付からの変換を提供します。

マクロ

NULL	処理系定義のヌルポインタ定数 (マクロ定数)
WEOF	エラーを示すために使用されるstd::wint_t型の非文字値 (マクロ定数)
WCHAR_MIN	wchar_tの最小有効値 (マクロ定数)
WCHAR_MAX	wchar_tの最大有効値 (マクロ定数)

型

mbstate_t	マルチバイト文字列を走査するために必要な変換状態情報 (クラス)
size_t	sizeof 演算子が返す符号無し整数型 (typedef)
wint_t	任意の有効なワイド文字と、少なくとももう1つの値を保持できる整数型
tm	カレンダー時間型 (クラス)

関数

文字列操作
wcscpy	あるワイド文字列を別のワイド文字列にコピーする (関数)
wcsncpy	ある文字列から別の文字列へ、指定された数のワイド文字をコピーする (関数)
wcscat	あるワイド文字列のコピーを別のワイド文字列に追加する (関数)
wcsncat	あるワイド文字列から別のワイド文字列へ、指定された数のワイド文字を追加する (関数)
wcsxfrm	wcscmpがwcscollと同じ結果を生成するようにワイド文字列を変換する (関数)
文字列検査
wcslen	ワイド文字列の長さを返す (関数)
wcscmp	2つのワイド文字列を比較する (関数)
wcsncmp	2つのワイド文字列から指定された文字数を比較する (関数)
wcscoll	現在のロケールに従って2つのワイド文字列を比較する (関数)
wcschr	ワイド文字列内でワイド文字が最初に現れる場所を見つける (関数)
wcsrchr	ワイド文字列内でワイド文字が最後に現れる場所を見つける (関数)
wcsspn	以下から成る最大の初期セグメントの長さを返す 別のワイド文字列に含まれるワイド文字のみからなる (関数)
wcscspn	以下から成る最大の初期セグメントの長さを返す 別のワイド文字列に含まれないワイド文字のみからなる (関数)
wcspbrk	あるワイド文字列に含まれるいずれかのワイド文字が、別のワイド文字列内で最初に現れる場所を見つける (関数)
wcsstr	あるワイド文字列内で、別のワイド文字列が最初に現れる場所を見つける (関数)
wcstok	ワイド文字列内の次のトークンを見つける (関数)
ワイド文字配列の操作
wmemcpy	オーバーラップしていない2つの配列間で、指定された数のワイド文字をコピーする (関数)
wmemmove	オーバーラップしている可能性のある2つの配列間で、指定された数のワイド文字をコピーする (関数)
wmemcmp	2つの配列から指定された数のワイド文字を比較する (関数)
wmemchr	ワイド文字配列内でワイド文字が最初に現れる場所を見つける (関数)
wmemset	与えられたワイド文字をワイド文字配列のすべての位置にコピーする (関数)
マルチバイト/ワイド文字変換
mbsinit	std::mbstate_t オブジェクトが初期シフト状態を表しているか確認する (関数)
btowc	可能であれば、1バイトのナロー文字をワイド文字にワイド化する (関数)
wctob	可能であれば、ワイド文字を1バイトのナロー文字にナロー化する (関数)
mbrlen	与えられた状態で、次のマルチバイト文字のバイト数を返す (関数)
mbrtowc	与えられた状態で、次のマルチバイト文字をワイド文字に変換する (関数)
wcrtomb	与えられた状態で、ワイド文字をそのマルチバイト表現に変換する (関数)
mbsrtowcs	与えられた状態で、ナローマルチバイト文字列をワイド文字列に変換する (関数)
wcsrtombs	与えられた状態で、ワイド文字列をナローマルチバイト文字列に変換する (関数)
入出力
fgetwcgetwc	ファイルストリームから1ワイド文字を取得する (関数)
fgetws	ファイルストリームからワイド文字列を取得する (関数)
fputwcputwc	ファイルストリームに1ワイド文字を書き込む (関数)
fputws	ファイルストリームにワイド文字列を書き込む (関数)
getwchar	stdinからワイド文字を読み込む (関数)
putwchar	stdoutにワイド文字を書き込む (関数)
ungetwc	ファイルストリームに1ワイド文字を戻す (関数)
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 は以下のヘッダーでも定義されています。
  • <cstddef>
  • <cstring>
  • <ctime>
  • <clocale>
  • <cstdio>
• std::size_t は以下のヘッダーでも定義されています。
  • <cstddef>
  • <ctime>
  • <cstdio>
• 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>で提供されていませんでした	提供された