basic_string Class

Artikel
03/15/2013

Sequenzen, die durch ein Objekt der Vorlage-Klasse Basic_string gesteuert werden die C++-Standardbibliothek String-Klasse und werden in der Regel als Zeichenfolgen bezeichnet, aber sie sollten nicht verwechselt werden mit der Null-terminierte C-Zeichenfolgen in der C++-Standardbibliothek verwendet.Die String-Klasse ist ein Container, der die Verwendung von Zeichenfolgen als normale Typen ermöglicht, z. B. Vergleiche oder Verkettung, Iteratoren und STL-Algorithmen und kopieren, und mit der Klasse Zuweisung Zuweisen von Speicher verwaltet.

template <
   class CharType,
   class Traits=char_traits<CharType>, 
   class Allocator=allocator<CharType> 
>
class basic_string

Parameter

CharType
Der Datentyp eines einzelnen Zeichens in der Zeichenfolge gespeichert werden.C++-Standardbibliothek bietet zwei Spezialisierungen dieser Klasse Vorlage mit den Typdefinitionen String, für Elemente des Typs char, und Wstring, für Elemente des Typs wchar_t.
Traits
Verschiedene wichtige Eigenschaften von der CharType Elemente in eine Spezialisierung der Basic_string werden beschrieben, von der Klasse Merkmale.
Allocator
Der Typ, der gespeicherte Zuweisung-Objekts darstellt, das Informationen über die Zuweisung und Freigabe des Speichers der Zeichenfolge kapselt.Der Standardwert ist Zuweisung*<Type>.*

Viele Member-Funktionen erfordern eine Operanden Sequenz von Elementen.Sie können solche eine Operanden Sequenz mehrere Möglichkeiten angeben.

Element	Beschreibung
_Ch	Ein Element mit Zeichenwert _Ch.
_Count, _Ch	Eine Wiederholung der _Count Elemente jedes mit Wert _Ch.
_Ptr	Eine Null-terminierte Reihenfolge, z. B. eine C-Zeichenfolge mit einer CharType vom Typ char, am Anfang _Ptr (die keine null-Zeiger sein muss), wo das abschließende Element ist der Wert value_type und ist nicht Teil der Sequenz Operanden.
_Ptr, _Count	Eine Folge von _Count Elemente ab _Ptr.
_Str	Die Sequenz, die durch ein Basic_string-Objekt angegeben.
_Str, _Off, _Count	Die Teilzeichenfolge des Objekts Basic_string _Str mit bis zu _Count Elemente (oder bis zum Ende der Zeichenfolge, welcher Fall zuerst eintritt) ab Position _Off.
_First, _Last	Eine Sequenz von Elementen, die durch die Iteratoren getrennt _First und _Last, im Bereich [_First, _Last), überlagern die Sequenz gesteuert, indem das String-Objekt, dessen Memberfunktion aufgerufen wird ist.

Wenn ein Argument für die Position (z. B. _Off) ist hinter dem Ende der Zeichenfolge bei einem Aufruf von einer basic_string Member-Funktion, die Funktion meldet einen Fehler außerhalb des Bereichs durch das Auslösen eines Objekts vom Typ Out_of_range Klasse.

Wenn eine Funktion aufgefordert wird, generiert eine Sequenz, die länger als Max_size Elemente, die Funktion meldet einen Fehler bei der Länge durch das Auslösen eines Objekts vom Typ Length_error Klasse.

Verweise, Zeigern und Iteratoren, die Elemente der kontrollierten Sequenz festlegen können ungültig nach dem Aufrufen einer Funktion, die die kontrollierte Sequenz ändert, oder nach dem ersten Aufruf zu einem nicht-const -Memberfunktion.

Konstruktoren

basic_string

Erstellt eine Zeichenfolge, die leer oder durch bestimmte Zeichen oder d. h. eine Kopie aller oder einen Teil von einem anderen String-Objekt initialisiert oder C-Zeichenfolge ist.

Typedefs

allocator_type	Ein Typ, der stellt die allocator -Klasse für ein String-Objekt.
const_iterator	Ein Typ, der einen random-Access-Iterator ermöglicht Zugriff und lesen kann ein const Element in der Zeichenfolge.
const_pointer	Ein Typ, der einen Zeiger auf eine const Element in einer Zeichenfolge.
const_reference	Ein Typ, der einen Verweis auf ein const Element in einer Zeichenfolge zum Lesen und Ausführen gespeichert const Operationen.
const_reverse_iterator	Ein Typ, der einem random-Access-Iterator, können bereitstellt gelesen const Element in der Zeichenfolge.
difference_type	Ein Typ, der die Differenz zwischen zwei Iteratoren bereitstellt, die auf Elemente innerhalb der dieselbe Zeichenfolge verweisen.
Iterator	Ein Typ, der einen random-Access-Iterator bereitstellt, der gelesen oder jedes Element in einer Zeichenfolge ändern können.
gemeinnützige Organisationen	Einen unsigned ganzzahligen Wert – 1, der angibt, entweder "nicht gefunden" oder "alle übrigen Zeichen" initialisiert Wenn eine Suchfunktion fehlschlägt.
pointer	Ein Typ, der einen Zeiger auf ein Zeichen-Element in einem Array Zeichenfolgen- oder Zeichentyp bereitstellt.
-Referenz	Ein Typ, der einen auf ein Element in einer Zeichenfolge gespeichert Verweis.
reverse_iterator	Ein Typ, der einen random-Access-Iterator ermöglicht, der lesen oder ändern ein Element in einer Zeichenfolge umgekehrt.
size_type	Ein ganzzahliger Typ ohne Vorzeichen für die Anzahl der Elemente in einer Zeichenfolge.
traits_type	Ein Typ für die Eigenschaften der Elemente in einer Zeichenfolge gespeichert.
value_type	Ein Typ, der den Typ von Zeichen in einer Zeichenfolge gespeichert darstellt.

Member-Funktionen

append	Fügt Zeichen am Ende einer Zeichenfolge.
assign	Der Inhalt einer Zeichenfolge neue Zeichenwerte zugewiesen.
at	Gibt einen Verweis auf das Element an einer angegebenen Position in der Zeichenfolge zurück.
back
begin	Gibt einen Iterator Adressierung das erste Element in der Zeichenfolge.
c_str	Konvertiert den Inhalt einer Zeichenfolge als C-Stil, Null-terminierte Zeichenfolge.
capacity	Gibt die größte Anzahl von Elementen, die in einer Zeichenfolge gespeichert werden konnte, ohne die Speicherzuordnung der Zeichenfolge erhöhen.
cbeginkönnen	Gibt einen const Iterator Adressierung das erste Element in der Zeichenfolge.
cend	Gibt einen const Iterator, die den Speicherort, das letzte Element in einer Zeichenfolge zurück.
clear	Löscht alle Elemente einer Zeichenfolge.
compare	Vergleicht eine Zeichenfolge mit einer angegebenen Zeichenfolge, ob zwei Zeichenfolgen gleich sind oder wenn eine lexikografisch kleiner als der andere ist.
copy	Kopiert höchstens eine angegebene Anzahl von Zeichen aus einer indizierten Position in einer Quellzeichenfolge in ein Zeichenarray Ziel.Veraltet.Verwenden Sie stattdessen basic_string::_Copy_s.
crbegin	Gibt einen const Iterator, die das erste Element in einer stornierte Zeichenfolge zurück.
crend	Gibt einen const Iterator, die den Speicherort, das letzte Element in einer Zeichenfolge umgekehrt.
_Copy_s	Kopiert höchstens eine angegebene Anzahl von Zeichen aus einer indizierten Position in einer Quellzeichenfolge in ein Zeichenarray Ziel.
data	Konvertiert den Inhalt einer Zeichenfolge in ein Array von Zeichen.
empty	Testet, ob die Zeichenfolge Zeichen enthält.
end	Gibt einen Iterator, die den Speicherort, das letzte Element in einer Zeichenfolge zurück.
Löschen	Entfernt ein Element oder einen Bereich von Elementen in einer Zeichenfolge aus einer angegebenen Position.
find	Sucht eine Zeichenfolge in Vorwärtsrichtung nach dem ersten Vorkommen einer Teilzeichenfolge, die eine bestimmte Folge von Zeichen entspricht.
find_first_not_of	Durchsucht eine Zeichenfolge für das erste Zeichen, das keine Elemente einer angegebenen Zeichenfolge ist.
find_first_of	Durchsucht eine Zeichenfolge für das erste Zeichen, das jedem Element einer angegebenen Zeichenfolge übereinstimmt.
find_last_not_of	Durchsucht eine Zeichenfolge für das letzte Zeichen, das keine Elemente einer angegebenen Zeichenfolge ist.
find_last_of	Durchsucht eine Zeichenfolge für das letzte Zeichen, das ein Element einer angegebenen Zeichenfolge ist.
front	Gibt einen Verweis auf das erste Element in einer Zeichenfolge zurück.
get_allocator	Gibt eine Kopie der allocator Objekt verwendet, um die Zeichenfolge zu erstellen.
Einfügen	Fügt ein Element oder eine Anzahl von Elementen oder einen Bereich von Elementen in der Zeichenfolge an der angegebenen Position.
length	Gibt die aktuelle Anzahl der Elemente in einer Zeichenfolge zurück.
max_size	Gibt die maximale Anzahl von Zeichen, die eine Zeichenfolge enthalten könnte.
pop_back	Löscht das letzte Element der Zeichenfolge.
push_back	Fügt ein Element an das Ende der Zeichenfolge.
rbegin	Gibt einen Iterator das erste Element in einer Zeichenfolge umgekehrt.
rend	Gibt einen Iterator, zeigt nur hinter dem letzten Element in einer stornierte Zeichenfolge zurück.
replace	Elemente in einer Zeichenfolge an der angegebenen Position ersetzt mit dem angegebenen Zeichen oder Zeichen, die von anderen Bereichen oder Zeichenfolgen oder C-Zeichenfolgen kopiert.
reserve	Legt die Kapazität der Zeichenfolge in eine Zahl mindestens so groß wie eine angegebene Anzahl.
resize	Gibt eine neue Größe für eine Zeichenfolge, Anfügen oder Löschen von Elementen wie erforderlich.
rfind	Sucht eine Zeichenfolge in eine Ebene nach hinten Richtung für das erste Vorkommen einer Teilzeichenfolge, die eine bestimmte Folge von Zeichen entspricht.
shrink_to_fit	Verwirft die Überkapazität der Zeichenfolge.
size	Gibt die aktuelle Anzahl der Elemente in einer Zeichenfolge zurück.
SUBSTR	Kopiert eine Teilzeichenfolge des höchstens bestimmte Anzahl von Zeichen aus einer Zeichenfolge aus einer angegebenen Position.
Swap	Tauschen Sie den Inhalt von zwei Zeichenfolgen.

Operatoren

Operator +=	Fügt die Zeichen in eine Zeichenfolge.
operator=	Der Inhalt einer Zeichenfolge neue Zeichenwerte zugewiesen.
operator[]	Stellt einen Verweis auf das Zeichen mit einem angegebenen Index in einer Zeichenfolge bereit.

Anforderungen

Header: <string>

Namespace: std

Siehe auch

Referenz

Threadsicherheit in der C++-Standardbibliothek

Weitere Ressourcen

basic_string Member

<string> Member

Freigeben über