# REGEXP

> مطابقة الأنماط في السلاسل النصية بالتعبيرات النمطية باستخدام SQL في StackQL.

Source: https://stackql.io/ar/language-spec/functions/re/regexp

يتحقق مما إذا كانت السلسلة النصية المصدر تطابق نمط التعبير النمطي المقدم.

راجع أيضًا:  
[[`SELECT`]](/language-spec/select)

* * * 

## بناء الجملة

```sql
SELECT source_string REGEXP pattern_expression AS match_result FROM <multipartIdentifier>;
```

## الوسيطات

__*source_string*__  
السلسلة النصية التي يتم البحث فيها عن النمط.

__*pattern_expression*__  
نمط التعبير النمطي المراد مطابقته مع السلسلة النصية المصدر.

## القيمة المرجعة
يعيد قيمة منطقية: `TRUE` إذا كانت السلسلة النصية المصدر تطابق نمط التعبير النمطي، وإلا `FALSE`.

* * *

## أمثلة

### التحقق مما إذا كانت سلسلة نصية تحتوي على أرقام

يوضح هذا المثال التحقق مما إذا كانت السلسلة النصية 'the year is 2021' تحتوي على حرف رقمي واحد أو أكثر:

```sql
SELECT 'the year is 2021' REGEXP '[0-9]+' AS match_result;
```

سيعيد هذا الاستعلام `TRUE` لأن السلسلة النصية تحتوي على السلسلة الفرعية '2021'، التي تطابق النمط `[0-9]+`، الذي يشير إلى رقم واحد أو أكثر.

### التحقق من صحة تنسيق البريد الإلكتروني

للتحقق مما إذا كانت سلسلة نصية بتنسيق بريد إلكتروني صالح:

```sql
SELECT 'user@example.com' REGEXP '^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}$' AS match_result;
```

يعيد هذا الاستعلام `TRUE`، مما يشير إلى أن 'user@example.com' منسق مثل عنوان بريد إلكتروني نموذجي، إذ يطابق نمط التعبير النمطي المحدد.
