Standard library header <cwchar>

From cppreference.net

Dieser Header war ursprünglich in der C-Standardbibliothek als <wchar.h> enthalten.

Dieser Header ist Teil der nullterminierten wide und multibyte Strings-Bibliotheken. Er bietet außerdem einige C-style I/O Funktionen und Konvertierung von C-style Date .

Inhaltsverzeichnis

Makros

NULL	implementierungsdefinierte Nullzeigerkonstante (Makrokonstante)
WEOF	ein Nicht-Zeichen-Wert vom Typ `std::wint_t` zur Fehleranzeige (Makrokonstante)
WCHAR_MIN	der kleinste gültige Wert von wchar_t (Makrokonstante)
WCHAR_MAX	der größte gültige Wert von wchar_t (Makrokonstante)

Typen

mbstate_t	Konvertierungszustandsinformationen, die zum Iterieren von Multibyte-Zeichenketten erforderlich sind (Klasse)
size_t	vorzeichenloser Ganzzahltyp, der vom `sizeof` Operator zurückgegeben wird (typedef)
`wint_t`	Ganzzahltyp, der jedes gültige Breitzeichen und mindestens einen weiteren Wert halten kann
tm	Kalenderzeit-Typ (Klasse)

Funktionen

String-Manipulation
wcscpy	kopiert eine Breitzeichen-Zeichenkette in eine andere (Funktion)
wcsncpy	kopiert eine bestimmte Anzahl von Breitzeichen von einer Zeichenkette zu einer anderen (Funktion)
wcscat	hängt eine Kopie einer Breitzeichenkette an eine andere an (Funktion)
wcsncat	hängt eine bestimmte Anzahl von Breitzeichen von einer Breitzeichenkette an eine andere an (Funktion)
wcsxfrm	transformiert eine Breitzeichenkette so, dass `wcscmp` das gleiche Ergebnis wie `wcscoll` liefern würde (Funktion)
String-Untersuchung
wcslen	gibt die Länge einer Breitzeichen-Zeichenkette zurück (Funktion)
wcscmp	vergleicht zwei Breitzeichen-Zeichenketten (Funktion)
wcsncmp	vergleicht eine bestimmte Anzahl von Zeichen aus zwei Breitzeichen-Zeichenketten (Funktion)
wcscoll	vergleicht zwei Breitzeichenketten entsprechend der aktuellen Locale (Funktion)
wcschr	findet das erste Vorkommen eines Breitzeichen in einer Breitzeichenkette (Funktion)
wcsrchr	findet das letzte Vorkommen eines Breitzeichens in einer Breitzeichenkette (Funktion)
wcsspn	gibt die Länge des maximalen Anfangssegments zurück, das nur aus den Breitzeichen besteht, die in einer anderen Breitzeichenkette gefunden werden (Funktion)
wcscspn	gibt die Länge des maximalen Anfangssegments zurück, das nur aus Wide-Zeichen besteht, die nicht in einer anderen Wide-Zeichenkette gefunden werden (Funktion)
wcspbrk	findet die erste Position eines beliebigen Breitzeichen in einer Breitzeichenkette in einer anderen Breitzeichenkette (Funktion)
wcsstr	findet das erste Vorkommen einer Breitzeichenkette innerhalb einer anderen Breitzeichenkette (Funktion)
wcstok	findet das nächste Token in einer Breitzeichen-Zeichenkette (Funktion)
Manipulation von Breitzeichen-Arrays
wmemcpy	kopiert eine bestimmte Anzahl von Breitzeichen zwischen zwei nicht überlappenden Arrays (Funktion)
wmemmove	kopiert eine bestimmte Anzahl von Breitzeichen zwischen zwei, möglicherweise überlappenden, Arrays (Funktion)
wmemcmp	vergleicht eine bestimmte Anzahl von Breitzeichen aus zwei Arrays (Funktion)
wmemchr	findet das erste Vorkommen eines Breitzeichens in einem Breitzeichen-Array (Funktion)
wmemset	kopiert das angegebene Breitzeichen an jede Position in einem Breitzeichen-Array (Funktion)
Multibyte-/Breitzeichen-Konvertierung
mbsinit	prüft, ob das std::mbstate_t Objekt den initialen Schaltzustand repräsentiert (Funktion)
btowc	erweitert ein Single-Byte-Zeichen zu einem Breitzeichen, falls möglich (Funktion)
wctob	verengt ein Breitzeichen zu einem Einzelbyte-Zeichen, falls möglich (Funktion)
mbrlen	gibt die Anzahl der Bytes im nächsten Multibyte-Zeichen zurück, unter Berücksichtigung des Zustands (Funktion)
mbrtowc	wandelt das nächste Multibyte-Zeichen in ein Breitzeichen um, unter Berücksichtigung des Zustands (Funktion)
wcrtomb	wandelt ein Breitzeichen in seine Multibyte-Darstellung um, unter Berücksichtigung des Zustands (Funktion)
mbsrtowcs	wandelt eine schmale Multibyte-Zeichenkette in eine Breitzeichenkette um, mit Zustandsangabe (Funktion)
wcsrtombs	wandelt eine Breitzeichen-Zeichenkette in eine schmale Multibyte-Zeichenkette um, mit Zustandsangabe (Funktion)
Input/Output
fgetwc getwc	liest ein Breitzeichen aus einem Dateistrom (Funktion)
fgetws	liest eine Breitzeichen-Zeichenkette aus einem Dateistrom (Funktion)
fputwc putwc	Schreibt ein Breitzeichen in einen Dateistrom (Funktion)
fputws	schreibt eine Breitzeichenkette in einen Dateistrom (Funktion)
getwchar	liest ein Breitzeichen von stdin (Funktion)
putwchar	schreibt ein Breitzeichen in stdout (Funktion)
ungetwc	setzt ein Breitzeichen zurück in einen Dateistrom (Funktion)
fwide	schaltet einen Dateistream zwischen Breitzeichen-I/O und Schmalspurzeichen-I/O um (Funktion)
wscanf fwscanf swscanf	liest formatierten Breitzeichen-Input von stdin , einem Dateistream oder einem Puffer (Funktion)
vwscanf vfwscanf vswscanf (C++11) (C++11) (C++11)	liest formatierten Breitzeichen-Input von stdin , einem Dateistream oder einem Buffer unter Verwendung einer variablen Argumentenliste (Funktion)
wprintf fwprintf swprintf	gibt formatierten Breitzeichen-Output an stdout , einen Dateistream oder einen Puffer aus (Funktion)
vwprintf vfwprintf vswprintf	gibt formatierten Breitzeichen-Output an stdout , einen Dateistream oder einen Puffer unter Verwendung einer variablen Argumentenliste aus (Funktion)
String-Konvertierungen
wcsftime	konvertiert ein std::tm Objekt in eine benutzerdefinierte breite Zeichenketten-Repräsentation (Funktion)
wcstol wcll	wandelt eine Breitzeichen-Zeichenkette in einen ganzzahligen Wert um (Funktion)
wcstoul wcstoull	wandelt eine Breitzeichen-Zeichenkette in einen vorzeichenlosen Ganzzahlwert um (Funktion)
wcstof wcstod wcstold	wandelt eine Breitzeichen-Zeichenkette in einen Gleitkommawert um (Funktion)

Hinweise

NULL ist auch in den folgenden Headern definiert:
std::size_t ist auch in den folgenden Headern definiert:
std::wint_t ist auch in den folgenden Headern definiert:
- <cwctype>
std::tm ist auch in den folgenden Headern definiert:
- <ctime>

Übersicht

namespace std {
  using size_t =    /* siehe Beschreibung */; // freestanding
  using mbstate_t = /* siehe Beschreibung */; // freestanding
  using wint_t =    /* siehe Beschreibung */; // 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- und Zeichenkonvertierungsfunktionen
  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      /* siehe Beschreibung */ // freestanding
#define WCHAR_MAX /* siehe Beschreibung */ // freestanding
#define WCHAR_MIN /* siehe Beschreibung */ // freestanding
#define WEOF      /* siehe Beschreibung */ // freestanding

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	Angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
LWG 345	C++98	std::tm war nicht in `<cwchar>` vorhanden	vorhanden

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>

Inhaltsverzeichnis

Makros

Typen

Funktionen

String-Manipulation

String-Untersuchung

Manipulation von Breitzeichen-Arrays

Multibyte-/Breitzeichen-Konvertierung

Input/Output

String-Konvertierungen

Hinweise

Übersicht

Fehlerberichte