Skip to main content

position function

Applies to: check marked yes Databricks SQL check marked yes Databricks Runtime

Returns the position of the first occurrence of substr in str after position pos. This function is a synonym for locate function.

Syntax​

position(substr, str [, pos] )
position(subtr IN str)

Arguments​

  • substr: A STRING expression.
  • str: A STRING expression.
  • pos: An 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.

Examples​

SQL
> SELECT position('bar', 'abcbarbar');
 4

> SELECT position('bar', 'abcbarbar', 5);
 7

> SELECT position('bar' IN 'abcbarbar');
 4

> SELECT position('BAR' COLLATE UTF8_BINARY, 'abcbarbar');
 0

> SELECT position('BAR' COLLATE UTF8_LCASE, 'abcbarbar');
 4
Last updated on