locate function (Databricks SQL)

Returns the position of the first occurrence of substr in str after position pos.

Syntax

locate(substr, str [, pos] )

Arguments

  • subtr: A STRING expression.

  • str: A STRING expression.

  • pos: An optional INTEGER expression.

Returns

An INTEGER.

The specified pos and return value are 1-based. If pos is omitted substr is searched from the beginning of str. If pos is less than 1 the result is 0.

This function is a synonym for position function (Databricks SQL).

Examples

> SELECT locate('bar', 'foobarbar');
 4
> SELECT locate('bar', 'foobarbar', 5);
 7