INSTR function

The INSTR function returns the location of the nth occurrence of a specified pattern within a large object.

The function returns an INTEGER value of the position within the large object where the pattern appears for the nth time, as specified by nth. This value starts from the position given by offset.

Syntax


1  INSTR ( lob_loc , pattern?  , offset?  , nth  )

Parameters

lob_loc
An input argument of type BLOB or CLOB that specifies the large object locator of the large object in which to search for the pattern.
pattern
An input argument of type BLOB(32767) or VARCHAR(32672) that specifies the pattern of bytes or characters to match against the large object.

pattern must be BLOB if lob_loc is a BLOB; and pattern must be VARCHAR if lob_loc is a CLOB.

offset
An optional input argument of type INTEGER that specifies the position within lob_loc to start searching for the pattern. The first byte or character is at position 1. The default value is 1.
nth
An optional argument of type INTEGER that specifies the number of times to search for the pattern, starting at the position given by offset. The default value is 1.