# LENGTH

> الدالة LENGTH في StackQL: عدد الأحرف في سلسلة نصية، أو عدد البايتات في قيمة من نوع BLOB.

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

تعيد عدد الأحرف في تعبير إدخال من نوع سلسلة نصية قبل أول حرف `NULL`، أو عدد البايتات في تعبير من نوع BLOB.  

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

* * * 

:::info

للحصول على طول مصفوفة JSON، استخدم الدالة [**JSON_ARRAY_LENGTH**](/language-spec/functions/json/json_array_length).

:::

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

```sql
SELECT LENGTH(expression) FROM <multipartIdentifier>;
```

## الوسيطات

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

> تعيد `NULL` إذا كانت قيمة *expression* هي `NULL`.

> إذا كانت قيمة *expression* رقمية، فإن الدالة تعيد طول تمثيل *expression* كسلسلة نصية.

## القيمة المرجعة
تعيد عددًا صحيحًا.

* * *

## أمثلة

### إرجاع طول عمود من نوع سلسلة نصية

```sql
SELECT name, length(name) AS len
FROM google.compute.instances 
WHERE project = 'stackql-demo' 
AND zone = 'australia-southeast1-a';
```

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