std::ctype<char>::scan_is
| Definiert in Header <locale> |
||
| const char* scan_is( mask m, const char* beg, const char* end ) const; |
(1) | |
Sucht das erste Zeichen im Zeichenarray [beg, end), das die Klassifizierungsmaske m erfüllt, d.h. das erste Zeichen c, für das table()[(unsigned char) c] & m true zurückgeben würde.
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.
Inhalt |
[edit] Parameter
| m | - | zu suchende Maske |
| beg | - | Zeiger auf das erste Zeichen in einem Array von zu durchsuchenden Zeichen |
| end | - | ein Zeiger hinter das Ende für das zu durchsuchende Zeichenarray |
[edit] Rückgabewert
Zeiger auf das erste Zeichen in [beg, end), das die Maske erfüllt, oder end, wenn kein solches Zeichen gefunden wurde.
[edit] 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.
[edit] Beispiel
#include <iostream> #include <iterator> #include <locale> int main() { std::locale loc(""); auto& f = std::use_facet<std::ctype<char>>(loc); // skip until the first letter char s1[] = " \t\t\n Test"; const char* p1 = f.scan_is(std::ctype_base::alpha, std::begin(s1), std::end(s1)); std::cout << '\'' << p1 << "'\n"; // skip until the first letter char s2[] = "123456789abcd"; const char* p2 = f.scan_is(std::ctype_base::alpha, std::begin(s2), std::end(s2)); std::cout << '\'' << p2 << "'\n"; }
Ausgabe
'Test' 'abcd'
[edit] Siehe auch
| [virtuell] |
sucht das erste Zeichen in einer Sequenz, das der gegebenen Klassifizierung entspricht (virtuelle geschützte Memberfunktion von std::ctype<CharT>) |
| findet das erste Zeichen in einer Sequenz, das die gegebene Klassifizierung nicht erfüllt, unter Verwendung der Klassifizierungstabelle (öffentliche Memberfunktion) |
