[Overview][Types][Classes][Procedures and functions][Variables][Index] Reference for unit 'LazUTF8' (#lazutils)

UTF8Insert

Inserts the specified UTF-8 values into a string at the specified character position.

Declaration

Source position: lazutf8.pas line 118

procedure UTF8Insert(

  const source: Utf8String;

  var s: Utf8String;

  StartCharIndex: PtrInt

);

procedure UTF8Insert(

  const source: string;

  var s: string;

  StartCharIndex: PtrInt

);

Arguments

source

  

String with the values inserted in the routine.

s

  

String where the values from source are inserted.

StartCharIndex

  

Starting character position (1-based) where the inserted values from source are stored in s.

Arguments

source

  

String with the values inserted in the routine.

s

  

String where the values from source are inserted.

StartCharIndex

  

Starting character position (1-based) where the inserted values from source are stored in s.

Description

UTF8Insert inserts the specified values into a string at the specified character position. UTF8Insert is an overloaded procedure. The variants allow the string arguments to be specified as either String or UTF8String types.

source is the UTF-8-encoded values inserted in the routine.

s is the string where the values from source are inserted at the specified character position.

The value in StartCharIndex starts at 1, and represents the n-th codepoint (or character) in the destination string (s) where the values are inserted.

UTF8Insert calls UTF8CodepointStart to determine the position in s where the codepoint represented by StartCharIndex is located. No actions are performed in the routine if a valid codepoint is not found at the position specified in StartCharIndex. The RTL Insert routine is called to insert the UTF-8-encoded values from source into s.

See also

UTF8CodepointStart

  

Finds the n-th UTF-8 codepoint.

UTF8Delete

  

Deletes characters (or codepoints) in a UTF-8-encoded string.

UTF8Pos

  

Returns the character index where the search text starts in the string.