LastIndexOf()
Reports the zero-based index position of the last occurrence of a specified Unicode character or string within this instance. The method returns -1 if the character or string is not found in this instance.
OutputVar := instance.LastIndexOf(searchChar)
OutputVar := instance.LastIndexOf(searchChar, startIndex)
OutputVar := instance.LastIndexOf(searchChar, startIndex, count)
OutputVar := instance.LastIndexOf(strSearch)
OutputVar := instance.LastIndexOf(strSearch, startIndex)
OutputVar := instance.LastIndexOf(strSearch, startIndex, count)
OutputVar := MfString.LastIndexOf(strMain, searchChar)
OutputVar := MfString.LastIndexOf(strMain, searchChar, startIndex)
OutputVar := MfString.LastIndexOf(strMain, searchChar, startIndex, count)
OutputVar := MfString.LastIndexOf(strMain, strSearch)
OutputVar := MfString.LastIndexOf(strMain, strSearch, startIndex)
OutputVar := MfString.LastIndexOf(strMain, strSearch, startIndex, count)
Reports the zero-based index position of the last occurrence of a character specified by searchChar within this instance.
searchChar
The Character to seek.
Can be instance of MfChar or string var containing character.
Returns a zero-based index value as var containing Integer of the last position of the searchChar in current instance of MfString, If SearchChar is not found value of -1 is returned.
Reports the zero-based index position of the last occurrence of a character specified by searchChar within this instance. The search starts at a character position specified by startIndex.
searchChar
The Character to seek.
Can be instance of MfChar or string var containing character.
startIndex
An integer representing the starting position of the search.
Can be MfInteger instance or var containing integer.
Returns a zero-based index value as var containing Integer of the last position of the searchChar in current instance of MfString, If SearchChar is not found value of -1 is returned.
Reports the zero-based index position of the last occurrence of a character specified by searchChar within this instance. The search starts at a character position specified by startIndex and examines a number of character positions specified by count.
searchChar
The Character to seek.
Can be instance of MfChar or string var containing character.
startIndex
An integer representing the starting position of the search.
Can be MfInteger instance or var containing integer.
count
An integer representing the number of character positions to examine.
Can be MfInteger instance or var containing integer.
Returns a zero-based index value as var containing Integer of the last position of the searchChar in current instance of MfString, If SearchChar is not found value of -1 is returned.
Reports the zero-based index position of the last occurrence of a string specified by strSearch within this instance.
strSearch
The string to seek.
Can be MfString instance or var containing string.
Returns a zero-based index value as var containing Integer of the last position of the strSearch in current instance of MfString, If strSearch is not found value of -1 is returned.
Reports the zero-based index position of the last occurrence of a string specified by strSearch within this instance. The search starts at a character specified by startIndex position.
strSearch
The string to seek.
Can be MfString instance or var containing string.
startIndex
An integer representing the starting position of the search.
Can be MfInteger instance or var containing integer.
Returns a zero-based index value as var containing Integer of the last position of the strSearch in current instance of MfString, If strSearch is not found value of -1 is returned.
Reports the zero-based index position of the last occurrence of a string specified by strSearch within this instance. The search starts at a character specified by startIndex position and examines a number of character positions specified by count.
strSearch
The string to seek.
Can be MfString instance or var containing string.
startIndex
An integer representing the starting position of the search.
Can be MfInteger instance or var containing integer.
count
An integer representing the number of character positions to examine.
Can be MfInteger instance or var containing integer.
Returns a zero-based index value as var containing Integer of the last position of the strSearch in current instance of MfString, If strSearch is not found value of -1 is returned.
Static Method
Reports the zero-based index position of the last occurrence of a character specified by searchChar within strMain.
strMain
The main String to search for last index of specified parameters.
Can be MfString instance or var containing string.
searchChar
The Character to seek.
Can be instance of MfChar or string var containing character.
Returns a zero-based index value as var containing Integer of the last position of the searchChar in strMain. If searchChar is not found value of -1 is returned.
Static Method
Reports the zero-based index position of the last occurrence of a character specified by searchChar within strMain. The search starts at a character specified by startIndex position.
strMain
The main String to search for last index of specified parameters.
Can be MfString instance or var containing string.
searchChar
The Character to seek.
Can be instance of MfChar or string var containing character.
startIndex
An integer representing the starting position of the search.
Can be MfInteger instance or var containing integer.
Returns a zero-based index value as var containing Integer of the last position of the searchChar in strMain. If searchChar is not found value of -1 is returned.
Static Method
Reports the zero-based index position of the last occurrence of a character specified by searchChar within strMain. The search starts at a character specified by startIndex position and examines a number of character positions specified by count.
strMain
The main String to search for last index of specified parameters.
Can be MfString instance or var containing string.
searchChar
The Character to seek.
Can be instance of MfChar or string var containing character.
startIndex
an integer representing the starting position of the search.
Can be MfInteger instance or var containing integer.
count
An integer representing the number of character positions to examine.
Can be MfInteger instance or var containing integer.
Returns a zero-based index value as var containing Integer of the last position of the searchChar in strMain. If searchChar is not found value of -1 is returned.
Static Method
Reports the zero-based index position of the last occurrence strSearch within strMain.
strMain
The main String to search for last index of specified parameters.
Can be MfString instance or var containing string.
strSearch
The string to seek.
Can be MfString instance or var containing string.
Returns a zero-based index value as var containing Integer of the last position of the strSearch in strMain. If strSearch is not found value of -1 is returned.
Static Method.
Reports the zero-based index position of the last occurrence strSearch within this strMain. The search starts at character position specified by startIndex.
strMain
The main String to search for last index of specified parameters.
Can be MfString instance or var containing string.
strSearch
The string to seek.
Can be MfString instance or var containing string.
startIndex
An integer representing the starting position of the search.
Can be MfInteger instance or var containing integer.
Returns a zero-based index value as var containing Integer of the last position of the strSearch in strMain. If strSearch is not found value of -1 is returned.
Static Method.
Reports the zero-based index position of the last occurrence strSearch within this strMain. The search starts at character position specified by startIndex and examines a number of character positions specified by count.
strMain
The main String to search for last index of specified parameters.
Can be MfString instance or var containing string.
strSearch
The string to seek.
Can be MfString instance or var containing string.
startIndex
An integer representing the starting position of the search.
Can be MfInteger instance or var containing integer.
count
An integer representing the number of character positions to examine.
Can be MfInteger instance or var containing integer.
Returns a zero-based index value as var containing Integer of the last position of the strSearch in strMain. If strSearch is not found value of -1 is returned.
Index numbering starts from 0 (zero).
Method is not affected ReturnAsObject Property.
Overloads method supports using all vars or all objects. Mixing of vars and Objects is supported for this method.
Instance methods will obey IgnoreCase property. For static methods if strMain is an instance of MfString then the IgnoreCase property of that instance is used. If strMain is a var then case is ignored unless AutoHotkey built in variable A_StringCaseSense value is set to On by using AutoHotkeys StringCaseSense command.
Variadic Method; This method is Variadic so you may construct an instance of MfParams containing any of the overload method parameters listed above and pass in the MfParams instance to the method instead of using the overloads described above. See MfParams for more information.
Throws MfNotSupportedException if Overloads can not match Parameters.
Throws MfNullReferenceException if MfString is not an instance.
Throws MfArgumentException if there is an error get a value from a parameter.
Throws MfArgumentOutOfRangeException if startIndex is out of range.
; Static method example
str := "Now is the time for all good men to come to the aid of their party."
result := MfString.LastIndexOf(str, "he")
MsgBox The index of he:%result% ; displays - The index of he:56
result := MfString.LastIndexOf(str, ".")
MsgBox The index of he:%result% ; displays - The index of he:66
result := MfString.LastIndexOf(str, "he", 44)
MsgBox The index of he:%result% ; displays - The index of he:8
result := MfString.LastIndexOf(str, "he", 54, 10)
MsgBox The index of he:%result% ; displays - The index of he:45
strMain := new MfString(str)
searchStr := new MfString("he")
startIndex := new MfInteger(54)
count := new MfInteger(10)
result := MfString.LastIndexOf(strMain, searchStr, startIndex, count)
MsgBox The index of he:%result% ; displays - The index of he:45
; ----------------------------------------------------------------------------------------
; instance method examples
str := new MfString("Now is the time for all good men to come to the aid of their party.")
result := str.LastIndexOf("he")
MsgBox The index of he:%result% ; displays - The index of he:56
result := str.LastIndexOf(new MfChar("."))
MsgBox The index of he:%result% ; displays - The index of he:66
result := str.LastIndexOf(".")
MsgBox The index of he:%result% ; displays - The index of he:66
result := str.LastIndexOf("he", 44)
MsgBox The index of he:%result% ; displays - The index of he:8
result := str.LastIndexOf("he", 54, 10)
MsgBox The index of he:%result% ; displays - The index of he:45
searchStr := new MfString("he")
startIndex := new MfInteger(54)
count := new MfInteger(10)
result := str.LastIndexOf(searchStr, startIndex, count)
MsgBox The index of he:%result% ; displays - The index of he:45
; ----------------------------------------------------------------------------------------
br1 := new MfString("0----+----1----+----2----+----3----+----4----+----5----+----6----+-")
br2 := new MfString("0123456789012345678901234567890123456789012345678901234567890123456")
str := new MfString("Now is the time for all good men to come to the aid of their party.")
start := new MfInteger()
at := new MfInteger()
count := new MfInteger()
end := new MfInteger()
start.Value := str.Length - 1
end.Value := ((start.Value / 2) - 1)
strMsg := new MfString()
strMsg.Value := MfString.Format("All occurrences of 'he' from position {0} to {1}.", start, end.Value - 1)
strMsg.AppendLine(MfString.Format("{0}{0}{1}{0}{2}{0}{3}{0}", MfEnvironment.Instance.NewLine, br1, br2, str))
strMsg.Append("The string 'he' occurs at position(s): ")
count.Value := 0
at.Value := 0
while ((start.Value > -1) && (at.Value > -1))
{
count.Value := start.Value - end.Value ; Count must be within the substring.
at.Value := str.LastIndexOf("he", start, count)
if (at.Value > -1)
{
strMsg.Append(MfString.Format("{0} ", at))
start.Value := at.Value - 1
}
}
MsgBox % strMsg.Value ; msg contains the following:
/*
All occurrences of 'he' from position 66 to 31.
0----+----1----+----2----+----3----+----4----+----5----+----6----+-
0123456789012345678901234567890123456789012345678901234567890123456
Now is the time for all good men to come to the aid of their party.
The string 'he' occurs at position(s): 56 45
*/