Home
Extending HCL OneDB™Beyond standard relational database objects, HCL OneDB™ can be extended to handle specialized data types, access methods, routines, and other objects. HCL OneDB™ includes many built-in extensions that are fully integrated in the database server. HCL OneDB™ also provides DataBlade® modules, which are packages of extended database objects for a particular purpose and that are installed separately from the database server. Alternatively, you can create your own user-defined objects for HCL OneDB™.
HCL OneDB™ extensions and DataBlade® modulesThese topics describe how to use built-in database extensions and separately installed DataBlade® modules.
Database Extensions User's GuideThe HCL OneDB™ Database Extensions User's Guide explains how to use the database extensions that come with HCL OneDB™: Large Object Locator, MQ messaging, binary data types, basic text search, node data type, HCL OneDB™ web feature service for Geospatial Data, and SQL packages.
SQL Packages ExtensionThe SQL packages extension provides SPL routines that you can use in an application that is compatible with database servers other than HCL OneDB™.
DBMS_LOB packageThe DBMS_LOB package provides the capability to operate on large objects.
INSTR function The INSTR function returns the location of the nth occurrence of a specified pattern within a large object.

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

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.