System.AnsiStringT.Insert
C++
AnsiStringT& Insert(const AnsiStringT& str, int index) {
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
| function | public | dstring.h | System | AnsiStringT |
Description
Inserts a specified string into the AnsiStringT.
Insert inserts the string str into this AnsiStringT, beginning at the position index, where 1 is the first position in the string. It returns the resulting modified string.
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 specifies the character, not the byte, when working with a multibyte character system.