AppendLine()

OutputVar := instance.AppendLine()
OutputVar := instance.AppendLine(value)

AppendLine()

Appends the default line terminator to the end of the current StringBuilder object.

Returns

A reference to this instance after the append operation has completed.

Throws

Throws MfArgumentOutOfRangeException if enlarging the value of this instance would exceed MaxCapacity.

Remarks

The default line terminator is the current value of the MfEnvironment.NewLine property.

The capacity of this instance is adjusted as needed.

Example

AppendLine(value)

Appends a copy of the specified string followed by the default line terminator to the end of the current StringBuilder object.

Parameters

value

The string to append.

Returns

A reference to this instance after the append operation has completed.

Throws

Throws MfArgumentOutOfRangeException if enlarging the value of this instance would exceed MaxCapacity.

Remarks

The default line terminator is the current value of the MfEnvironment.NewLine property.

The capacity of this instance is adjusted as needed.

Example

sb := new MfText.StringBuilder()
line := "A line of text."
num := 123

; Append two lines of text.
sb.AppendLine("The first line of text.")
sb.AppendLine(line)

sb.AppendLine()
sb.AppendLine("")

; Append the non-string value, 123, and two new lines
sb.Append(num).AppendLine().AppendLine()

; Append two lines of text.
sb.AppendLine(line)
sb.AppendLine("The last line of text.")

MsgBox % sb.ToString()
/*
The first line of text.
A line of text.


123

A line of text.
The last line of text.
*/