System.UnicodeString.Insert
C++
UnicodeString& Insert(const UnicodeString& str, int index) _ALWAYS_INLINE {
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
| function | public | ustring.h | System | UnicodeString |
Description
Inserts a specified string into UnicodeString.
Insert inserts the string str into this 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 Length, turning the operation into an append.
If the str parameter is an empty string, Insert does nothing.
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 index, not the byte index.