regexp_instr
関数
適用対象: Databricks SQL Databricks Runtime 11.3 LTS 以降
str
の中で最初に regexp
と一致する部分文字列の位置を返します。
構文
regexp_instr( str, regexp )
引数
str
: 照合するSTRING
式。regexp
: パターンを含むSTRING
式。
返品
STRING
です。
regexp
文字列は Java の正規表現である必要があります。
文字列リテラルはエスケープされません。 たとえば、'\abc'
に一致させるには、regexp
の正規表現を '^\\abc$'
にします。
regexp
の形式に誤りがある場合、この関数は INVALID_PARAMETER_VALUE エラーを返します。
引数のどちらかが NULL
であるか、パターンが見つからない場合、結果は NULL
になります。
例
> 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