std::ctype<char>::is

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Textverarbeitungsbibliothek

Lokalisierungsbibliothek

Reguläre Ausdrücke-Bibliothek (C++11)

Formatierungsbibliothek (C++20)

Dienstprogramme für Null-terminierte Sequenzen

Byte-Zeichenketten

Multibyte-Zeichenketten

Wide-Zeichenketten

Primitive numerische Konvertierungen

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

Textkodierungserkennung

text_encoding (C++26)

 

Lokalisierungsbibliothek

Lokale und Facetten   Lokale has_facet use_facet locale Facet-Kategorie Basisklassen ctype_base codecvt_base messages_base time_base money_base ctype-Facetten ctype ctype<char> ctype_byname codecvt codecvt_byname numerische Facetten num_get num_put numpunct numpunct_byname Kollationsfacetten collate collate_byname Zeitfacetten time_get time_put time_get_byname time_put_byname

Geldfacetten money_get money_put moneypunct moneypunct_byname Nachrichtenfacetten messages messages_byname Zeichenklassifizierung und -konvertierung Zeichenklassifizierung isspace    iscntrl isupper islower    isalpha ispunct isdigit    isxdigit isalnum isblank (C++11) isprint isgraph Zeichenkonvertierungen toupper    tolower String- und Streamkonvertierungen wstring_convert (C++11/17/26*) wbuffer_convert (C++11/17/26*) Unicode-Konvertierungsfacets codecvt_utf8 (C++11/17/26*) codecvt_utf16 (C++11/17/26*) codecvt_utf8_utf16 (C++11/17/26*) codecvt_mode (C++11/17/26*) C-Bibliotheks-Lokalisierungen LC_ALLLC_COLLATELC_CTYPELC_MONETARYLC_NUMERICLC_TIME    setlocale localeconv lconv

 

std::ctype

Memberfunktionen

ctype::ctype

ctype::~ctype

ctype::isctype::do_is

ctype::scan_isctype::do_scan_is

ctype::scan_notctype::do_scan_not

ctype::toupperctype::do_toupper

ctype::tolowerctype::do_tolower

ctype::widenctype::do_widen

ctype::narrowctype::do_narrow

Member functions of ctype<char>

ctype<char>::ctype

ctype<char>::~ctype

ctype<char>::table

ctype<char>::classic_table

ctype<char>::is

ctype<char>::scan_is

ctype<char>::scan_not

 

Definiert in Header <locale>
bool is( mask m, char c ) const;	(1)
const char* is( const char* low, const char* high, mask* vec ) const;	(2)

1) Prüft, ob das Zeichen c gemäß der durch die Memberfunktion table() zurückgegebenen Klassifikationstabelle mit der Maske m klassifiziert wird. Berechnet effektiv table()[(unsigned char)c] & m.

2) Liest für jedes Zeichen im Zeichenarray [low, high) die vollständige Klassifikationsmaske aus der durch die Memberfunktion table() zurückgegebenen Klassifikationstabelle (d.h. evaluiert table()[(unsigned char)*p] und speichert es im entsprechenden Element des Arrays, auf das von vec gezeigt wird.

Wenn (unsigned char)c >= std::ctype<char>::table_size, dann wird stattdessen ein implementierungsdefinierter Wert anstelle von table()[(unsigned char)c] substituiert, möglicherweise unterschiedlich für verschiedene Werte von c.

Parameter

c	-	zu klassifizierendes Zeichen
m	-	zu verwendende Maske für die Klassifizierung eines einzelnen Zeichens
low	-	Zeiger auf das erste Zeichen in einem Array von zu klassifizierenden Zeichen
high	-	Zeiger auf das Ende (einschließlich) des Arrays von zu klassifizierenden Zeichen
vec	-	Zeiger auf das erste Element des Arrays von zu füllenden Masken

Rückgabewert

1) true, wenn c in table() mit m klassifiziert wird, false sonst.

2) high

Anmerkungen

Im Gegensatz zur primären Vorlage std::ctype führt diese Spezialisierung keinen virtuellen Funktionsaufruf bei der Klassifizierung von Zeichen durch. Um das Verhalten anzupassen, kann eine abgeleitete Klasse dem Konstruktor der Basisklasse eine nicht-standardmäßige Klassifikationstabelle bereitstellen.

Beispiel

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 28	C++98	Überladung (2) kopierte die Werte aus vec nach table(), was das Gegenteil des beabsichtigten Verhaltens war	korrigiert

Siehe auch

do_is [virtuell]

klassifiziert ein Zeichen oder eine Zeichensequenz (virtual protected member function of std::ctype<CharT>)