Namensräume
Varianten
Aktionen

std::ctype<char>::scan_not

Von cppreference.com
< cpp‎ | locale‎ | ctype char
 
 
 
 
 
Definiert in Header <locale>
const char* scan_not( mask m, const char* beg, const char* end ) const;

Sucht das erste Zeichen im Zeichenarray [begend), das nicht die Klassifikationsmaske m erfüllt, d. h. das erste Zeichen c, für das table()[(unsigned char)c] & m false 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 [begend), das die Maske nicht erfüllt, oder end, wenn kein solches Zeichen gefunden wurde.

[edit] Hinweise

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()
{
    auto& f = std::use_facet<std::ctype<char>>(std::locale());
 
    // skip leading whitespace
    char s1[] = "      \t\t\n  Test";
    const char* p1 = f.scan_not(std::ctype_base::space, std::begin(s1), std::end(s1));
    std::cout << '\'' << p1 << "'\n";
 
    // skip leading digits
    char s2[] = "123456789abcd";
    const char* p2 = f.scan_not(std::ctype_base::digit, 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 nicht entspricht
(virtuelle geschützte Memberfunktion von std::ctype<CharT>) [edit]
findet das erste Zeichen in einer Sequenz, das der gegebenen Klassifizierung entspricht, unter Verwendung der Klassifizierungstabelle
(öffentliche Memberfunktion) [edit]