Insert()
Insert value(s) to instance.
OutputVar := instance.Insert(index, chars)
OutputVar := instance.Insert(index, chars, startIndex, charCount)
OutputVar := instance.Insert(index, value)
OutputVar := instance.Insert(index, value, repeatCount)
Inserts the string representation of the Unicode characters in a specified list to this instance.
index
The position in this instance where insertion begins.
Can be any type that matches IsInteger or var integer.
chars
Instance of MfCharList to insert.
A reference to this instance after the insert operation has completed.
Throws MfArgumentOutOfRangeException if index is less than zero or greater than the Length of this instance -or- enlarging the value of this instance would exceed MaxCapacity.
This method inserts at the index position all the characters in the specified MfCharList to the current instance in the same order as they appear in value. If value is null, no changes are made.
See Example Below
Inserts the string representation of a specified sublist of Unicode characters to this instance.
index
The position in this instance where insertion begins.
Can be any type that matches IsInteger or var integer.
chars
Instance of MfCharList to insert.
startIndex
The starting position in chars.
Can var integer or any type that matches IsInteger.
charCount
The number of characters to append.
Can var integer or any type that matches IsInteger.
A reference to this instance after the insert operation has completed.
Throws MfArgumentNullException if chars is null or chars.Count is 0 and startIndex or charCount is not equal to zero.
Throws MfArgumentOutOfRangeException if index, startIndex or charCount is less than zero.
- or -
index is greater than the length of this instance.
- or -
startIndex + charCount is greater than the length of value.
- or -
Enlarging the value of this instance would exceed MaxCapacity.
Existing characters are shifted to make room for the new text. The Capacity of this instance is adjusted as needed.
See Example Below
Insert a copy of the specified string var or object to this instance.
index
The position in this instance where insertion begins.
Can be any type that matches IsInteger or var integer.
value
Value to append to current instance.
Can be var number or string or any object that derives from MfObject.
A reference to this instance after the insert operation has completed.
Throws MfArgumentOutOfRangeException if index is less than zero or greater than the current Length of this instance or enlarging the value of this instance would exceed MaxCapacity.
Existing characters are shifted to make room for the new text. The Capacity of this instance is adjusted as needed.
See Example Below
Inserts a specified number of copies of the string representation of a Unicode characters to this instance.
index
The position in this instance where insertion begins.
Can be any type that matches IsInteger or var integer.
value
Value to append to current instance.
Can be var number or string or any object that derives from MfObject.
repeatCount
The number of times to append value.
Can var integer or any type that matches IsInteger.
A reference to this instance after the insert operation has completed.
Throws MfArgumentOutOfRangeException repeatCount is less than zero or enlarging the value of this instance would exceed MaxCapacity.
Throws MfOutOfMemoryException Out of memory.
Existing characters are shifted to make room for the new text. The Capacity of this instance is adjusted as needed.
initialValue := new MfString("--[]--")
xyz := new MfString("xyz")
abc := new MfCharList(3)
abc.Char[0] := "a" ; could also use AddString method
abc.Char[1] := "b"
abc.Char[2] := "c"
star := new MfChar("*")
xBool := new MfBool(true)
xByte := new MfByte(1)
xInt16 := new MfInt16(2)
xInt32 := new MfInteger(3)
xInt64 := new MfInt64(4)
int := 5
fDouble := 6.6 + 0.0 ; adding 0.0 will force default formating for FloatFast
xDouble := new MfFloat(7.7)
xUInt16 := new MfUInt16(8)
xUInt32 := new MfUInt32(9)
xUInt64 := new MfUInt64(10)
xSByte := new MfSByte(-11)
sb := new MfText.StringBuilder("StringBuilder.Insert method")
sb.AppendLine()
sb1 := new MfText.StringBuilder(initialValue)
sb1.Insert(3, xyz, 2)
sb.Append(" 1 = ").AppendLine(sb1.ToString())
sb1.Clear().Append(initialValue)
sb1.Insert(3, xyz)
sb.Append(" 2 = ").AppendLine(sb1.ToString())
sb1.Clear().Append(initialValue)
sb1.Insert(3, star)
sb.Append(" 3 = ").AppendLine(sb1.ToString())
sb1.Clear().Append(initialValue)
sb1.Insert(3, abc)
sb.Append(" 4 = ").AppendLine(sb1.ToString())
sb1.Clear().Append(initialValue)
sb1.Insert(3, abc, 1, 2)
sb.Append(" 5 = ").AppendLine(sb1.ToString())
sb1.Clear().Append(initialValue)
sb1.Insert(3, xBool) ; True
sb.Append(" 6 = ").AppendLine(sb1.ToString())
sb1.Clear().Append(initialValue)
sb1.Insert(3, xByte) ; 1
sb.Append(" 7 = ").AppendLine(sb1.ToString())
sb1.Clear().Append(initialValue)
sb1.Insert(3, xInt16) ; 2
sb.Append(" 8 = ").AppendLine(sb1.ToString())
sb1.Clear().Append(initialValue)
sb1.Insert(3, xInt32) ; 3
sb.Append(" 9 = ").AppendLine(sb1.ToString())
sb1.Clear().Append(initialValue)
sb1.Insert(3, xInt64) ; 4
sb.Append("10 = ").AppendLine(sb1.ToString())
sb1.Clear().Append(initialValue)
sb1.Insert(3, int) ; 5
sb.Append("11 = ").AppendLine(sb1.ToString())
sb1.Clear().Append(initialValue)
sb1.Insert(3, fDouble) ; 6.6
sb.Append("12 = ").AppendLine(sb1.ToString())
sb1.Clear().Append(initialValue)
sb1.Insert(3, xDouble) ; 7.7
sb.Append("13 = ").AppendLine(sb1.ToString())
sb1.Clear().Append(initialValue)
sb1.Insert(3, xUInt16) ; 8
sb.Append("14 = ").AppendLine(sb1.ToString())
sb1.Clear().Append(initialValue)
sb1.Insert(3, xUInt32) ; 9
sb.Append("15 = ").AppendLine(sb1.ToString())
sb1.Clear().Append(initialValue)
sb1.Insert(3, xUInt64) ; 10
sb.Append("16 = ").AppendLine(sb1.ToString())
sb1.Clear().Append(initialValue)
sb1.Insert(3, xSByte) ; -11
sb.Append("17 = ").Append(sb1.ToString())
MsgBox % sb.ToString()
/*
StringBuilder.Insert method
1 = --[xyzxyz]--
2 = --[xyz]--
3 = --[*]--
4 = --[abc]--
5 = --[bc]--
6 = --[True]--
7 = --[1]--
8 = --[2]--
9 = --[3]--
10 = --[4]--
11 = --[5]--
12 = --[6.600000]--
13 = --[7.7]--
14 = --[8]--
15 = --[9]--
16 = --[10]--
17 = --[-11]--
*/