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

> يُدرِج قيمةً في المصفوفة في الموضع المحدد.

# groupArrayInsertAt

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

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

تُدرِج قيمة في المصفوفة عند الموضع المحدد.

إذا أُدرِجت عدة قيم في الموضع نفسه ضمن استعلام واحد، فتتصرف الدالة على النحو التالي:

* إذا نُفِّذ الاستعلام في خيط تنفيذ واحد، فستُستخدم أول قيمة من القيم المُدرَجة.
* إذا نُفِّذ الاستعلام باستخدام عدة خيوط تنفيذ، فستكون القيمة الناتجة إحدى القيم المُدرَجة بشكل غير محدد.

**الصياغة**

```sql theme={null}
groupArrayInsertAt(default_x, size)([x, pos])
```

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

* `default_x` — اختياري. القيمة الافتراضية المستخدمة للاستبدال في المواضع الفارغة. [`Any`](/ar/reference/data-types/index)
* `size` — اختياري. طول المصفوفة الناتجة. عند استخدام هذه المعلمة، يجب تحديد القيمة الافتراضية `default_x`. [`UInt32`](/ar/reference/data-types/int-uint)

**الوسائط**

* `x` — القيمة المراد إدراجها. [`Any`](/ar/reference/data-types/index)
* `pos` — الموضع الذي سيُدرج فيه العنصر المحدد `x`. يبدأ ترقيم الفهارس في المصفوفة من الصفر. [`UInt32`](/ar/reference/data-types/int-uint)

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

تعيد مصفوفة تحتوي على القيم المُدرَجة. [`Array`](/ar/reference/data-types/array)

**أمثلة**

**الاستخدام الأساسي من دون معلمات**

```sql title=Query theme={null}
SELECT groupArrayInsertAt(toString(number), number * 2) FROM numbers(5);
```

```response title=Response theme={null}
┌─groupArrayInsertAt(toString(number), multiply(number, 2))─┐
│ ['0','','1','','2','','3','','4']                         │
└───────────────────────────────────────────────────────────┘
```

**الاستخدام مع معلمة القيمة الافتراضية**

```sql title=Query theme={null}
SELECT groupArrayInsertAt('-')(toString(number), number * 2) FROM numbers(5);
```

```response title=Response theme={null}
┌─groupArrayInsertAt('-')(toString(number), multiply(number, 2))─┐
│ ['0','-','1','-','2','-','3','-','4']                          │
└────────────────────────────────────────────────────────────────┘
```

**الاستخدام مع معامِلَي القيمة الافتراضية والحجم**

```sql title=Query theme={null}
SELECT groupArrayInsertAt('-', 5)(toString(number), number * 2) FROM numbers(5);
```

```response title=Response theme={null}
┌─groupArrayInsertAt('-', 5)(toString(number), multiply(number, 2))─┐
│ ['0','-','1','-','2']                                             │
└───────────────────────────────────────────────────────────────────┘
```

**الإدراج متعدد الخيوط في نفس الموضع**

```sql title=Query theme={null}
SELECT groupArrayInsertAt(number, 0) FROM numbers_mt(10) SETTINGS max_block_size = 1;
```

```response title=Response theme={null}
┌─groupArrayInsertAt(number, 0)─┐
│ [7]                           │
└───────────────────────────────┘
```