System.AnsiStringBase.Insert

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

C++

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

プロパティ

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

説明

Insert メソッドは,指定された文字列を AnsiStringBase に挿入します。

Insert メソッドは,位置 index(文字列の先頭の位置が 1)を先頭として文字列 str をこの AnsiStringBase に挿入します。Insert は,修正された文字列(*this)を返します。

index が 1 未満の場合は 1 にマップされます。これが文字列の最後を過ぎている場合,Index は Length() に設定され,操作が追加に変わります。

str パラメータが空の文字列の場合,Insert は何もしません。

長くなった新しい文字列を格納するのに十分なメモリを割り当てることができない場合,Insert は EOutOfMemory 例外を送出します。

メモ:  マルチバイト文字システムが使用されている場合,index パラメータはバイトではなく文字を指定します。