LsE5y‖

hv79s‖InStr Function

b3faC‖Returns the position of a string within another string.

2DD3h‖The Instr function returns the position at which the match was found. If the string was not found, the function returns 0.

FVEx2‖Syntax:


r8bGy‖InStr ([Start As Long,] String1 As String, String2 As String[, Compare As Integer]) As Integer

bBBqF‖Return type:

Integer

WADQ4‖Parameters:

NMwGq‖ Start: A numeric expression that marks the position in a string where the search for the specified substring starts. If you omit this parameter, the search starts at the first character of the string. The minimum allowed value is 1. The maximum allowed value is 2,147,483,648.

8gTeL‖ String1: The string expression being searched.

oGf6D‖ String2: The string expression that you want to search for.

EU6NP‖ Compare: Optional type of comparison. The value can be 0 or 1. The default value of 1 specifies case-insensitive. The value of 0 specifies case-sensitive.

note

Tn5if‖Case-insensitive comparison may use locale specifics, for example, "s" may match "β".


R5Ars‖To avoid a run-time error, do not set the Compare parameter if the Start parameter is omitted.

SEjHR‖Error codes:

5 Invalid procedure call

gRVcn‖Example:


Sub ExamplePosition
  Const sCalc = "LibreOffice Calc"

A5Ggy‖  Instr(sCalc, "calc")     ' returns 13
xamod‖  Instr(String1:=sCalc, String2:="calc", Start:=1)  ' returns 13
bxLXr‖  Instr(11, sCalc, "c")     ' returns 13
9dDUE‖  Instr(11, sCalc, "c",  1) ' returns 13
GECjT‖  Instr(11, sCalc, "c",  0) ' returns 16
End Sub