متى تستخدم هذه الدوال؟
استخدم هذه الدوال لجمع القيم ومقارنة الحدود وتقريب النتائج وحساب النسب. وهي متاحة كدوال وكتحويلات.طريقة الكتابة
استخدم الدالة بصيغةround($.requested_amount, 2). لا تكون كل دالة متاحة في كل مكان: دوال التحقق ودوال النموذج ودوال قالب المستند لها عقود سياق مختلفة. لا تفترض أن اقتراح المحرر يعني أن الدالة مدعومة وقت التشغيل.
مرجع الدوال الكامل
abs
تعيد القيمة المطلقة للعدد، أي قيمته دون الإشارة السالبة.
التوقيع: abs(x)
مثال:
value | abs(...).
acos
تعيد جيب التمام العكسي للقيمة بوحدة الراديان.
التوقيع: acos(x)
مثال:
value | acos(...).
asin
تعيد الجيب العكسي للقيمة بوحدة الراديان.
التوقيع: asin(x)
مثال:
value | asin(...).
atan
تعيد الظل العكسي للقيمة بوحدة الراديان.
التوقيع: atan(x)
مثال:
value | atan(...).
atan2
تعيد الزاوية من إحداثيي y وx بوحدة الراديان مع المحافظة على الربع الصحيح.
التوقيع: atan2(y, x)
مثال:
value | atan2(...).
avg
تعيد المتوسط الحسابي للقيم المعطاة.
التوقيع: avg(...values)
مثال:
value | avg(...).
cbrt
تعيد الجذر التكعيبي للعدد.
التوقيع: cbrt(x)
مثال:
value | cbrt(...).
ceil
تقرب العدد إلى الأعلى، ويمكن ضبط دقة التقريب.
التوقيع: ceil(x, precision?)
مثال:
value | ceil(...).
clamp
تحصر القيمة بين حد أدنى وحد أقصى شاملين.
التوقيع: clamp(value, min, max)
مثال:
value | clamp(...).
cos
تعيد جيب تمام الزاوية بالراديان.
التوقيع: cos(x)
مثال:
value | cos(...).
exp
تعيد قيمة العدد الطبيعي e مرفوعاً إلى الأس المعطى.
التوقيع: exp(x)
مثال:
value | exp(...).
factorial
تعيد مضروب عدد صحيح غير سالب.
التوقيع: factorial(n)
مثال:
value | factorial(...).
floor
تقرب العدد إلى الأسفل، ويمكن ضبط دقة التقريب.
التوقيع: floor(x, precision?)
مثال:
value | floor(...).
gcd
تعيد أكبر قاسم مشترك لعددين.
التوقيع: gcd(a, b)
مثال:
value | gcd(...).
isPrime
تتحقق من كون عدد صحيح أكبر من واحد عدداً أولياً.
التوقيع: isPrime(n)
مثال:
value | isPrime(...).
lcm
تعيد أصغر مضاعف مشترك لعددين.
التوقيع: lcm(a, b)
مثال:
value | lcm(...).
lerp
تعيد قيمة بالاستيفاء الخطي بين البداية والنهاية وفق النسبة المعطاة.
التوقيع: lerp(start, end, t)
مثال:
value | lerp(...).
log
تعيد اللوغاريتم الطبيعي للعدد.
التوقيع: log(x)
مثال:
value | log(...).
log10
تعيد لوغاريتم العدد للأساس 10.
التوقيع: log10(x)
مثال:
value | log10(...).
log2
تعيد لوغاريتم العدد للأساس 2.
التوقيع: log2(x)
مثال:
value | log2(...).
median
تعيد الوسيط للقيم الرقمية المعطاة.
التوقيع: median(...values)
مثال:
value | median(...).
mode
تعيد القيمة الأكثر تكراراً بين القيم المعطاة.
التوقيع: mode(...values)
مثال:
value | mode(...).
pow
تعيد الأساس مرفوعاً إلى الأس المعطى.
التوقيع: pow(base, exponent)
مثال:
value | pow(...).
random
تعيد عدداً عشوائياً شبه عشوائي بين 0 و1. لا تستخدمه في قرار محفوظ أو رقم مرجعي يحتاج إلى ثبات.
التوقيع: random()
مثال:
value | random(...).
round
تقرب العدد إلى أقرب قيمة، ويمكن ضبط عدد المنازل العشرية.
التوقيع: round(x, precision?)
مثال:
value | round(...).
roundTo
تقرب القيمة إلى عدد محدد من المنازل العشرية.
التوقيع: roundTo(value, decimals)
مثال:
value | roundTo(...).
sign
تعيد -1 أو 0 أو 1 بحسب إشارة العدد.
التوقيع: sign(x)
مثال:
value | sign(...).
sin
تعيد جيب الزاوية بالراديان.
التوقيع: sin(x)
مثال:
value | sin(...).
sqrt
تعيد الجذر التربيعي للعدد غير السالب.
التوقيع: sqrt(x)
مثال:
value | sqrt(...).
stddev
تعيد الانحراف المعياري للقيم الرقمية المعطاة.
التوقيع: stddev(...values)
مثال:
value | stddev(...).
tan
تعيد ظل الزاوية بالراديان.
التوقيع: tan(x)
مثال:
value | tan(...).
toDegrees
تحول زاوية من الراديان إلى الدرجات.
التوقيع: toDegrees(radians)
مثال:
value | toDegrees(...).
toRadians
تحول زاوية من الدرجات إلى الراديان.
التوقيع: toRadians(degrees)
مثال:
value | toRadians(...).
trunc
تحذف الجزء العشري من العدد دون تقريب.
التوقيع: trunc(x)
مثال:
value | trunc(...).
variance
تعيد تباين القيم الرقمية المعطاة.
التوقيع: variance(...values)
مثال:
value | variance(...).
قائمة تحقق قبل النشر
- ابدأ بقيمة معروفة وتحقق من النتيجة المتوقعة.
- تعامل صراحةً مع القيم الفارغة وnull والقوائم الفارغة.
- لا تضع أسراراً أو رموز وصول أو بيانات شخصية حساسة داخل تعبير.
- راجع سياقات وتوافر التعبيرات قبل نسخ تعبير بين ميزتين.
