SHIP:Sail:lastIndexOf

Function	Returns	Introduced	Description
lastIndexOf	Integer	v4.0	Returns the index of the last found occurrence (if any) of a substring within another string, optionally starting at a specified offset. If the substring is not found, -1 is returned.

See Also:

• Sail Home
• Sail Functions
• Sail String Functions
• indexOf, subStr, subString, toString

Prototype

Integer lastIndexOf(String original,String tofind);

Integer lastIndexOf(String original,String tofind, Integer offset);

Parameters/Return Value

Parameter	Data Type	Description
original	String	String to search in
tofind	String	String to find in original
offset	Integer	index in original string 0...(length-1)
Return	Integer	Index of last occurrence of tofind in original, or -1 if not found

Detailed Description

The lastIndexOf function returns the index in the original string of last occurrence of the string tofind in the original string, or -1 if the string is not found.

An optional offset may be specified, which specifies that the search in the original string begins at that specified offset. If the offset is negative, the search will begin at offset 0. If the offset is past the end of the original string, the function will always return -1.

Examples

Example	Result	Notes
lastIndexOf("feb","janfebmar");	3
lastIndexOf("feb","janfebmarfeb");	9	returns last found
lastIndexOf("feb","janfebmar",4);	-1	starts searching on "ebmar"
lastIndexOf("feb","janfebmar",-1);	3	starts searching at 0
lastIndexOf("feb","janfebmar",23);	-1	past end, always returns -1