الفرق بين المراجعتين لصفحة: «Python/deque/insert»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:التابع <code>deque.insert()</code> في بايثون}}</noinclude> يدرج التابع القيمة المعطاة في الكائ...' |
لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:التابع <code>deque.insert()</code> في بايثون}}</noinclude> | <noinclude>{{DISPLAYTITLE:التابع <code>deque.insert()</code> في بايثون}}</noinclude> | ||
يدرج التابع القيمة المعطاة في الكائن deque في الموقع المحدّد. | يدرج التابع القيمة المعطاة في الكائن <code>deque</code> في الموقع المحدّد. | ||
== البنية العامة == | == البنية العامة == | ||
| سطر 16: | سطر 16: | ||
=== <code>i</code> === | === <code>i</code> === | ||
الموقع الذي يدرج فيه التابع القيمة x في الكائن <code>deque</code>. | الموقع الذي يدرج فيه التابع القيمة <code>x</code> في الكائن <code>deque</code>. | ||
== القيمة المعادة == | == القيمة المعادة == | ||
إن أدّت عملية الإضافة إلى تجاوز الحد الأقصى للكائن <code>deque</code> والمقرّر عن طريق <code>maxlen</code>، فإنّ التابع يطلق الخطأ <code>IndexError</code>. | إن أدّت عملية الإضافة إلى تجاوز الحد الأقصى للكائن <code>deque</code> والمقرّر عن طريق الخاصية <code>[[Python/deque#.D8.A7.D9.84.D8.AE.D8.A7.D8.B5.D9.8A.D8.A9 maxlen|maxlen]]</code>، فإنّ التابع يطلق الخطأ <code>IndexError</code>. | ||
== أمثلة == | == أمثلة == | ||
| سطر 38: | سطر 38: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* [[Python/deque/append|التابع <code>append()</code>: ]] :يضيف التابع العنصر المعطى إلى الجانب الأيمن من كائن <code>deque</code>. | * [[Python/deque/append|التابع <code>append()</code>:]] :يضيف التابع العنصر المعطى إلى الجانب الأيمن من كائن <code>deque</code>. | ||
* [[Python/deque/appendleft|التابع <code>appendleft()</code>: ]] :يضيف التابع العنصر المعطى إلى الجانب الأيسر من كائن <code>deque</code>. | * [[Python/deque/appendleft|التابع <code>appendleft()</code>:]] :يضيف التابع العنصر المعطى إلى الجانب الأيسر من كائن <code>deque</code>. | ||
* [[Python/deque/extend|التابع <code>extend()</code>: ]] :يمدّد الجانب الأيمن من كائن <code>deque</code> بإضافة العناصر المعطاة. | * [[Python/deque/extend|التابع <code>extend()</code>:]] :يمدّد الجانب الأيمن من كائن <code>deque</code> بإضافة العناصر المعطاة. | ||
* [[Python/deque/extendleft|التابع <code>extendleft()</code>: ]] :يمدّد الجانب الأيسر من كائن <code>deque</code> بإضافة العناصر المعطاة. | * [[Python/deque/extendleft|التابع <code>extendleft()</code>:]] :يمدّد الجانب الأيسر من كائن <code>deque</code> بإضافة العناصر المعطاة. | ||
== مصادر == | == مصادر == | ||
المراجعة الحالية بتاريخ 17:52، 1 أغسطس 2018
يدرج التابع القيمة المعطاة في الكائن deque في الموقع المحدّد.
البنية العامة
d.insert(i, x)
المعاملات
x
العنصر المراد إدراجه في كائن deque.
i
الموقع الذي يدرج فيه التابع القيمة x في الكائن deque.
القيمة المعادة
إن أدّت عملية الإضافة إلى تجاوز الحد الأقصى للكائن deque والمقرّر عن طريق الخاصية maxlen، فإنّ التابع يطلق الخطأ IndexError.
أمثلة
يبين المثال التالي آلية عمل التابع.
>>> from collections import deque
>>> d = deque([1, 3, 4, 5, 6])
>>> d.insert(1, 2)
>>> d
deque([1, 2, 3, 4, 5, 6])
انظر أيضًا
- التابع
append(): :يضيف التابع العنصر المعطى إلى الجانب الأيمن من كائنdeque. - التابع
appendleft(): :يضيف التابع العنصر المعطى إلى الجانب الأيسر من كائنdeque. - التابع
extend(): :يمدّد الجانب الأيمن من كائنdequeبإضافة العناصر المعطاة. - التابع
extendleft(): :يمدّد الجانب الأيسر من كائنdequeبإضافة العناصر المعطاة.
مصادر
قسم deque Objects في صفحة Container Datatypes في توثيق بايثون الرسمي.