TUnicodeStringBuilder class

In unit sysutils

Ansi-string version of string builder.

Declaration

pascal

TUnicodeStringBuilder = class

Description

TUnicodeStringBuilder is a class to construct an ansistring out of other strings or characters. It's methods can be used instead of constructing the string manually using the normal + or concat operators. If used properly (e.g. by setting a sufficiently large Capacity), will result in faster operation. It offers various methods to append to the string.

To create a unicode string, use the TUnicodeStringBuilder class instead.

Properties

`Chars`	public	Indexed access to the characters in the string.
`Length`	public	Currentl length of the string buffer.
`Capacity`	public	Current capacity of the string buffer.
`MaxCapacity`	public	Maximum capacity of the string buffer.

Methods

`CheckRange`	protected
`CheckNegative`	protected
`DoAppend`	protected
`DoInsert`	protected
`DoReplace`	protected
`Grow`	protected
`Shrink`	protected
`Create`	public	Create a new TUnicodeStringBuilder instance.
`Append`	public	Append data in string form to the buffer.
`AppendFormat`	public	Append the result of a Format.
`AppendLine`	public	Append a string followed by a newline.
`Clear`	public	Clear the string being built.
`CopyTo`	public	Copy string bytes to an array.
`EnsureCapacity`	public	Set the capacity if needed.
`Equals`	public	Check if 2 stringbuilders have the same content string.
`GetEnumerator`	public
`Insert`	public	Insert data in string form into the buffer at a given position.
`Remove`	public	Remove data from the string.
`Replace`	public	Replace a range of characters.
`ToString`	public	Return the string buffer as an UnicodeString.

Fields

`FData`	protected
`FLength`	protected
`FMaxCapacity`	protected

An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.