# REGEXP_SUBSTR

> الدالة REGEXP_SUBSTR في StackQL: استخراج السلسلة الفرعية المطابقة لتعبير نمطي من قيمة إدخال.

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

تعيد سلسلة فرعية من سلسلة الإدخال مطابقة لنمط محدد.  

راجع أيضًا:  
[[` SELECT `]](/language-spec/select) [[ مرجع التعبيرات النمطية ]](/language-spec/functions/re/reference) 

* * * 

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

```sql
SELECT REGEXP_SUBSTR(source, pattern) FROM <multipartIdentifier>;
```

## الوسيطات

__*source*__  
قيمة حرفية نصية أو عمود من نوع السلسلة النصية تريد استخراج سلسلة فرعية منه وفق نمط يحدده تعبير نمطي (`pattern`).  

__*pattern*__  
نمط التعبير النمطي المراد البحث عنه.  

## القيمة المرجعة
تعيد سلسلة نصية.

* * *

## أمثلة

### استخراج سلسلة فرعية وفق تعبير نمطي

**StackQL**

```sql
select name,
json_extract(properties, '$.storageProfile.imageReference.offer') as os,
regexp_substr(
  json_extract(properties, '$.storageProfile.imageReference.exactVersion'), 
  '[0-9][0-9]\.[0-9][0-9]') as os_version 
from azure.compute.virtual_machines 
WHERE subscription_id = '273769f6-545f-45b2-8ab8-2f14ec5768dc';
```

**النتائج**

```
|------|---------------|------------|
| name |      os       | os_version |
|------|---------------|------------|
| vm0  | UbuntuServer  |      16.04 |
|------|---------------|------------|
| vm1  | UbuntuServer  |      16.04 |
|------|---------------|------------|
| vm2  | UbuntuServer  |      20.04 |
|------|---------------|------------|
```

لمزيد من المعلومات، راجع [https://github.com/nalgeon/sqlean/blob/main/docs/re.md](https://github.com/nalgeon/sqlean/blob/main/docs/re.md)
