Skip to main content

متى تستخدم هذه الدوال؟

استخدم هذه الدوال عندما يعيد الحقل أو التعبير قائمة. اعتبر القائمة الفارغة حالة طبيعية وحدد بوضوح ما ينبغي أن يراه المستخدم عند غياب السجلات المرتبطة.

طريقة الكتابة

استخدم الدالة بصيغة sum($.fee_items). لا تكون كل دالة متاحة في كل مكان: دوال التحقق ودوال النموذج ودوال قالب المستند لها عقود سياق مختلفة. لا تفترض أن اقتراح المحرر يعني أن الدالة مدعومة وقت التشغيل.

مرجع الدوال الكامل

at

تعيد العنصر الموجود في الموضع المحدد من القائمة، أو قيمة فارغة إذا لم يوجد. التوقيع: at(arr, index) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | at(...).

average

تعيد المتوسط الحسابي للعناصر الرقمية في القائمة. التوقيع: average(...args) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | average(...).

chunk

تقسم القائمة إلى قوائم أصغر بالحجم المحدد. التوقيع: chunk(arr, size) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | chunk(...).

compact

تزيل القيم الفارغة أو غير الصادقة من القائمة وفق تنفيذ الدالة. التوقيع: compact(arr) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | compact(...).

concat

تضم قائمتين أو أكثر في قائمة واحدة. التوقيع: concat(...arrays) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | concat(...).

countBy

تجمع عناصر القائمة بعددها وفق مفتاح أو دالة تجميع معطاة. التوقيع: countBy(arr) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | countBy(...).

difference

تعيد العناصر الموجودة في القائمة الأولى وغير الموجودة في القوائم الأخرى. التوقيع: difference(...arrays) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | difference(...).

every

تتحقق من أن كل عناصر القائمة تحقق الشرط أو الاختبار المعطى. التوقيع: every(arr) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | every(...).

fill

تنشئ أو تعدل قائمة بملء نطاق منها بالقيمة المعطاة. التوقيع: fill(value, length) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | fill(...).

first

تعيد أول عنصر من القائمة. التوقيع: first(arr) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | first(...).

flatten

تسطح مستوى واحداً من قائمة متداخلة. التوقيع: flatten(arr) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | flatten(...).

flattenDeep

تسطح كل مستويات القائمة المتداخلة. التوقيع: flattenDeep(arr) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | flattenDeep(...).

getByPath

تقرأ قيمة متداخلة من كائن أو قائمة عبر مسار نصي آمن. التوقيع: getByPath(value, path) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | getByPath(...).

intersection

تعيد العناصر المشتركة بين القوائم المعطاة. التوقيع: intersection(...arrays) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | intersection(...).

join

تضم عناصر القائمة في نص واحد باستخدام فاصل. التوقيع: join(arr, separator?) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | join(...).

last

تعيد آخر عنصر من القائمة. التوقيع: last(arr) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | last(...).

max

تعيد أكبر قيمة من قائمة أو من قيم متغيرة العدد. هذه هي صيغة القائمة الفعالة في التسجيل النهائي. التوقيع: max(values) or max(...values) مثال:
التوافر: دالة عامة in shared builder and document-template runtimes; function and transform forms are available. ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | max(...).

min

تعيد أصغر قيمة من قائمة أو من قيم متغيرة العدد. هذه هي صيغة القائمة الفعالة في التسجيل النهائي. التوقيع: min(values) or min(...values) مثال:
التوافر: دالة عامة in shared builder and document-template runtimes; function and transform forms are available. ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | min(...).

none

تتحقق من عدم وجود أي عنصر يحقق الشرط أو الاختبار المعطى. التوقيع: none(arr) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | none(...).

range

تنشئ قائمة أرقام ضمن نطاق البداية والنهاية والخطوة المعطاة. التوقيع: range(start, end, step?) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | range(...).

sample

تعيد عنصراً عشوائياً واحداً من القائمة؛ لا تستخدمها في قرار أو قيمة يجب أن تثبت. التوقيع: sample(arr) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | sample(...).

sampleSize

تعيد عينة عشوائية بالحجم المطلوب من القائمة؛ لا تستخدمها في قيمة عمل محفوظة. التوقيع: sampleSize(arr, size) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | sampleSize(...).

shuffle

تعيد نسخة عشوائية الترتيب من القائمة؛ لا تستخدمها في رقم أو قرار يجب أن يثبت. التوقيع: shuffle(arr) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | shuffle(...).

slice

تعيد جزءاً من القائمة بين موضعي البداية والنهاية. التوقيع: slice(arr, start, end?) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | slice(...).

some

تتحقق من وجود عنصر واحد على الأقل يحقق الشرط أو الاختبار المعطى. التوقيع: some(arr) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | some(...).

sortAsc

تعيد نسخة من القائمة مرتبة تصاعدياً. التوقيع: sortAsc(arr) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | sortAsc(...).

sortBy

تعيد نسخة من قائمة الكائنات مرتبة حسب قيمة حقل محدد. التوقيع: sortBy(arr, field?, direction?) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | sortBy(...).

sortDesc

تعيد نسخة من القائمة مرتبة تنازلياً. التوقيع: sortDesc(arr) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | sortDesc(...).

sum

تجمع قيماً رقمية في قائمة أو في مدخلات متغيرة العدد. هذه هي صيغة القائمة الفعالة في التسجيل النهائي. التوقيع: sum(values) or sum(...values) مثال:
التوافر: دالة عامة in shared builder and document-template runtimes; function and transform forms are available. ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | sum(...).

union

تضم القوائم المعطاة وتزيل التكرارات. التوقيع: union(...arrays) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | union(...).

unique

تزيل العناصر المكررة من القائمة مع الاحتفاظ بالعناصر المميزة. التوقيع: unique(arr) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | unique(...).

zip

تجمع العناصر المتناظرة من قوائم متعددة في قائمة من الصفوف. التوقيع: zip(...arrays) مثال:
ملاحظة: يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: value | zip(...).

قائمة تحقق قبل النشر

  • ابدأ بقيمة معروفة وتحقق من النتيجة المتوقعة.
  • تعامل صراحةً مع القيم الفارغة وnull والقوائم الفارغة.
  • لا تضع أسراراً أو رموز وصول أو بيانات شخصية حساسة داخل تعبير.
  • راجع سياقات وتوافر التعبيرات قبل نسخ تعبير بين ميزتين.
دوال القوائم في KayanOS