Partilhar via


Função regexp_instr

Aplica-se a: Marque Sim Databricks SQL Marque Sim Databricks Runtime 11.3 LTS e superior

Devolve a posição da primeira subcadeia de caracteres que str corresponde a regexp.

Sintaxe

regexp_instr( str, regexp )

Argumentos

  • str: Uma STRING expressão a ser correspondida.
  • regexp: Uma STRING expressão com um padrão.

Devoluções

A STRING.

A regexp cadeia de caracteres deve ser uma expressão regular Java. Os literais de cadeia de caracteres não escapam. Por exemplo, para corresponder '\abc'a , uma expressão regular para regexp pode ser '^\\abc$'. No caso de uma malformação regexp , a função retorna um erro INVALID_PARAMETER_VALUE . Se o argumento for NULL ou o padrão não for encontrado, o resultado será NULL.

Exemplos

> SELECT regexp_instr('Steven Jones and Stephen Smith are the best players', 'Ste(v|ph)en');
 1

> SELECT regexp_instr('Mary had a little lamb', 'Ste(v|ph)en');
 0

> SELECT regexp_instr(NULL, 'Ste(v|ph)en');
 NULL

> SELECT regexp_instr('Mary had a little lamb', NULL);
 NULL