std::basic_string<CharT,Traits,Allocator>:: find_first_not_of
|
size_type find_first_not_of
(
const
basic_string
&
str,
size_type pos = 0 ) const ; |
(1) |
(seit C++11 noexcept)
(seit C++20 constexpr) |
|
size_type find_first_not_of
(
const
CharT
*
s,
size_type pos, size_type count ) const ; |
(2) | (seit C++20 constexpr) |
|
size_type find_first_not_of
(
const
CharT
*
s,
size_type pos = 0 ) const ; |
(3) | (seit C++20 constexpr) |
|
size_type find_first_not_of
(
CharT ch, size_type pos
=
0
)
const
;
|
(4) |
(seit C++11 noexcept)
(seit C++20 constexpr) |
|
template
<
class
StringViewLike
>
size_type
|
(5) |
(seit C++17)
(seit C++20 constexpr) |
Findet das erste Zeichen, das keinem der Zeichen in der gegebenen Zeichenfolge entspricht. Die Suche berücksichtigt nur den Bereich
[
pos
,
size()
)
. Wenn alle Zeichen im Bereich in der gegebenen Zeichenfolge gefunden werden können, wird
npos
zurückgegeben.
[
s
,
s
+
count
)
entspricht. Dieser Bereich kann Nullzeichen enthalten.
Traits::length(s)
bestimmt.
std:: basic_string_view < CharT, Traits >> true ist und std:: is_convertible_v < const StringViewLike & , const CharT * > false ist.
In allen Fällen wird Gleichheit durch Aufruf von Traits::eq überprüft.
Inhaltsverzeichnis |
Parameter
| str | - | Zeichenkette, die die zu suchenden Zeichen identifiziert |
| pos | - | Startposition für die Suche |
| count | - | Länge der Zeichenkette, die die zu suchenden Zeichen identifiziert |
| s | - | Zeiger auf eine Zeichenkette, die die zu suchenden Zeichen identifiziert |
| ch | - | Zeichen, das die zu suchenden Zeichen identifiziert |
| t | - | Objekt (konvertierbar zu std::basic_string_view ), das die zu suchenden Zeichen identifiziert |
Rückgabewert
Position des gefundenen Zeichens oder std::string::npos falls kein solches Zeichen gefunden wurde.
Ausnahmen
Wenn aus irgendeinem Grund eine Exception ausgelöst wird, hat diese Funktion keine Wirkung ( strong exception safety guarantee ).
Beispiel
#include <iostream> #include <string> int main() { // Großbuchstaben, Kleinbuchstaben und Zahlen in Makronamen erlauben const char* pattern = "ABCDEFGHIJKLMNOPQRSTUVWXYZ" "abcdefghijklmnopqrstuvwxyz" "0123456789"; std::string data = "1) %FIX, 2) %HACK, and 3) %TODO"; const std::string replacement = "%DONE%"; std::cout << "Before: " << data << '\n'; for (std::string::size_type first{}, last{}; (first = data.find('%', first)) != std::string::npos; first += replacement.size()) { last = data.find_first_not_of(pattern, first + 1); if (last == std::string::npos) last = data.length(); // Jetzt ist first bei '%' und last ist eine Position nach dem Ende des gefundenen Teilstrings data.replace(first, last - first, replacement); } std::cout << "After: " << data << '\n'; }
Ausgabe:
Before: 1) %FIX, 2) %HACK, and 3) %TODO After: 1) %DONE%, 2) %DONE%, and 3) %DONE%
Fehlerberichte
Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.
| DR | Angewendet auf | Verhalten wie veröffentlicht | Korrektes Verhalten |
|---|---|---|---|
| LWG 847 | C++98 | es gab keine Exception-Sicherheitsgarantie | starke Exception-Sicherheitsgarantie hinzugefügt |
| LWG 2064 | C++11 | Überladungen (3,4) waren noexcept | entfernt |
| LWG 2946 | C++17 | Überladung (5) verursachte in einigen Fällen Mehrdeutigkeit | vermieden durch Template-Implementierung |
| P1148R0 |
C++11
C++17 |
noexcept für Überladungen
(4,5)
wurden
versehentlich durch LWG2064/LWG2946 entfernt |
wiederhergestellt |
Siehe auch
|
findet das erste Vorkommen der gegebenen Teilzeichenkette
(öffentliche Elementfunktion) |
|
|
findet das letzte Vorkommen einer Teilzeichenkette
(öffentliche Elementfunktion) |
|
|
findet das erste Vorkommen von Zeichen
(öffentliche Elementfunktion) |
|
|
findet das letzte Vorkommen von Zeichen
(öffentliche Elementfunktion) |
|
|
findet das letzte Nicht-Vorkommen von Zeichen
(öffentliche Elementfunktion) |
|
|
findet das erste Nicht-Vorkommen von Zeichen
(öffentliche Elementfunktion von
std::basic_string_view<CharT,Traits>
)
|