UnicodeString::Insert Method

Inserts specified string into System::UnicodeString.

Pascal

function Insert(const str: UnicodeString&; index: Integer): UnicodeString&;

C++

__fastcall UnicodeString& Insert(const UnicodeString& str, int index);

Description

System::UnicodeString::Insert inserts the string str into this System::UnicodeString object beginning at the position index, where 1 is the first position in the string. It returns the resulting modified string (*this).

If index is less than 1, it is mapped to a 1. If it is past the end of the string, it is set to System::UnicodeString::Length, turning the operation into an append.

If the str parameter is an empty string, System::UnicodeString::Insert does nothing.

System::UnicodeString::Insert throws an EOutOfMemory exception if the method is unable to allocate enough memory to accommodate the new, longer string.

Note: The index parameter always specifies the character, not the byte, index.