System.UnicodeString.Insert

提供: RAD Studio API Documentation
移動先: 案内検索

C++

UnicodeString& Insert(const UnicodeString& str, int index) _ALWAYS_INLINE {

プロパティ

種類 可視性 ソース ユニット
function public ustring.h System UnicodeString

説明

指定した文字列を UnicodeString に挿入します。

Insert は、index (1 は文字列内の先頭位置)で指定した位置から文字列 str をこの UnicodeString に挿入します。処理の結果変更された文字列(*this)を返します。

index が 1 より小さい場合、1 に位置付けられます。文字列を末尾を越える場合は、Length に設定され、追加(append)操作になります。

str パラメータが空の文字列場合、Insert は何の処理も行いません。

メソッドが、以前より長い新しい文字列を格納するだけの十分なメモリを割り当てられない場合は、Insert は EOutOfMemory 例外を送出します。

メモ:  index パラメータには常に、バイト インデックスではなく、文字インデックスを指定します。

関連項目