# SUBSTRING

> الدالة SUBSTRING في StackQL (الاسم المستعار SUBSTR): إرجاع جزء من سلسلة نصية أو قيمة ثنائية حسب موضع البداية والطول.

Source: https://stackql.io/ar/language-spec/functions/string/substring

تعيد جزءًا من تعبير حرفي أو ثنائي. الدالة `SUBSTR` اسم مستعار للدالة `SUBSTRING`.

راجع أيضًا:  
[[` SELECT `]](/language-spec/select) [[ أنواع البيانات ]](/language-spec/data-types)

* * * 

:::info

لاستخراج حقل من كائن JSON، استخدم الدالة [**JSON_EXTRACT**](/language-spec/functions/json/json_extract).

:::

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

```sql
SELECT SUBSTRING(expression, start[, length]) FROM <multipartIdentifier>;
SELECT SUBSTR(expression, start[, length]) FROM <multipartIdentifier>;
```

## الوسيطات

__*expression*__  
سلسلة نصية بترميز ASCII أو قيمة من نوع BLOB.

> إذا كانت *expression* سلسلة نصية، فإن فهارس الأحرف تشير إلى أحرف UTF-8 الفعلية. إذا كانت *expression* من نوع BLOB، فإن الفهارس تشير إلى البايتات.

__*start*__  
عدد صحيح يمثل الحرف أو البايت الأول من التسلسل الفرعي المراد إرجاعه من تعبير الإدخال. إذا كانت *start* سالبة، فيتم تحديد الحرف الأول من السلسلة الفرعية بالعد من اليمين وليس من اليسار.

> الحرف الموجود في أقصى يسار *expression* هو الحرف رقم 1.

__*length*__  
قيمة اختيارية من نوع عدد صحيح تمثل طول التسلسل الفرعي المراد إرجاعه بعد قيمة *start*. إذا لم يتم تحديد *length*، فإن الدالة تعيد جميع الأحرف حتى نهاية السلسلة النصية أو قيمة BLOB التي تحددها *expression*.

> إذا كانت *length* سالبة، فيتم استخدام القيمة المطلقة للوسيطة *length*.

## القيمة المرجعة

تعيد قيمة من نوع سلسلة نصية أو BLOB حسب نوع *expression*.

* * *

## أمثلة

### إرجاع أول *n* أحرف من عمود

```sql
SELECT SUBSTRING(name, 1, 5) as "first five chars" 
FROM google.compute.instances 
WHERE project = 'stackql-demo' 
AND zone = 'australia-southeast1-a';
```

### اقتطاع أول *n* أحرف من عمود

```sql
SELECT SUBSTR(name, 5) as "from char 5" 
FROM google.compute.instances 
WHERE project = 'stackql-demo' 
AND zone = 'australia-southeast1-a';
```

### إرجاع آخر *n* أحرف من عمود

```sql
SELECT SUBSTRING(name, -5) as "last five chars" 
FROM google.compute.instances 
WHERE project = 'stackql-demo' 
AND zone = 'australia-southeast1-a';
```

لمزيد من المعلومات، راجع [https://www.sqlite.org/lang_corefunc.html#substr](https://www.sqlite.org/lang_corefunc.html#substr)
