std::stoul, std::stoull

 

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

 

Bibliothek für Zeichenketten

Klassen

basic_string

basic_string_view (C++17)

char_traits

 

std::basic_string

Memberfunktionen basic_string::basic_string basic_string::~basic_string basic_string::operator= basic_string::assign basic_string::assign_range (C++23)   basic_string::get_allocator Elementzugriff basic_string::at basic_string::operator[] basic_string::front (DR*) basic_string::back (DR*) basic_string::data basic_string::c_str basic_string::operator  basic_string_view (C++17) Iteratoren basic_string::beginbasic_string::cbegin (C++11) basic_string::endbasic_string::cend (C++11) basic_string::rbeginbasic_string::crbegin (C++11) basic_string::rendbasic_string::crend (C++11) Suche basic_string::find basic_string::rfind basic_string::find_first_of basic_string::find_first_not_of basic_string::find_last_of basic_string::find_last_not_of

Modifizierer basic_string::clear basic_string::insert basic_string::insert_range (C++23) basic_string::erase basic_string::push_back basic_string::pop_back (DR*) basic_string::append basic_string::append_range (C++23) basic_string::operator+= basic_string::replace basic_string::replace_with_range (C++23) basic_string::copy basic_string::resize basic_string::resize_and_overwrite (C++23)  basic_string::swap Kapazität basic_string::empty basic_string::sizebasic_string::length basic_string::max_size basic_string::reserve basic_string::capacity basic_string::shrink_to_fit (DR*) Operationen basic_string::compare basic_string::starts_with (C++20) basic_string::ends_with (C++20) basic_string::contains (C++23) basic_string::substr

Konstanten basic_string::npos Nicht-Member-Funktionen operator+ swap(std::basic_string) erase(std::basic_string)erase_if(std::basic_string) (C++20)(C++20) I/O operator<<operator>> getline Vergleich operator==operator!=operator<operator>operator<=operator>=operator<=> (bis C++20)(bis C++20)(bis C++20)(bis C++20)(bis C++20)(C++20) Numerische Konvertierungen stoistolstoll (C++11)(C++11)(C++11) stoulstoull (C++11)(C++11)  stofstodstold (C++11)(C++11)(C++11) to_string (C++11) to_wstring (C++11) Literale operator""s (C++14) Hilfsklassen hash<std::basic_string> (C++11) Deduction guides (C++17)

 

Definiert in Header <string>
unsigned long      stoul ( const std::string& str,                            std::size_t* pos = nullptr, int base = 10 );	(1)	(seit C++11)
unsigned long      stoul ( const std::wstring& str,                            std::size_t* pos = nullptr, int base = 10 );	(2)	(seit C++11)
unsigned long long stoull( const std::string& str,                            std::size_t* pos = nullptr, int base = 10 );	(3)	(seit C++11)
unsigned long long stoull( const std::wstring& str,                            std::size_t* pos = nullptr, int base = 10 );	(4)	(seit C++11)

Interpretiert einen vorzeichenlosen Integerwert in der Zeichenkette str.

Sei ptr ein interner (für die Konvertierungsfunktionen) Zeiger vom Typ char* (1,3) oder wchar_t* (2,4), entsprechend.

1) Ruft std::strtoul(str.c_str(), &ptr, base) auf.

2) Ruft std::wcstoul(str.c_str(), &ptr, base) auf.

3) Ruft std::strtoull(str.c_str(), &ptr, base) auf.

4) Ruft std::wcstoull(str.c_str(), &ptr, base) auf.

Verwirft alle Leerzeichen (wie durch Aufruf von std::isspace identifiziert), bis das erste Nicht-Leerzeichen gefunden wird, nimmt dann so viele Zeichen wie möglich, um eine gültige Basis-n (wobei n=base) vorzeichenlose Integer-Zahlendarstellung zu bilden, und konvertiert sie in einen Integerwert. Der gültige vorzeichenlose Integerwert besteht aus den folgenden Teilen:

• (optional) Vorzeichen (+ oder -)
• (optional) Präfix (0) zur Angabe der Oktalbasis (gilt nur, wenn die Basis 8 oder ​0​ ist)
• (optional) Präfix (0x oder 0X) zur Angabe der Hexadezimalbasis (gilt nur, wenn die Basis 16 oder ​0​ ist)
• eine Folge von Ziffern

Die Menge der gültigen Werte für base ist {0, 2, 3, ..., 36}. Die Menge der gültigen Ziffern für Basis-2-Ganzzahlen ist {0, 1}, für Basis-3-Ganzzahlen ist {0, 1, 2} und so weiter. Für Basen größer als 10 umfassen gültige Ziffern alphabetische Zeichen, beginnend mit Aa für Basis-11-Ganzzahlen bis Zz für Basis-36-Ganzzahlen. Die Groß-/Kleinschreibung der Zeichen wird ignoriert.

Zusätzliche numerische Formate können von der aktuell installierten C locale akzeptiert werden.

Wenn der Wert von base ​0​ ist, wird die numerische Basis automatisch erkannt: Wenn das Präfix 0 ist, ist die Basis Oktal, wenn das Präfix 0x oder 0X ist, ist die Basis Hexadezimal, andernfalls ist die Basis Dezimal.

Wenn das Minuszeichen Teil der Eingabesequenz war, wird der aus den Ziffern berechnete numerische Wert negiert, als ob durch unäres Minus im Ergebnistyp, was Regeln für vorzeichenlose Integer-Überläufe anwendet.

Wenn pos kein Nullzeiger ist, dann erhält ptr die Adresse des ersten nicht konvertierten Zeichens in str.c_str(), und der Index dieses Zeichens wird berechnet und in *pos gespeichert, was die Anzahl der von der Konvertierung verarbeiteten Zeichen angibt.

Parameter

str	-	der zu konvertierende String
pos	-	Adresse eines Integers, um die Anzahl der verarbeiteten Zeichen zu speichern
base	-	die Zahlenbasis

Rückgabewert

Die in den angegebenen vorzeichenlosen Integer-Typ konvertierte Zeichenkette.

Ausnahmen

• std::invalid_argument, wenn keine Konvertierung durchgeführt werden konnte.
• std::out_of_range, wenn der konvertierte Wert außerhalb des Bereichs des Ergebnistyps liegt oder wenn die zugrunde liegende Funktion (std::strtoul oder std::strtoull) errno auf ERANGE setzt.

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 2009	C++11	std::out_of_range würde nicht ausgelöst werden, wenn std::strtoul oder std::strtoull errno auf ERANGE setzt	wirft

Siehe auch

stoistolstoll (C++11)(C++11)(C++11)	konvertiert einen String in eine vorzeichenbehaftete Ganzzahl (function)
stofstodstold (C++11)(C++11)(C++11)	konvertiert einen String in einen Gleitkommawert (function)