Strings.InStrRev Method (String, String, Int32, CompareMethod)

 

Returns the position of the first occurrence of one string within another, starting from the right side of the string.

Namespace:   Microsoft.VisualBasic
Assembly:  Microsoft.VisualBasic (in Microsoft.VisualBasic.dll)

Public Shared Function InStrRev (
	StringCheck As String,
	StringMatch As String,
	Start As Integer,
	Compare As CompareMethod
) As Integer

Parameters

StringCheck
Type: System.String

Required. String expression being searched.

StringMatch
Type: System.String

Required. String expression being searched for.

Start
Type: System.Int32

Optional. Numeric expression setting the one-based starting position for each search, starting from the left side of the string. If Start is omitted then –1 is used, meaning the search begins at the last character position. Search then proceeds from right to left.

Compare
Type: Microsoft.VisualBasic.CompareMethod

Optional. Numeric value indicating the kind of comparison to use when evaluating substrings. If omitted, a binary comparison is performed. See Settings for values.

Return Value

Type: System.Int32

If

InStrRev returns

StringCheck is zero-length

0

StringMatch is zero-length

Start

StringMatch is not found

0

StringMatch is found within StringCheck

Position at which the first match is found, starting with the right side of the string.

Start is greater than length of StringMatch

0

Exception Condition
ArgumentException

Start = 0 or Start < -1.

Note that the syntax for the InStrRev function is not the same as the syntax for the InStr function.

The Compare argument can have the following values.

Constant

Description

Binary

Performs a binary comparison.

Text

Performs a textual comparison.

This example demonstrates the use of the InStrRev function.

Dim TestString As String = "the quick brown fox jumps over the lazy dog"
Dim TestNumber As Integer
' Returns 32.
TestNumber = InStrRev(TestString, "the")
' Returns 1.
TestNumber = InStrRev(TestString, "the", 16)

.NET Framework
Available since 1.1
Silverlight
Available since 2.0
Return to top
Show: