Deduktionshilfen für std::basic_string

 

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) Ableitungsregeln (C++17)

 

Definiert in Header <string>
template< class InputIt, class Alloc = std::allocator<                              typename std::iterator_traits<InputIt>::value_type> > basic_string( InputIt, InputIt, Alloc = Alloc() )     -> basic_string<typename std::iterator_traits<InputIt>::value_type,                     std::char_traits<                         typename std::iterator_traits<InputIt>::value_type>, Alloc>;	(1)	(seit C++17)
template< class CharT,           class Traits,           class Alloc = std::allocator<CharT> > explicit basic_string( std::basic_string_view<CharT, Traits>, const Alloc& = Alloc() )     -> basic_string<CharT, Traits, Alloc>;	(2)	(seit C++17)
template< class CharT,           class Traits,           class Alloc = std::allocator<CharT>> > basic_string( std::basic_string_view<CharT, Traits>,               typename /* siehe unten */::size_type,               typename /* siehe unten */::size_type,               const Alloc& = Alloc() )     -> basic_string<CharT, Traits, Alloc>;	(3)	(seit C++17)
template< ranges::input_range R,           class Alloc = std::allocator<ranges::range_value_t<R>> > basic_string( std::from_range_t, R&&, Alloc = Alloc() )     -> basic_string<ranges::range_value_t<R>,                        std::char_traits<ranges::range_value_t<R>>, Alloc>;	(4)	(seit C++23)

1) Diese Deduktionshilfe wird für std::basic_string bereitgestellt, um die Deduktion aus einem Iterator-Bereich zu ermöglichen. Diese Überladung nimmt nur an der Überladungspreisentscheidung teil, wenn InputIt LegacyInputIterator erfüllt und Alloc Allocator erfüllt.

2,3) Diese Deduktionshilfen werden für std::basic_string bereitgestellt, um die Deduktion aus einem std::basic_string_view zu ermöglichen. Der Parameter-Typ size_type in (3) bezieht sich auf den Member-Typ size_type des Typs, der durch die Deduktionshilfe abgeleitet wird. Diese Überladungen nehmen nur an der Überladungspreisentscheidung teil, wenn Alloc Allocator erfüllt.

4) Diese Deduktionshilfe wird für std::basic_string bereitgestellt, um die Deduktion aus einem std::from_range_t-Tag und einem input_range zu ermöglichen.

Hinweis: Das Ausmaß, in dem die Bibliothek feststellt, dass ein Typ LegacyInputIterator nicht erfüllt, ist undefiniert, außer dass als Minimum ganzzahlige Typen nicht als Eingabeiteratoren qualifizieren. Ebenso ist das Ausmaß, in dem die Bibliothek feststellt, dass ein Typ Allocator nicht erfüllt, undefiniert, außer dass als Minimum der Member-Typ Alloc::value_type existieren muss und der Ausdruck std::declval<Alloc&>().allocate(std::size_t{}) gut gebildet sein muss, wenn er als nicht ausgewerteter Operand behandelt wird.

Hinweise

Die Hilfen (2,3) sind erforderlich, da die Konstruktoren von std::basic_string für std::basic_string_views Vorlagen sind, um Mehrdeutigkeiten in bestehendem Code zu vermeiden, und diese Vorlagen unterstützen keine Klassenvorlagenargumentableitung.

Hinweise

Feature-Test-Makro	Wert	Std	Feature
__cpp_lib_containers_ranges	202202L	(C++23)	Bereichsbezogene Konstruktion und Einfügung; Überladung (4)

Beispiel

Führen Sie diesen Code aus

#include <cassert>
#include <string>
#include <vector>
 
int main()
{
    std::vector<char> v = {'a', 'b', 'c'};
    std::basic_string s1(v.begin(), v.end()); // uses deduction guide (1)
    assert(s1 == "abc");
 
#if __cpp_lib_containers_ranges >= 202202L
    std::vector<wchar_t> v4{0x43, 43, 053, 0x32, 0x33};
    std::basic_string s4(std::from_range, v4); // uses deduction guide (4)
    assert(s4 == L"C++23");
#endif
}

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 3075	C++17	Deduction von basic_string_view wurde nicht unterstützt (verschärft durch LWG-Problem 2946)	Deduktionshilfen hinzugefügt