الدوال الرياضية

توثيق الدوال الرياضية

​

acos

أُضيف في: v1.1.0

تُرجِع دالة جيب التمام العكسي للوسيطة.

البنية

acos(x)

المعاملات

• x — القيمة المراد إيجاد جيب التمام العكسي لها. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

تعيد جيب التمام العكسي لـ x من النوع Float*

أمثلة

مثال للاستخدام

Query

SELECT acos(0.5);

Response

1.0471975511965979

​

acosh

أُضيف في: v20.12.0

يعيد جيب التمام الزائدي العكسي.

البنية

acosh(x)

الوسيطات

• x — جيب تمام الزاوية الزائدي. القيم ضمن المجال: 1 ≤ x < +∞. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

يُرجع الزاوية بالراديان. القيم ضمن المجال: 0 ≤ acosh(x) < +∞. Float64

أمثلة

مثال على الاستخدام

Query

SELECT acosh(1)

Response

0

​

asin

استُحدثت في: v1.1.0

تحسب دالة الجيب العكسي للوسيطة المقدَّمة. وبالنسبة إلى الوسائط ضمن النطاق [-1, 1]، فإنها تُرجِع قيمة ضمن النطاق [-pi() / 2, pi() / 2].

الصياغة

asin(x)

الوسائط

• x — الوسيطة المراد حساب قوس الجيب لها. (U)Int* أو Float* أو Decimal

القيمة المُعادة

تعيد قيمة قوس الجيب للوسيطة المقدَّمة x من النوع Float64

أمثلة

المعكوس

Query

SELECT asin(1.0) = pi() / 2, sin(asin(1)), asin(sin(1))

Response

1 1 1

float32

Query

SELECT toTypeName(asin(1.0::Float32))

Response

Float64

nan

Query

SELECT asin(1.1), asin(-2), asin(inf), asin(nan)

Response

nan nan nan nan

​

asinh

قُدِّم في: v20.12.0

تُرجع الجيب الزائدي العكسي.

الصيغة

asinh(x)

الوسائط

• x — الجيب الزائدي العكسي للزاوية. القيم من المجال: -∞ < x < +∞. (U)Int* أو Float* أو Decimal*

القيمة المعادة

يعيد الزاوية بوحدة الراديان. القيم من المجال: -∞ < asinh(x) < +∞. Float64

أمثلة

الاستخدام الأساسي

Query

SELECT asinh(0)

Response

0

​

atan

تم تقديمه في: v1.1.0

يُرجع الظل العكسي للوسيطة.

الصياغة

atan(x)

المعاملات

• x — القيمة المراد إيجاد الظل العكسي لها. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

الظل العكسي لـ x. Float*

أمثلة

مثال على الاستخدام

Query

SELECT atan(1);

Response

0.7853981633974483

​

atan2

أُضيفت في: v20.12.0

تعيد الدالة atan2 الزاوية في المستوى الإقليدي، مقاسةً بالراديان، بين المحور السيني الموجب والشعاع الواصل إلى النقطة (x, y) ≠ (0, 0).

الصيغة

atan2(y, x)

الوسائط

• y — الإحداثي y للنقطة التي يمرّ عبرها الشعاع. (U)Int* أو Float* أو Decimal*
• x — الإحداثي x للنقطة التي يمرّ عبرها الشعاع. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

تُرجع الزاوية θ بحيث تكون -π < θ ≤ π، بوحدة الراديان Float64

أمثلة

مثال للاستخدام

Query

SELECT atan2(1, 1)

Response

0.7853981633974483

​

atanh

أُضيفت في: v20.12.0

تعيد الظل الزائدي العكسي.

الصيغة

atanh(x)

الوسيطات

• x — الظل الزائدي للزاوية. القيم ضمن المجال: -1 < x < 1. (U)Int* أو Float* أو Decimal*. (U)Int* أو Float* أو Decimal*

القيمة المعادة

تُرجع الزاوية بالراديان. القيم ضمن المجال: -∞ < atanh(x) < +∞ Float64

أمثلة

مثال على الاستخدام

Query

SELECT atanh(0)

Response

0

​

cbrt

أُضيفت في: v1.1.0

تُرجِع الجذر التكعيبي للوسيط.

الصيغة

cbrt(x)

المعاملات

• x — القيمة المطلوب إيجاد الجذر التكعيبي لها. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

يُرجع الجذر التكعيبي لـ x. Float*

أمثلة

مثال للاستخدام

Query

SELECT cbrt(8);

Response

2

​

cos

أُضيفت في: v1.1.0

يُرجع جيب تمام الوسيطة.

الصيغة

cos(x)

المعاملات

• x — الزاوية بوحدة الراديان. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

تُرجِع جيب تمام x. Float*

أمثلة

مثال على الاستخدام

Query

SELECT cos(0);

Response

1

​

cosh

أُضيفت في: v20.12.0

تعيد جيب التمام الزائدي للوسيطة.

الصيغة

cosh(x)

الوسيطات

• x — الزاوية، مقاسة بالراديان. القيم ضمن المجال: -∞ < x < +∞. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

تُرجع قيماً ضمن المجال: 1 ≤ cosh(x) < +∞ Float64

أمثلة

الاستخدام الأساسي

Query

SELECT cosh(0)

Response

1

​

degrees

أُدرجت في: v22.2.0

تحوّل القيم من الراديان إلى درجات.

الصياغة

degrees(x)

المعاملات

• x — القيمة المُدخلة بوحدة الراديان. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

تُرجِع قيمة x بالدرجات. Float64

أمثلة

الاستخدام الأساسي

Query

SELECT degrees(3.141592653589793)

Response

180

​

e

استُحدث في: v1.1.0

يُرجع ثابت أويلر (e).

البنية

e()

المعاملات

• لا شيء.

القيمة المُعادة

يُرجع ثابت أويلر Float64

أمثلة

مثال على الاستخدام

Query

SELECT e();

Response

2.718281828459045

​

erf

تم تقديمه في: v1.1.0

إذا كانت x غير سالبة، فإن erf(x/(σ√2)) تمثل احتمال أن يأخذ متغير عشوائي ذو توزيع طبيعي وانحراف معياري σ قيمةً تبعد عن القيمة المتوقعة بأكثر من x.

الصيغة

erf(x)

الوسيطات

• x — القيمة المراد حساب قيمة دالة الخطأ لها. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

تُرجع قيمة دالة الخطأ من النوع Float*

أمثلة

قاعدة الثلاث سيغما

Query

SELECT erf(3 / sqrt(2))

Response

┌─erf(divide(3, sqrt(2)))─┐
│      0.9973002039367398 │
└─────────────────────────┘

​

erfc

استُحدثت في: v1.1.0

تعيد عددًا قريبًا من 1-erf(x) من دون فقدان الدقة عند القيم الكبيرة لـ x.

الصيغة

erfc(x)

الوسائط

• x — القيمة المطلوب إيجاد قيمة دالة الخطأ لها. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

تُرجع قيمة دالة الخطأ التكميلية Float*

أمثلة

مثال على الاستخدام

Query

SELECT erfc(0);

Response

1

​

exp

أُضيفت في: v1.1.0

تعيد قيمة e مرفوعةً إلى الأس x، حيث إن x هو الوسيط المُمرَّر إلى الدالة.

الصياغة

exp(x)

الوسيطات

• x — الأس. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

تُرجع e^x من النوع Float*

أمثلة

الاستخدام الأساسي

Query

SELECT round(exp(-1), 4)

Response

┌─round(exp(-1), 4)─┐
│            0.3679 │
└───────────────────┘

​

exp10

ظهر لأول مرة في: v1.1.0

يُرجع 10 مرفوعًا إلى أسّ الوسيطة المُعطاة.

الصيغة

exp10(x)

الوسائط

• x — الأس. (U)Int* أو Float* أو Decimal*

القيمة المعادة

يعيد القيمة 10^x من النوع Float*

أمثلة

مثال على الاستخدام

Query

SELECT exp10(2);

Response

100

​

exp2

أُضيفت في: v1.1.0

تُرجِع 2 مرفوعًا إلى أسّ المُعامِل المُعطى.

الصيغة

exp2(x)

الوسائط

• x — الأس. (U)Int* أو Float* أو Decimal*

القيمة المعادة

ترجع 2^x من النوع Float*

أمثلة

مثال على الاستخدام

Query

SELECT exp2(3);

Response

8

​

المضروب

أُضيف في: v22.11.0

يحسب مضروب قيمة عدد صحيح. مضروب العدد 0 هو 1. وبالمثل، تُرجِع الدالة factorial() القيمة 1 لأي قيمة سالبة. الحد الأقصى للقيمة الموجبة لوسيط الإدخال هو 20، وأي قيمة 21 أو أكبر ستتسبب في استثناء.

الصياغة

factorial(n)

الوسائط

• n — قيمة عدد صحيح يُراد حساب مضروبه. الحد الأقصى للقيمة هو 20. (U)Int8/16/32/64

القيمة المُعادة

يُرجع مضروب قيمة الإدخال من النوع UInt64. ويُرجع 1 إذا كانت قيمة الإدخال 0 أو أي قيمة سالبة. UInt64

أمثلة

مثال على الاستخدام

Query

factorial(10)

Response

3628800

​

hypot

أُضيفت في: v20.12.0

تُرجِع طول وتر مثلث قائم الزاوية. تتجنب الدالة Hypot المشكلات التي قد تحدث عند تربيع أعداد كبيرة جدًا أو صغيرة جدًا.

الصياغة

hypot(x, y)

الوسائط

• x — الضلع القائم الأول في مثلث قائم الزاوية. (U)Int* أو Float* أو Decimal*
• y — الضلع القائم الثاني في مثلث قائم الزاوية. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

تعيد طول الوتر في مثلث قائم الزاوية. Float64

أمثلة

الاستخدام الأساسي

Query

SELECT hypot(1, 1)

Response

1.4142135623730951

​

intExp10

أُضيفت في: v1.1.0

مماثلة لـ exp10، لكنها تُرجِع قيمة من النوع UInt64.

البنية

intExp10(x)

الوسائط

• x — الأسّ. Int* أو UInt* أو Float*

القيمة المُعادة

يعيد 10^x. UInt64

أمثلة

مثال على الاستخدام

Query

SELECT intExp10(2);

Response

100

​

intExp2

أُضيف في: v1.1.0

يشبه exp2، لكنه يُرجع قيمة من النوع UInt64.

الصيغة

intExp2(x)

الوسائط

• x — الأس. Int* أو UInt* أو Float*

القيمة المُعادة

يُرجع 2^x. UInt64

أمثلة

مثال على الاستخدام

Query

SELECT intExp2(3);

Response

8

​

isPrime

أُضيف في: v26.5.0

يعيد 1 إذا كان المُعامل عددًا أوليًا، وإلا فيعيد 0.

يستخدم bitmap بحثٍ دقيق للقيم الصغيرة واختبار Miller-Rabin حتميًا للقيم الأكبر. تكون النتيجة دقيقة مع كل نوع إدخال مدعوم.

بالنسبة إلى أنواع الأعداد الصحيحة غير الموقعة الأوسع (UInt128, UInt256)، استخدم isProbablePrime بدلًا من ذلك.

الصياغة

isPrime(n)

الوسائط

• n — عدد صحيح غير موقّع لاختبار ما إذا كان عددًا أوليًا. UInt8 أو UInt16 أو UInt32 أو UInt64

القيمة المُعادة

يعيد 1 إذا كان n عددًا أوليًا، و0 خلاف ذلك. UInt8

أمثلة

عدد أولي

Query

SELECT isPrime(17)

Response

1

عدد مركب

Query

SELECT isPrime(18)

Response

0

عدد أولي كبير من النوع UInt64

Query

SELECT isPrime(18446744073709551557)

Response

1

القيمة القصوى لـ UInt64

Query

SELECT isPrime(18446744073709551615)

Response

0

​

isProbablePrime

أُضيف في: v26.5.0

تعيد 1 إذا كانت الوسيطة على الأرجح عددًا أوليًا، و0 إذا كان عددًا مركبًا على نحوٍ مؤكد.

بالنسبة إلى UInt8 وUInt16 وUInt32 وUInt64، تكون النتيجة دقيقة وتتطابق مع isPrime. ويتم تجاهل وسيطة rounds.

بالنسبة إلى UInt128 وUInt256، تكون القيمة المعادة 1 احتمالية. وتتحكم وسيطة rounds الاختيارية في عدد جولات Miller-Rabin المستخدمة: فكلما زاد عدد الجولات، انخفض احتمال الإيجابيات الكاذبة وازداد وقت التنفيذ. ومع شواهد عشوائية موزعة بانتظام، يكون معدل الإيجابيات الكاذبة لعدد مركب ثابت محدودًا بـ 4^(-rounds)؛ وتُبقي القيمة الافتراضية 25 هذا الحد دون 10^-15، بينما تُبقيه القيمة القصوى 256 دون 10^-154.

الدالة حتمية: إذ تُشتق الشواهد من n، لذا فإن الزوج نفسه (n, rounds) ينتج دائمًا النتيجة نفسها. ويمثل الحد 4^(-rounds) احتمالًا لكل مُدخل عند استخدام شواهد عشوائية موزعة بانتظام؛ أما مع الاشتقاق الحتمي الذي نعتمده، فهو يصف بدلًا من ذلك نسبةً عبر المُدخلات — فالعدد المركب الذي يخدع تسلسل شواهده سيُرجع 1 بصورة قابلة للتكرار.

الصيغة

isProbablePrime(n[, rounds])

المعاملات

• n — عدد صحيح غير موقّع لاختبار ما إذا كان أوليًا. UInt8 أو UInt16 أو UInt32 أو UInt64 أو UInt128 أو UInt256
• rounds — ثابت اختياري لعدد صحيح موجب ضمن [1, 256]. عدد جولات Miller-Rabin لـ UInt128/UInt256 (ويُتجاهل للأنواع الأضيق). القيمة الافتراضية 25. UInt8 أو UInt16 أو UInt32 أو UInt64

القيمة المُعادة

تُعيد 1 إذا كان n على الأرجح عددًا أوليًا، و0 إذا كان عددًا مركبًا بالتأكيد. UInt8

أمثلة

عدد أولي صغير

Query

SELECT isProbablePrime(17)

Response

1

مركّب صغير

Query

SELECT isProbablePrime(18)

Response

0

أكبر عدد أولي من النوع UInt64 (نتيجة دقيقة)

Query

SELECT isProbablePrime(18446744073709551557)

Response

1

عدد ميرسين الأولي M_127 (UInt128)

Query

SELECT isProbablePrime(toUInt128('170141183460469231731687303715884105727'))

Response

1

العدد الأولي للحقل الأساسي لـ Curve25519 2^255 - 19 (UInt256)

Query

SELECT isProbablePrime(toUInt256('57896044618658097711785492504343953926634992332820282019728792003956564819949'))

Response

1

اختبار أسرع بثقة أقل: 5 جولات

Query

SELECT isProbablePrime(toUInt256('57896044618658097711785492504343953926634992332820282019728792003956564819949'), 5)

Response

1

​

lgamma

قُدِّمت في: v1.1.0

تعيد لوغاريتم دالة غاما.

الصيغة

lgamma(x)

الوسائط

• x — العدد المراد حساب لوغاريتم دالة غاما له. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

يُرجع لوغاريتم دالة غاما لـ x. Float*

أمثلة

مثال للاستخدام

Query

SELECT lgamma(5);

Response

3.1780538303479458

​

log

قُدِّم في: v1.1.0

يعيد اللوغاريتم الطبيعي للوسيطة.

الصياغة

log(x)

الأسماء المستعارة: ln

المعاملات

• x — العدد المراد حساب اللوغاريتم الطبيعي له. (U)Int* أو Float* أو Decimal*

القيمة المعادة

تعيد اللوغاريتم الطبيعي لـ x. Float*

أمثلة

مثال على الاستخدام

Query

SELECT log(10);

Response

2.302585092994046

​

log10

قُدِّم في: v1.1.0

يعيد اللوغاريتم العشري للوسيطة.

الصياغة

log10(x)

الوسائط

• x — العدد المراد حساب اللوغاريتم العشري له. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

اللوغاريتم العشري للعدد x. Float*

أمثلة

مثال على الاستخدام

Query

SELECT log10(100);

Response

2

​

log1p

استُحدثت في: v20.12.0

تحسب log(1+x). تكون عملية الحساب log1p(x) أدق من log(1+x) عند القيم الصغيرة لـ x.

الصيغة

log1p(x)

المعاملات

• x — قيم ضمن النطاق: -1 < x < +∞. (U)Int* أو Float* أو Decimal*

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

يعيد قيمة ضمن النطاق: -∞ < log1p(x) < +∞ Float64

أمثلة

مثال على الاستخدام

Query

SELECT log1p(0)

Response

0

​

log2

قُدِّم في: v1.1.0

يعيد اللوغاريتم الثنائي للوسيطة.

البنية

log2(x)

الوسائط

• x — العدد المراد حساب اللوغاريتم الثنائي له. (U)Int* أو Float* أو Decimal*

القيمة المعادة

يُرجع اللوغاريتم الثنائي لـ x. Float*

أمثلة

مثال على الاستخدام

Query

SELECT log2(8);

Response

3

​

pi

تم تقديمها في: v1.1.0

تعيد pi‏ (π).

الصيغة

pi()

المعاملات

• لا شيء.

القيمة المُعادة

تعيد القيمة pi Float64

أمثلة

مثال على الاستخدام

Query

SELECT pi();

Response

3.141592653589793

​

pow

أُضيف في: v1.1.0

يُرجع x مرفوعًا للأس y.

الصيغة

pow(x, y)

الأسماء المستعارة: power

الوسيطات

• x — الأساس. (U)Int8/16/32/64 أو Float* أو Decimal*
• y — الأسّ. (U)Int8/16/32/64 أو Float* أو Decimal*

القيمة المعادة

ترجع x^y من النوع Float64

أمثلة

مثال على الاستخدام

Query

SELECT pow(2, 3);

Response

8

​

proportionsZTest

أُضيفت في: v22.3.0

تعيد إحصاءات اختبار Z لنسبتين، وهو اختبار إحصائي لمقارنة النِّسَب بين مجتمعين إحصائيين x و y. تدعم الدالة طريقتَي التقدير المجمّع وغير المجمّع للخطأ المعياري. في الطريقة المجمّعة، يُؤخذ متوسط النسبتين وتُستخدم نسبة واحدة فقط لتقدير الخطأ المعياري. أما في الطريقة غير المجمّعة، فتُستخدم النسبتان كلٌّ على حدة.

البنية

proportionsZTest(successes_x, successes_y, trials_x, trials_y, conf_level, pool_type)

الوسائط

• successes_x — عدد النجاحات في المجموعة x. UInt64
• successes_y — عدد النجاحات في المجموعة y. UInt64
• trials_x — عدد التجارب في المجموعة x. UInt64
• trials_y — عدد التجارب في المجموعة y. UInt64
• conf_level — مستوى الثقة للاختبار. Float64
• pool_type — اختيار طريقة التجميع لتقدير الخطأ المعياري. يمكن أن تكون إما ‘unpooled’ أو ‘pooled’. String

القيمة المعادة

يعيد Tuple يحتوي على: z_stat (إحصائية Z)، وp_val (قيمة P)، وci_low (الحد الأدنى لفاصل الثقة)، وci_high (الحد الأعلى لفاصل الثقة). Tuple(Float64, Float64, Float64, Float64)

أمثلة

مثال على الاستخدام

Query

SELECT proportionsZTest(10, 11, 100, 101, 0.95, 'unpooled');

Response

┌─proportionsZTest(10, 11, 100, 101, 0.95, 'unpooled')───────────────────────────────┐
│ (-0.20656724435948853,0.8363478437079654,-0.09345975390115283,0.07563797172293502) │
└────────────────────────────────────────────────────────────────────────────────────┘

​

radians

أُضيفت في: v22.2.0

يحوّل الدرجات إلى راديانات.

البنية

radians(x)

المعاملات

• x — المُدخل بالدرجات. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

تُرجِع قيمةً بالراديان Float64

أمثلة

مثال على الاستخدام

Query

SELECT radians(180)

Response

3.141592653589793

​

sigmoid

استُحدثت في: v20.1.0

تحسب دالة sigmoid: 1 / (1 + exp(-x)). تحوِّل دالة sigmoid أي عدد حقيقي إلى الفترة (0, 1)، وتُستخدم عادةً في تعلّم الآلة.

الصيغة

sigmoid(x)

الوسائط

• x — قيمة الإدخال. (U)Int* أو Float*

القيمة المُعادة

يعيد دالة السيغمويد لقيمة الإدخال، ضمن النطاق (0, 1). Float64

أمثلة

الاستخدام الأساسي

Query

SELECT sigmoid(0)

Response

0.5

​

sign

أُضيف في: v21.2.0

يعيد إشارة عددٍ حقيقي.

الصياغة

sign(x)

الوسيطات

• x — قيم من -∞ إلى +∞. (U)Int* أو Decimal* أو Float*

القيمة المُعادة

تُرجِع -1 إذا كان x < 0، و0 إذا كان x = 0، و1 إذا كان x > 0. Int8

أمثلة

إشارة الصفر

Query

SELECT sign(0)

Response

0

علامة الموجب

Query

SELECT sign(1)

Response

1

علامة السالب

Query

SELECT sign(-1)

Response

-1

​

sin

أُضيف في: v1.1.0

تُرجِع جيبَ الوسيطة.

البنية

sin(x)

المعاملات

• x — العدد الذي سيُحسَب جيبه. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

يُرجع جيب x.

أمثلة

بسيط

Query

SELECT sin(1.23)

Response

0.9424888019316975

​

sinh

أُضيف في: v20.12.0

يعيد الجيب الزائدي.

الصيغة

sinh(x)

الوسيطات

• x — الزاوية، بوحدة الراديان. تقع القيم ضمن المجال: -∞ < x < +∞. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

تعيد قيماً تقع ضمن المجال: -∞ < sinh(x) < +∞ Float64

أمثلة

مثال على الاستخدام

Query

SELECT sinh(0)

Response

0

​

sqrt

أُضيفت في: v1.1.0

تُرجِع الجذر التربيعي للوسيطة.

الصياغة

sqrt(x)

المعاملات

• x — العدد المراد إيجاد الجذر التربيعي له. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

يعيد الجذر التربيعي لـ x Float*

أمثلة

مثال على الاستخدام

Query

SELECT sqrt(16);

Response

4

​

tan

تم تقديمه في: v1.1.0

يُرجع ظلّ الوسيطة.

البنية

tan(x)

الوسائط

• x — الزاوية بوحدة الراديان. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

يُرجع ظل x. Float*

أمثلة

مثال على الاستخدام

Query

SELECT tan(0);

Response

0

​

tanh

أُضيف في: v20.1.0

تُرجع قيمة الظل الزائدي.

الصياغة

tanh(x)

الوسائط

• x — الزاوية بوحدة الراديان. قيم ضمن المجال: -∞ < x < +∞. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

تُرجِع قيماً ضمن المجال: -1 < tanh(x) < 1 Float*

أمثلة

مثال للاستخدام

Query

SELECT tanh(0)

Response

0

​

tgamma

أُضيفت في: v1.1.0

تعيد دالة غاما.

بنية الجملة

tgamma(x)

الوسائط

• x — العدد المراد حساب دالة غاما له. (U)Int* أو Float* أو Decimal*

القيمة المُعادة

تعيد قيمة دالة غاما من النوع Float*

أمثلة

مثال على الاستخدام

Query

SELECT tgamma(5);

Response

24

​

widthBucket

أُضيف في: v23.3.0

يعيد رقم الفئة التي تقع فيها المعلمة operand ضمن مُدرَّج تكراري يحتوي على count فئات متساوية العرض تمتد عبر النطاق من low إلى high. ويعيد 0 إذا كانت operand أقل من low، ويعيد count+1 إذا كانت operand أكبر من high أو تساويه. يوجد أيضًا اسم مستعار غير حساس لحالة الأحرف باسم WIDTH_BUCKET لتوفير التوافق مع قواعد البيانات الأخرى.

البنية

widthBucket(operand, low, high, count)

الأسماء المستعارة: width_bucket

المعاملات

• operand — القيمة المطلوب تحديد الفئة التي تقع ضمنها. (U)Int8/16/32/64
• low — الحد الأدنى لنطاق المُدرَّج التكراري. (U)Int8/16/32/64
• high — الحد الأعلى لنطاق المُدرَّج التكراري. (U)Int8/16/32/64
• count — عدد الفئات متساوية العرض. لا يمكن أن تكون قيمته صفراً. UInt8/16/32/64

القيمة المُعادة

تُعيد رقم الفئة كعدد صحيح. وتُعيد 0 إذا كانت operand < low، وتُعيد count+1 إذا كانت operand >= high. UInt8/16/32/64

أمثلة

مثال على الاستخدام

Query

widthBucket(10.15, -8.6, 23, 18)

Response

11