System.AnsiStringBase.Insert

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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.