> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> وثائق دوال المقارنة

# دوال المقارنة

<div id="comparison-rules">
  ## قواعد المقارنة
</div>

تعيد دوال المقارنة أدناه القيمة `0` أو `1` من النوع [UInt8](/ar/reference/data-types/int-uint). ولا يمكن
مقارنة إلا القيم التي تقع ضمن المجموعة نفسها (مثل `UInt16` و`UInt64`) وليس بين مجموعات مختلفة (مثل `UInt16` و`DateTime`).
كما يمكن مقارنة الأرقام والسلاسل النصية، وكذلك السلاسل النصية بالتواريخ، والتواريخ بالأوقات.
أما بالنسبة إلى tuples وarrays، فتكون المقارنة معجمية، أي تُجرى المقارنة بين كل
عنصر مقابل في الـ tuple/array على الجهة اليسرى ونظيره على الجهة اليمنى.

يمكن مقارنة الأنواع التالية:

* الأرقام والقيم العشرية
* السلاسل النصية والسلاسل النصية ثابتة الطول
* التواريخ
* التواريخ مع الأوقات
* tuples (مقارنة معجمية)
* arrays (مقارنة معجمية)

<Note>
  تُقارَن السلاسل النصية بايتًا ببايت. وقد يؤدي ذلك إلى نتائج غير متوقعة إذا كانت إحدى السلاسل النصية تحتوي على أحرف متعددة البايت بترميز UTF-8.
  وتُعَدّ السلسلة النصية S1 التي تكون السلسلة النصية S2 بادئة لها أطول من S2.
</Note>

{/*AUTOGENERATED_START*/}

<div id="equals">
  ## equals
</div>

أُضيف في: v1.1.0

يقارن بين قيمتين للتحقق من تساويهما.

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

```sql theme={null}
equals(a, b)
        -- a = b
        -- a == b
```

**الوسيطات**

* `a` — القيمة الأولى.<sup>[\*](#comparison-rules)</sup> - `b` — القيمة الثانية.<sup>[\*](#comparison-rules)</sup>

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

تُرجع `1` إذا كانت `a` تساوي `b`، وإلا فتُرجع `0` [`UInt8`](/ar/reference/data-types/int-uint)

**أمثلة**

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

```sql title=Query theme={null}
SELECT 1 = 1, 1 = 2;
```

```response title=Response theme={null}
┌─equals(1, 1)─┬─equals(1, 2)─┐
│            1 │            0 │
└──────────────┴──────────────┘
```

<div id="globalIn">
  ## globalIn
</div>

أُضيف في: v1.1.0

مماثل لـ `in`، لكنه يستخدم التوزيع العام للمجموعة في الاستعلامات الموزعة. وتُرسَل المجموعة إلى جميع الخوادم البعيدة.

**الصيغة**

```sql theme={null}
globalIn(x, set)
```

**المعاملات**

* `x` — القيمة المطلوب التحقق منها. - `set` — مجموعة القيم.

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

تُعيد 1 إذا كانت x موجودة في المجموعة، وإلا فتُعيد 0. [`UInt8`](/ar/reference/data-types/int-uint)

**أمثلة**

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

```sql title=Query theme={null}
SELECT 1 IN (1, 2, 3)
```

```response title=Response theme={null}
1
```

<div id="globalInIgnoreSet">
  ## globalInIgnoreSet
</div>

أُضيف في: v1.1.0

مماثل لـ `in`، لكنه يستخدم التوزيع العام للمجموعة في الاستعلامات الموزعة. وتُرسَل المجموعة إلى جميع الخوادم البعيدة.
هذا هو متغير IgnoreSet المستخدم لتحليل النوع دون إنشاء المجموعة.

**البنية**

```sql theme={null}
globalIn(x, set)
```

**الوسيطات**

* `x` — القيمة المراد التحقّق منها. - `set` — مجموعة القيم.

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

تُعيد 1 إذا كانت `x` ضمن المجموعة، وإلا فتُعيد 0. [`UInt8`](/ar/reference/data-types/int-uint)

**أمثلة**

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

```sql title=Query theme={null}
SELECT 1 IN (1, 2, 3)
```

```response title=Response theme={null}
1
```

<div id="globalNotIn">
  ## globalNotIn
</div>

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

مطابقة لـ `notIn`، لكنها تستخدم التوزيع العام للمجموعة في الاستعلامات الموزعة. وتُرسَل المجموعة إلى جميع الخوادم البعيدة.

**الصيغة**

```sql theme={null}
globalNotIn(x, set)
```

**المعاملات**

* `x` — القيمة المطلوب التحقّق منها. - `set` — مجموعة القيم.

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

يعيد 1 إذا لم تكن x ضمن المجموعة، و0 بخلاف ذلك. [`UInt8`](/ar/reference/data-types/int-uint)

**أمثلة**

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

```sql title=Query theme={null}
SELECT 4 NOT IN (1, 2, 3)
```

```response title=Response theme={null}
1
```

<div id="globalNotInIgnoreSet">
  ## globalNotInIgnoreSet
</div>

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

مماثل لـ `notIn`، لكنه يستخدم التوزيع العام للمجموعة في الاستعلامات الموزعة. وتُرسَل المجموعة إلى جميع الخوادم البعيدة.
هذا هو متغير IgnoreSet المستخدم في تحليل النوع دون إنشاء المجموعة.

**البنية**

```sql theme={null}
globalNotIn(x, set)
```

**المعاملات**

* `x` — القيمة المراد التحقق منها. - `set` — مجموعة القيم.

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

تُرجِع 1 إذا لم يكن `x` ضمن المجموعة، وإلا فتُرجِع 0. [`UInt8`](/ar/reference/data-types/int-uint)

**أمثلة**

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

```sql title=Query theme={null}
SELECT 4 NOT IN (1, 2, 3)
```

```response title=Response theme={null}
1
```

<div id="globalNotNullIn">
  ## globalNotNullIn
</div>

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

مماثلة لـ `notNullIn`، لكنها تستخدم التوزيع العام للمجموعة في الاستعلامات الموزعة. وتُرسَل المجموعة إلى جميع الخوادم البعيدة.

**الصيغة**

```sql theme={null}
globalNotNullIn(x, set)
```

**الوسائط**

* `x` — القيمة المطلوب التحقّق منها. - `set` — مجموعة القيم.

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

تعيد 1 إذا لم تكن `x` ضمن المجموعة، وإلا فتعيد 0. [`UInt8`](/ar/reference/data-types/int-uint)

**أمثلة**

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

```sql title=Query theme={null}
SELECT notNullIn(NULL, tuple(1, NULL))
```

```response title=Response theme={null}
0
```

<div id="globalNotNullInIgnoreSet">
  ## globalNotNullInIgnoreSet
</div>

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

مماثلة لـ `notNullIn`، لكنها تستخدم التوزيع العام للمجموعة في الاستعلامات الموزعة. وتُرسَل المجموعة إلى جميع الخوادم البعيدة.
وهذا هو متغير IgnoreSet المستخدم لتحليل النوع دون إنشاء المجموعة.

**البنية**

```sql theme={null}
globalNotNullIn(x, set)
```

**الوسائط**

* `x` — القيمة المراد التحقق منها. - `set` — مجموعة القيم.

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

تُرجِع 1 إذا لم تكن `x` ضمن المجموعة، و0 بخلاف ذلك. [`UInt8`](/ar/reference/data-types/int-uint)

**أمثلة**

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

```sql title=Query theme={null}
SELECT notNullIn(NULL, tuple(1, NULL))
```

```response title=Response theme={null}
0
```

<div id="globalNullIn">
  ## globalNullIn
</div>

مُتاحة منذ: v1.1.0

مماثلة لـ `nullIn`، لكنها تستخدم التوزيع العام للمجموعة في الاستعلامات الموزعة. وتُرسَل المجموعة إلى جميع الخوادم البعيدة.

**البنية**

```sql theme={null}
globalNullIn(x, set)
```

**الوسيطات**

* `x` — القيمة المراد التحقق منها. - `set` — مجموعة القيم.

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

تُرجِع 1 إذا كانت x ضمن المجموعة، وإلا فتُرجِع 0. [`UInt8`](/ar/reference/data-types/int-uint)

**أمثلة**

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

```sql title=Query theme={null}
SELECT nullIn(NULL, tuple(1, NULL))
```

```response title=Response theme={null}
1
```

<div id="globalNullInIgnoreSet">
  ## globalNullInIgnoreSet
</div>

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

مماثل لـ `nullIn`، لكنه يستخدم التوزيع العام للمجموعة في الاستعلامات الموزعة. وتُرسَل المجموعة إلى جميع الخوادم البعيدة.
هذا هو متغير IgnoreSet المستخدم في تحليل النوع من دون إنشاء المجموعة.

**البنية**

```sql theme={null}
globalNullIn(x, set)
```

**الوسائط**

* `x` — القيمة المطلوب التحقق منها. - `set` — مجموعة القيم.

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

تُعيد 1 إذا كانت `x` موجودة في المجموعة، وإلا فتُعيد 0. [`UInt8`](/ar/reference/data-types/int-uint)

**أمثلة**

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

```sql title=Query theme={null}
SELECT nullIn(NULL, tuple(1, NULL))
```

```response title=Response theme={null}
1
```

<div id="greater">
  ## greater
</div>

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

يقارن بين قيمتين لتحديد ما إذا كانت إحداهما أكبر من الأخرى.

**البنية**

```sql theme={null}
greater(a, b)
    -- a > b
```

**الوسيطات**

* `a` — القيمة الأولى.<sup>[\*](#comparison-rules)</sup> - `b` — القيمة الثانية.<sup>[\*](#comparison-rules)</sup>

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

تُرجع `1` إذا كانت `a` أكبر من `b`، وإلا فتُرجع `0` [`UInt8`](/ar/reference/data-types/int-uint)

**أمثلة**

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

```sql title=Query theme={null}
SELECT 2 > 1, 1 > 2;
```

```response title=Response theme={null}
┌─greater(2, 1)─┬─greater(1, 2)─┐
│             1 │             0 │
└───────────────┴───────────────┘
```

<div id="greaterOrEquals">
  ## greaterOrEquals
</div>

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

تقارن بين قيمتين للتحقق مما إذا كانت إحداهما أكبر من الأخرى أو تساويها.

**البنية**

```sql theme={null}
greaterOrEquals(a, b)
    -- a >= b
```

**الوسائط**

* `a` — القيمة الأولى.<sup>[\*](#comparison-rules)</sup> - `b` — القيمة الثانية.<sup>[\*](#comparison-rules)</sup>

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

يعيد `1` إذا كانت `a` أكبر من أو تساوي `b`، وإلا فيُعيد `0` [`UInt8`](/ar/reference/data-types/int-uint)

**أمثلة**

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

```sql title=Query theme={null}
SELECT 2 >= 1, 2 >= 2, 1 >= 2;
```

```response title=Response theme={null}
┌─greaterOrEquals(2, 1)─┬─greaterOrEquals(2, 2)─┬─greaterOrEquals(1, 2)─┐
│                     1 │                     1 │                     0 │
└───────────────────────┴───────────────────────┴───────────────────────┘
```

<div id="in">
  ## in
</div>

أُضيف في: v1.1.0

يتحقق مما إذا كان المُعامل الأيسر عنصرًا في مجموعة المُعامل الأيمن. ويُرجع 1 إذا كان كذلك، و0 بخلاف ذلك. تُتخطّى قيم NULL في المُعامل الأيسر (وتُعامل كما لو أنها ليست ضمن المجموعة).

**الصياغة**

```sql theme={null}
in(x, set)
```

**المعاملات**

* `x` — القيمة المطلوب التحقق منها. - `set` — مجموعة القيم.

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

يُرجع 1 إذا كانت x موجودة في المجموعة، وإلا فيُرجع 0. [`UInt8`](/ar/reference/data-types/int-uint)

**أمثلة**

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

```sql title=Query theme={null}
SELECT 1 IN (1, 2, 3)
```

```response title=Response theme={null}
1
```

<div id="inIgnoreSet">
  ## inIgnoreSet
</div>

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

يفحص ما إذا كان المعامل الأيسر عنصرًا في مجموعة المعامل الأيمن. يُرجع 1 إذا كان كذلك، و0 بخلاف ذلك. تُتجاهل قيم NULL في المعامل الأيسر (وتُعامل على أنها غير موجودة في المجموعة).
هذا هو متغير IgnoreSet المستخدم في تحليل النوع من دون إنشاء المجموعة.

**الصيغة**

```sql theme={null}
in(x, set)
```

**الوسائط**

* `x` — القيمة المراد التحقق منها. - `set` — مجموعة القيم.

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

تُرجع 1 إذا كانت قيمة `x` ضمن المجموعة، وإلا فتُرجع 0. [`UInt8`](/ar/reference/data-types/int-uint)

**أمثلة**

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

```sql title=Query theme={null}
SELECT 1 IN (1, 2, 3)
```

```response title=Response theme={null}
1
```

<div id="isDistinctFrom">
  ## isDistinctFrom
</div>

أُضيفت في: v25.11.0

تُجري مقارنة "عدم المساواة" تراعي NULL بين قيمتين.
تعيد `true` إذا كانت القيمتان مختلفتين (غير متساويتين)، بما في ذلك عندما تكون إحدى القيم NULL والأخرى ليست كذلك.
تعيد `false` إذا كانت القيمتان متساويتين، أو إذا كانت كلتاهما NULL.

**البنية**

```sql theme={null}
isDistinctFrom(x, y)
```

**الوسيطات**

* `x` — القيمة الأولى للمقارنة. يمكن أن تكون من أي نوع بيانات في ClickHouse. [`Any`](/ar/reference/data-types/index)
* `y` — القيمة الثانية للمقارنة. يمكن أن تكون من أي نوع بيانات في ClickHouse. [`Any`](/ar/reference/data-types/index)

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

تُرجِع `true` إذا كانت القيمتان مختلفتين، مع اعتبار قيم NULL قابلة للمقارنة:

* تُرجِع `true` إذا كان x != y.
  * تُرجِع `true` إذا كانت واحدة فقط من x أو y تساوي NULL.
  * تُرجِع `false` إذا كان x = y، أو إذا كانت كلٌّ من x وy تساوي NULL. [`Bool`](/ar/reference/data-types/boolean)

**أمثلة**

**الاستخدام الأساسي مع الأرقام وقيم NULL**

```sql title=Query theme={null}
SELECT
    isDistinctFrom(1, 2) AS result_1,
    isDistinctFrom(1, 1) AS result_2,
    isDistinctFrom(NULL, 1) AS result_3,
    isDistinctFrom(NULL, NULL) AS result_4
```

```response title=Response theme={null}
┌─result_1─┬─result_2─┬─result_3─┬─result_4─┐
│        1 │        0 │        1 │        0 │
└──────────┴──────────┴──────────┴──────────┘
```

<div id="isNotDistinctFrom">
  ## isNotDistinctFrom
</div>

قُدِّمت في: v23.8.0

تُجري مقارنة "مساواة" تراعي NULL بين قيمتين.
تُرجع `true` إذا كانت القيمتان متساويتين، بما في ذلك عندما تكونان كلتاهما NULL.
تُرجع `false` إذا كانت القيمتان مختلفتين، أو إذا كانت واحدة منهما فقط NULL.

**الصيغة**

```sql theme={null}
isNotDistinctFrom(x, y)
```

**المعاملات**

* `x` — القيمة الأولى للمقارنة. يمكن أن تكون من أي نوع بيانات في ClickHouse. [`Any`](/ar/reference/data-types/index)
* `y` — القيمة الثانية للمقارنة. يمكن أن تكون من أي نوع بيانات في ClickHouse. [`Any`](/ar/reference/data-types/index)

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

تُرجع `true` إذا كانت القيمتان متساويتين، مع اعتبار قيم NULL قابلة للمقارنة:

* تُرجع `true` إذا كان x = y.
  * تُرجع `true` إذا كانت كلٌّ من x و y تساوي NULL.
  * تُرجع `false` إذا كان x != y، أو إذا كانت إحدى القيمتين x أو y فقط تساوي NULL. [`Bool`](/ar/reference/data-types/boolean)

**أمثلة**

**الاستخدام الأساسي مع الأرقام وقيم NULL**

```sql title=Query theme={null}
SELECT
    isNotDistinctFrom(1, 1) AS result_1,
    isNotDistinctFrom(1, 2) AS result_2,
    isNotDistinctFrom(NULL, NULL) AS result_3,
    isNotDistinctFrom(NULL, 1) AS result_4
```

```response title=Response theme={null}
┌─result_1─┬─result_2─┬─result_3─┬─result_4─┐
│        1 │        0 │        1 │        0 │
└──────────┴──────────┴──────────┴──────────┘
```

<div id="less">
  ## less
</div>

أُضيف في: v1.1.0

يقارن بين قيمتين لتحديد ما إذا كانت إحداهما أصغر من الأخرى.

**الصياغة**

```sql theme={null}
less(a, b)
    -- a < b
```

**المعاملات**

* `a` — القيمة الأولى.<sup>[\*](#comparison-rules)</sup> - `b` — القيمة الثانية.<sup>[\*](#comparison-rules)</sup>

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

تعيد `1` إذا كانت `a` أقل من `b`، وإلا فتعيد `0` [`UInt8`](/ar/reference/data-types/int-uint)

**أمثلة**

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

```sql title=Query theme={null}
SELECT 1 < 2, 2 < 1;
```

```response title=Response theme={null}
┌─less(1, 2)─┬─less(2, 1)─┐
│          1 │          0 │
└────────────┴────────────┘
```

<div id="lessOrEquals">
  ## lessOrEquals
</div>

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

يقارن بين قيمتين للتحقق من علاقة «أصغر من أو يساوي».

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

```sql theme={null}
lessOrEquals(a, b)
-- a <= b
```

**الوسائط**

* `a` — القيمة الأولى.<sup>[\*](#comparison-rules)</sup> - `b` — القيمة الثانية.<sup>[\*](#comparison-rules)</sup>

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

تعيد `1` إذا كانت `a` أقل من أو تساوي `b`، وإلا فتعيد `0` [`UInt8`](/ar/reference/data-types/int-uint)

**أمثلة**

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

```sql title=Query theme={null}
SELECT 1 <= 2, 2 <= 2, 3 <= 2;
```

```response title=Response theme={null}
┌─lessOrEquals(1, 2)─┬─lessOrEquals(2, 2)─┬─lessOrEquals(3, 2)─┐
│                  1 │                  1 │                  0 │
└────────────────────┴────────────────────┴────────────────────┘
```

<div id="notEquals">
  ## notEquals
</div>

أُضيف في: v1.1.0

يقارن بين قيمتين للتحقق من عدم التساوي.

**الصياغة**

```sql theme={null}
notEquals(a, b)
    -- a != b
    -- a <> b
```

**المعاملات**

* `a` — القيمة الأولى.<sup>[\*](#comparison-rules)</sup> - `b` — القيمة الثانية.<sup>[\*](#comparison-rules)</sup>

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

تُرجع `1` إذا كانت `a` لا تساوي `b`، وإلا فتُرجع `0`. [`UInt8`](/ar/reference/data-types/int-uint)

**أمثلة**

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

```sql title=Query theme={null}
SELECT 1 != 2, 1 != 1;
```

```response title=Response theme={null}
┌─notEquals(1, 2)─┬─notEquals(1, 1)─┐
│               1 │               0 │
└─────────────────┴─────────────────┘
```

<div id="notIn">
  ## notIn
</div>

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

يتحقق مما إذا كان المعامل الأيسر ليس عنصرًا في مجموعة المعامل الأيمن. وتُرجع 1 إذا لم يكن ضمن المجموعة، و0 خلاف ذلك. ويتم تجاهل قيم NULL في المعامل الأيسر.

**البنية**

```sql theme={null}
notIn(x, set)
```

**الوسائط**

* `x` — القيمة المراد التحقق منها. - `set` — مجموعة القيم.

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

يعيد 1 إذا لم تكن `x` ضمن المجموعة، وإلا يعيد 0. [`UInt8`](/ar/reference/data-types/int-uint)

**أمثلة**

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

```sql title=Query theme={null}
SELECT 4 NOT IN (1, 2, 3)
```

```response title=Response theme={null}
1
```

<div id="notInIgnoreSet">
  ## notInIgnoreSet
</div>

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

يتحقق مما إذا كان المعامل الأيسر ليس ضمن مجموعة المعامل الأيمن. ويُرجع 1 إذا لم يكن ضمن المجموعة، و0 خلاف ذلك. تُتجاوز قيم NULL في المعامل الأيسر.
هذا هو متغير IgnoreSet المستخدم لتحليل النوع دون إنشاء المجموعة.

**البنية**

```sql theme={null}
notIn(x, set)
```

**الوسيطات**

* `x` — القيمة المراد التحقق منها. - `set` — مجموعة القيم.

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

تُعيد 1 إذا لم تكن x ضمن المجموعة، وإلا تُعيد 0. [`UInt8`](/ar/reference/data-types/int-uint)

**أمثلة**

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

```sql title=Query theme={null}
SELECT 4 NOT IN (1, 2, 3)
```

```response title=Response theme={null}
1
```

<div id="notNullIn">
  ## notNullIn
</div>

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

يتحقق مما إذا كان المعامل الأيسر ليس عنصرًا في مجموعة المعامل الأيمن. وعلى عكس `notIn`، لا يتم تجاهل قيم NULL: تُقارَن NULL بعناصر المجموعة، وتكون نتيجة NULL = NULL هي true.

**الصيغة**

```sql theme={null}
notNullIn(x, set)
```

**الوسيطات**

* `x` — القيمة المراد التحقق منها. - `set` — مجموعة القيم.

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

يُرجع 1 إذا لم تكن `x` ضمن المجموعة، وإلا فيُرجع 0. [`UInt8`](/ar/reference/data-types/int-uint)

**أمثلة**

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

```sql title=Query theme={null}
SELECT notNullIn(NULL, tuple(1, NULL))
```

```response title=Response theme={null}
0
```

<div id="notNullInIgnoreSet">
  ## notNullInIgnoreSet
</div>

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

يتحقق مما إذا كان المعامل الأيسر ليس عضوًا في مجموعة المعامل الأيمن. وعلى خلاف `notIn`، لا يتم تجاهل قيم NULL، بل تُقارَن NULL بعناصر المجموعة، وتُقيَّم NULL = NULL إلى true.
هذا هو متغير IgnoreSet المستخدم لتحليل النوع دون إنشاء المجموعة.

**البنية**

```sql theme={null}
notNullIn(x, set)
```

**الوسيطات**

* `x` — القيمة المطلوب التحقق منها. - `set` — مجموعة القيم.

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

تُرجع 1 إذا لم تكن `x` ضمن المجموعة، وإلا فتُرجع 0. [`UInt8`](/ar/reference/data-types/int-uint)

**أمثلة**

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

```sql title=Query theme={null}
SELECT notNullIn(NULL, tuple(1, NULL))
```

```response title=Response theme={null}
0
```

<div id="nullIn">
  ## nullIn
</div>

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

يتحقق مما إذا كان المعامل الأيسر عنصرًا في مجموعة المعامل الأيمن. وعلى خلاف `in`، لا تُتجاهل قيم NULL: إذ تُقارَن NULL بعناصر المجموعة، ويُقيَّم NULL = NULL على أنه true.

**البنية**

```sql theme={null}
nullIn(x, set)
```

**الوسائط**

* `x` — القيمة المطلوب التحقق منها. - `set` — مجموعة القيم.

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

تُرجع 1 إذا كانت x ضمن المجموعة، وإلا فتُرجع 0. [`UInt8`](/ar/reference/data-types/int-uint)

**أمثلة**

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

```sql title=Query theme={null}
SELECT nullIn(NULL, tuple(1, NULL))
```

```response title=Response theme={null}
1
```

<div id="nullInIgnoreSet">
  ## nullInIgnoreSet
</div>

أُضيف في: v1.1.0

يتحقق مما إذا كان المعامل الأيسر عنصرًا في مجموعة المعامل الأيمن. بخلاف `in`، لا يتم تجاهل قيم NULL: تُقارَن NULL بعناصر المجموعة، وتُقيَّم NULL = NULL إلى true.
هذا هو متغير IgnoreSet المستخدم في تحليل النوع دون إنشاء المجموعة.

**الصياغة**

```sql theme={null}
nullIn(x, set)
```

**الوسائط**

* `x` — القيمة المطلوب التحقق منها. - `set` — مجموعة القيم.

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

تُعيد 1 إذا كانت x ضمن المجموعة، وتُعيد 0 بخلاف ذلك. [`UInt8`](/ar/reference/data-types/int-uint)

**أمثلة**

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

```sql title=Query theme={null}
SELECT nullIn(NULL, tuple(1, NULL))
```

```response title=Response theme={null}
1
```