basic_string-Klasse
Bei den von einem Objekt der basic_string-Vorlagenklasse gesteuerten Sequenzen handelt es sich um die Standard-C++-Zeichenfolgenklasse, und sie werden normalerweise als Zeichenfolgen bezeichnet. Allerdings sollten diese nicht mit den in der C++-Standardbibliothek verwendeten auf NULL endenden Zeichenfolgen im C-Stil verwechselt werden. Die C++-Standardzeichenfolge ist ein Container, der die Verwendung von Zeichenfolgen als Normaltypen, wie das Verwenden von Vergleichs- und Verkettungsvorgängen, Iteratoren, STL-Algorithmen sowie das Kopieren und Zuweisen mit von Klassenzuweisung verwaltetem Arbeitsspeicher, ermöglicht. Falls eine C++-Standardzeichenfolge in eine auf Null endende Zeichenfolge im C-Stil konvertiert werden muss, verwenden Sie den basic_string::c_str-Member.
template <class CharType, class Traits = char_traits<CharType>, class Allocator = allocator<CharType>> class basic_string;
Parameter
CharType
Der Datentyp eines einzelnen in der Zeichenfolge zu speichernden Zeichens. Die C++-Standardbibliothek bietet Spezialisierungen dieser Vorlagenklasse mit den Typdefinitionen string für Elemente des Typs char, wstring für wchar_t, u16string für char16_t und u32string für char32_t.Traits
Verschiedene wichtige Eigenschaften der CharType-Elemente in einer basic_string-Spezialisierung werden von der Klasse Traits beschrieben. Der Standardwert ist char_traits<CharType>.Allocator
Der Typ, mit dem das gespeicherte Zuordnungsobjekt darstellt wird, mit dem Details zum Belegen und Freigeben des Arbeitsspeichers der Zeichenfolge gekapselt werden. Der Standardwert ist allocator<CharType>.
Konstruktoren
Erstellt eine Zeichenfolge, die leer ist, oder von bestimmten Zeichen initialisiert wird, oder eine vollständige oder teilweise Kopie eines anderen Zeichenfolgenobjekts oder einer C-Zeichenfolge ist. |
Typedefs
Ein Typ, mit dem die allocator-Klasse für ein Zeichenfolgenobjekt dargestellt wird. |
|
Ein Typ, der einen Iterator mit zufälligem Zugriff bereitstellt, mit dem auf ein const-Element zugegriffen, und mit dem dieses Element gelesen werden kann. |
|
Ein Typ, der einen Zeiger auf ein const-Element in einer Zeichenfolge bereitstellt. |
|
Ein Typ, der einen Verweis auf ein const-Element bereitstellt, das in einer Zeichenfolge zum Lesen und Ausführen von const-Vorgängen gespeichert ist. |
|
Ein Typ, der einen Iterator mit zufälligem Zugriff bereitstellt, mit dem jedes const-Element gelesen werden kann. |
|
Ein Typ, der den Unterschied zwischen zwei Iteratoren, die auf Elemente innerhalb derselben Zeichenfolge verweisen, bereitstellt. |
|
Ein Typ, der einen Iterator mit zufälligem Zugriff bereitstellt, mit dem jedes Element in einer Zeichenfolge gelesen oder geändert werden kann. |
|
Ein auf – 1 initialisierter Integralwert ohne Vorzeichen, der bei einem Fehler mit einer Suchfunktion entweder "nicht gefunden" oder "alle verbleibenden Zeichen" angibt. |
|
Ein Typ, der einen Zeiger auf ein Zeichenelement in einer Zeichenfolge oder einem Zeichenarray bereitstellt. |
|
Ein Typ, der einen Verweis auf ein in einer Zeichenfolge gespeichertes Element bereitstellt. |
|
Ein Typ, der einen Iterator mit zufälligem Zugriff bereitstellt, mit dem ein Element in einer umgekehrten Zeichenfolge gelesen oder geändert werden kann. |
|
Ein Integraltyp ohne Vorzeichen für die Anzahl von Elementen in einer Zeichenfolge. |
|
Ein Typ für die Zeichenmerkmale der in einer Zeichenfolge gespeicherten Elemente. |
|
Ein Typ, der die Art der in einer Zeichenfolge gespeicherten Zeichen darstellt. |
Memberfunktionen
Fügt am Ende einer Zeichenfolge Zeichen hinzu. |
|
Weist dem Inhalt einer Zeichenfolge neue Zeichenwerte zu. |
|
Gibt einen Verweis auf das Element an einer angegebenen Position in der Zeichenfolge zurück. |
|
Gibt ein Iterator zurück, der das erste Element in der Zeichenfolge adressiert. |
|
Konvertiert den Inhalt einer Zeichenfolge als eine auf NULL endende Zeichenfolge im C-Format zurück. |
|
Gibt die höchste Anzahl von Elementen zurück, die ohne Erhöhung der Speicherbelegung der Zeichenfolge in einer Zeichenfolge gespeichert werden können. |
|
Gibt einen const-Iterator zurück, der das erste Element in der Zeichenfolge adressiert. |
|
Gibt einen const-Iterator zurück, der den Speicherort adressiert, der dem letzten Element einer Zeichenfolge nachfolgt. |
|
Löscht alle Elemente einer Zeichenfolge. |
|
Vergleicht eine Zeichenfolge mit einer angegebenen Zeichenfolge, um zu bestimmen, ob die beiden Zeichenfolgen gleich sind, oder ob eine lexikografisch kleiner als die andere ist. |
|
Kopiert höchstens eine angegebene Anzahl von Zeichen aus einer indizierten Position in einer Quellzeichenfolge in ein Zielzeichenarray. Veraltet. Verwenden Sie stattdessen basic_string::_Copy_s. |
|
Gibt einen const-Iterator zurück, der das erste Element in einer umgekehrter Zeichenfolge adressiert. |
|
Gibt einen const-Iterator zurück, der den Speicherort adressiert, der dem letzten Element einer umgekehrten Zeichenfolge nachfolgt. |
|
Kopiert höchstens eine angegebene Anzahl von Zeichen aus einer indizierten Position in einer Quellzeichenfolge in ein Zielzeichenarray. |
|
Konvertiert den Inhalt einer Zeichenfolge in ein Zeichenarray. |
|
Testet, ob in der Zeichenfolge Zeichen enthalten sind. |
|
Gibt einen Iterator zurück, der den Speicherort adressiert, der dem letzten Element einer Zeichenfolge nachfolgt. |
|
Entfernt ein Element oder einen Reihe von Elementen einer Zeichenfolge von einer angegebenen Position. |
|
Sucht eine Zeichenfolge vorwärts nach dem ersten Vorkommen einer Teilzeichenfolge ab, die mit einer bestimmten Zeichensequenz übereinstimmt. |
|
Durchsucht eine Zeichenfolge nach dem ersten Zeichen, das kein Element der angegebenen Zeichenfolge ist. |
|
Durchsucht eine Zeichenfolge nach dem ersten Zeichen, das einem Element der angegebenen Zeichenfolge entspricht. |
|
Durchsucht eine Zeichenfolge nach dem letzten Zeichen, das kein Element der angegebenen Zeichenfolge ist. |
|
Durchsucht eine Zeichenfolge nach dem letzten Zeichen, das ein Element der angegebenen Zeichenfolge ist. |
|
Gibt einen Verweis auf das erste Element in einer Zeichenfolge zurück. |
|
Gibt eine Kopie des zum Erstellen der Zeichenfolge verwendeten allocator-Objekts zurück. |
|
Fügt ein Element oder mehrere Elemente oder ein Reihe von Elementen an einer bestimmten Position in die Zeichenfolge ein. |
|
Gibt die aktuelle Anzahl von Elementen in einer Zeichenfolge zurück. |
|
Gibt die Höchstanzahl von Zeichen, die eine Zeichenfolge enthalten könnte zurück. |
|
Löscht das letzte Element der Zeichenfolge. |
|
Fügt ein Element am Ende der Zeichenfolge hinzu. |
|
Gibt einen Iterator an das erste Element in einer umgekehrten Zeichenfolge zurück. |
|
Gibt einen Iterator zurück, der auf die Position direkt hinter dem letzten Element in einer umgekehrten Zeichenfolge zeigt. |
|
Ersetzt Elemente an einer bestimmten Position in einer Zeichenfolge durch angegebene Zeichen oder Zeichen, die aus anderen Bereichen oder Zeichenfolgen oder C-Zeichenfolgen kopiert werden. |
|
Legt die Kapazität der Zeichenfolge auf eine Zahl fest, die mindestens so groß ist, wie eine angegebene Anzahl. |
|
Gibt eine neue Größe für eine Zeichenfolge an und fügt Elemente an bzw. löscht sie bei Bedarf. |
|
Sucht eine Zeichenfolge rückwärts nach dem ersten Vorkommen einer Teilzeichenfolge ab, die mit einer bestimmten Zeichensequenz übereinstimmt. |
|
Verwirft die Überkapazität der Zeichenfolge. |
|
Gibt die aktuelle Anzahl von Elementen in einer Zeichenfolge zurück. |
|
Kopiert eine Teilzeichenfolge höchstens einer beliebigen Anzahl von Zeichen aus einer Zeichenfolge, beginnend an einer angegebenen Position. |
|
Tauschen Sie den Inhalt von zwei Zeichenfolgen aus. |
Operatoren
Fügt einer Zeichenfolge Zeichen an. |
|
Weist dem Inhalt einer Zeichenfolge neue Zeichenwerte zu. |
|
Stellt mit einem angegebenen Index in einer Zeichenfolge einen Verweis auf das Zeichen. |
Hinweise
Wenn eine Funktion aufgefordert wird, eine Sequenz zu generieren, die länger als max_size-Elemente ist, wird von der Funktion ein Längenfehler gemeldet, indem ein Objekt des Typs length_error ausgelöst wird.
Verweise, Zeiger und Iteratoren, mit denen Elemente der gesteuerte Sequenz festgelegt werden, können nach jedem Aufruf einer Funktion, mit der die gesteuerte Sequenz geändert wird, oder nach dem ersten Aufruf einer anderen als einer const-Memberfunktion ungültig werden.
Anforderungen
Header: <string>
Namespace: std