API:System.AnsiStringT.Insert
C++
AnsiStringT& Insert(const AnsiStringT& str, int index) {
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | dstring.h | System | AnsiStringT |
Beschreibung
Fügt den angegebenen String in den AnsiStringBase-String ein.
System.AnsiStringT.Insert erbt von System.AnsiStringBase.Insert. Der folgende Inhalt bezieht sich auf System.AnsiStringBase.Insert.
Fügt den angegebenen String in den AnsiStringBase-String ein.
Insert fügt den String str ab der durch index gegebenen Position in diesen AnsiStringBase-String ein. Die erste Position im String hat den Indexwert 1. Die Methode gibt den geänderten String (*this) zurück.
Wenn index kleiner als 1 ist, wird 1 verwendet. Wenn der Wert von index das Ende des Strings überschreitet, wird er auf Length() gesetzt, und eine Append-Operation durchgeführt.
Wenn der Parameter str ein leerer String ist, führt Insert nichts aus.
Insert löst eine EOutOfMemory-Exception aus, wenn nicht genügend Speicherplatz für den neuen, längeren Rückgabe-String zugewiesen werden kann.
Anmerkung: Wenn ein Multibyte-Zeichensystem verwendet wird, bezeichnet der Parameter index das Zeichen, nicht das Byte.