System.UnicodeString.Insert
C++
UnicodeString& Insert(const UnicodeString& str, int index) _ALWAYS_INLINE {
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | ustring.h | System | UnicodeString |
Beschreibung
Fügt den angegebenen String in einen UnicodeString ein.
Insert fügt den String str ab der in index angegebenen Position in diesen UnicodeString ein. Die erste Position im String hat den Indexwert 1. Die Methode gibt den sich daraus ergebenden 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: Der Parameter index gibt immer den Zeichen-Index nicht den Byte-Index an.