Skip to content

    TUnicodeStringBuilder.Insert

    Insert data in string form into the buffer at a given position.

    Declaration

    Source position: syssbh.inc line 91

    public 
function Insert(Index: Integer; const AValue: Boolean)
                : TUnicodeStringBuilder;

function Insert(Index: Integer; const AValue: Byte)
                : TUnicodeStringBuilder;

function Insert(Index: Integer; const AValue: WideChar)
                : TUnicodeStringBuilder;

function Insert(Index: Integer; const AValue: Currency)
                : TUnicodeStringBuilder;

function Insert(Index: Integer; const AValue: Double)
                : TUnicodeStringBuilder;

function Insert(Index: Integer; const AValue: SmallInt)
                : TUnicodeStringBuilder;

function Insert(Index: Integer; const AValue: LongInt)
                : TUnicodeStringBuilder;

function Insert(Index: Integer; const AValue: Array of WideChar)
                : TUnicodeStringBuilder;

function Insert(Index: Integer; const AValue: Int64)
                : TUnicodeStringBuilder;

function Insert(Index: Integer; const AValue: TObject)
                : TUnicodeStringBuilder;

function Insert(Index: Integer; const AValue: ShortInt)
                : TUnicodeStringBuilder;

function Insert(Index: Integer; const AValue: Single)
                : TUnicodeStringBuilder;

function Insert(Index: Integer; const AValue: UnicodeString)
                : TUnicodeStringBuilder;

function Insert(Index: Integer; const AValue: Word)
                : TUnicodeStringBuilder;

function Insert(Index: Integer; const AValue: Cardinal)
                : TUnicodeStringBuilder;

function Insert(Index: Integer; const AValue: UInt64)
                : TUnicodeStringBuilder;

function Insert(Index: Integer; const AValue: UnicodeString; 
               const aRepeatCount: Integer) : TUnicodeStringBuilder;

function Insert(Index: Integer; const AValue: Array of WideChar; 
               startIndex: Integer; SBCharCount: Integer)
                : TUnicodeStringBuilder;

    Description

    Insert in its various overloaded forms will insert the aValue argument into the buffer at position Index (0-based), after converting it to a string value if necessary:

    • For integer values the various IntToSTr functions will be used.
    • For TObject the TObject.ToString is used.
    • The repeatCount argument will insert the character as many times as instructed.
    • If the StartIndex and SBCharCount are specified, then SBCharCount characters are copied starting from position StartIndex.

    See also

    Name Description
    AppendFormat Append the result of a Format.
    AppendLine Append a string followed by a newline.
    Append Append data in string form to the buffer.
    Remove Remove data from the string.
    Replace Replace a range of characters.