> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# قواعد كتابة الصيغ

تتكوّن قواعد كتابة الصيغ من القيم الأساسية، ومراجع الحقول، والعوامل، والدوال، والأقواس. وبعد فهم هذه العناصر، يمكنك كتابة صيغ لإجراء العمليات الحسابية، وتحديد الشروط، ومعالجة النصوص.

## العناصر الأساسية

| العنصر      | الصياغة                  | الوصف                                                     |
| ----------- | ------------------------ | --------------------------------------------------------- |
| سلسلة نصية  | `'مرحبًا'` أو `"العالم"` | نص محاط بعلامات اقتباس مفردة أو مزدوجة                    |
| عدد صحيح    | `123`، `-456`            | عدد من دون فاصلة عشرية                                    |
| عدد عشري    | `12.34`، `-45.67`        | عدد يحتوي على فاصلة عشرية                                 |
| قيمة منطقية | `TRUE`، `FALSE`          | قيمة صواب أو خطأ                                          |
| مرجع حقل    | `{العمر}`                | اسم حقل محاط بـ `{}`. يجب أن يطابق الاسم اسم الحقل الفعلي |

## العوامل

تُستخدم العوامل في الصيغ لربط القيم أو مقارنتها:

| النوع  | العوامل                         |   |    |
| ------ | ------------------------------- | - | -- |
| حسابية | `+`، `-`، `*`، `/`، `%`         |   |    |
| مقارنة | `>`، `<`، `>=`، `<=`، `=`، `!=` |   |    |
| منطقية | `&&`، \`                        |   | \` |

## استدعاءات الدوال

يمكنك استدعاء الدوال داخل الصيغ. يتكوّن استدعاء الدالة من اسم الدالة، وزوج من الأقواس، ومعاملات داخل الأقواس. وتُفصل المعاملات بفواصل.

على سبيل المثال، تستدعي `sum(1, 2, 3)` الدالة `sum` بثلاثة معاملات: 1 و2 و3.

## بُنى أخرى

| البنية                         | الوصف                                                                  |
| ------------------------------ | ---------------------------------------------------------------------- |
| الأقواس                        | تغيّر أولوية العمليات، مثل `(1 + 2) * 3`                               |
| التعليقات                      | تضيف سياقًا. تستخدم تعليقات الكتلة `/* */`، وتستخدم تعليقات السطر `//` |
| المسافات البيضاء وفواصل الأسطر | تُتجاهل عادةً، لكنها قد تجعل الصيغ أسهل قراءةً                         |