System.AnsiStringBase.Insert
C++
AnsiStringBase& Insert(const AnsiStringBase& str, int index) _ALWAYS_INLINE {
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | dstring.h | System | AnsiStringBase |
Beschreibung
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.