مشاركة عبر

regexp_substr دالة

  • مقالة

ينطبق على: وضع علامة Databricks SQL وضع علامة Databricks Runtime 11.3 LTS وما فوق

إرجاع السلسلة الفرعية الأولى في str التي تطابق regexp.

بناء الجملة

regexp_substr( str, regexp )

الوسيطات

  • strSTRING: تعبير يجب مطابقته.
  • regexpSTRING: تعبير ذو نمط.

المرتجعات

STRING.

regexp يجب أن تكون السلسلة تعبير Java عادي. القيم الحرفية للسلسلة غير مغلفة. على سبيل المثال، لمطابقة '\abc'، يمكن أن يكون '^\\abc$'التعبير العادي ل regexp .

في حالة وجود خطأ regexp في الدالة، ترجع الدالة خطأ INVALID_PARAMETER_VALUE .

إذا كانت إحدى الوسيطتين أو NULL لم يتم العثور على النمط، تكون النتيجة NULL.

الأمثلة

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

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

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

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