الفرق بين المراجعتين لصفحة: «Python/deque»
لا ملخص تعديل |
|||
| سطر 23: | سطر 23: | ||
تدعم كائنات <code>deque</code> التوابع التالية: | تدعم كائنات <code>deque</code> التوابع التالية: | ||
=== التابع <code>append()</code> === | === التابع <code>[[Python/deque/append|append()]]</code> === | ||
يضيف التابع العنصر المعطى إلى الجانب الأيمن من كائن <code>deque</code>. | يضيف التابع العنصر المعطى إلى الجانب الأيمن من كائن <code>deque</code>. | ||
=== التابع <code>appendleft()</code> === | === التابع <code>[[Python/deque/appendleft|appendleft()]]</code> === | ||
يضيف التابع العنصر المعطى إلى الجانب الأيسر من كائن <code>deque</code>. | يضيف التابع العنصر المعطى إلى الجانب الأيسر من كائن <code>deque</code>. | ||
=== التابع <code>clear()</code> === | === التابع <code>[[Python/deque/clear|clear()]]</code> === | ||
يحذف جميع العناصر من كائن <code>deque</code>. | يحذف جميع العناصر من كائن <code>deque</code>. | ||
=== التابع <code>copy()</code> === | === التابع <code>[[Python/deque/copy|copy()]]</code> === | ||
ينشئ التابع نسخة سطحية من كائن <code>deque</code>. | ينشئ التابع نسخة سطحية من كائن <code>deque</code>. | ||
=== التابع <code>count()</code> === | === التابع <code>[[Python/deque/count|count()]]</code> === | ||
يحسب التابع عدد عناصر <code>deque</code> المساوية للقيمة المعطاة. | يحسب التابع عدد عناصر <code>deque</code> المساوية للقيمة المعطاة. | ||
=== التابع <code>extend()</code> === | === التابع <code>[[Python/deque/extend|extend()]]</code> === | ||
يمدّد الجانب الأيمن من كائن <code>deque</code> بإضافة العناصر المعطاة. | يمدّد الجانب الأيمن من كائن <code>deque</code> بإضافة العناصر المعطاة. | ||
=== التابع <code>extendleft()</code> === | === التابع <code>[[Python/deque/extendleft|extendleft()]]</code> === | ||
يمدّد الجانب الأيسر من كائن <code>deque</code> بإضافة العناصر المعطاة. | يمدّد الجانب الأيسر من كائن <code>deque</code> بإضافة العناصر المعطاة. | ||
=== التابع <code>index()</code> === | === التابع <code>[[Python/deque/index|index()]]</code> === | ||
يعيد التابع موقع العنصر المعطى في كائن <code>deque</code>. | يعيد التابع موقع العنصر المعطى في كائن <code>deque</code>. | ||
=== التابع <code>insert()</code> === | === التابع <code>[[Python/deque/insert|insert()]]</code> === | ||
يدرج التابع القيمة المعطاة في الكائن <code>deque</code> في الموقع المحدّد. | يدرج التابع القيمة المعطاة في الكائن <code>deque</code> في الموقع المحدّد. | ||
=== التابع <code>pop()</code> === | === التابع <code>[[Python/deque/pop|pop()]]</code> === | ||
يحذف التابع ويعيد عنصرًا واحدًا من الجانب الأيمن في الكائن <code>deque</code>. | يحذف التابع ويعيد عنصرًا واحدًا من الجانب الأيمن في الكائن <code>deque</code>. | ||
=== التابع <code>popleft()</code> === | === التابع <code>[[Python/deque/popleft|popleft()]]</code> === | ||
يحذف التابع ويعيد عنصرًا واحدًا من الجانب الأيسر في الكائن <code>deque</code>. | يحذف التابع ويعيد عنصرًا واحدًا من الجانب الأيسر في الكائن <code>deque</code>. | ||
=== التابع <code>remove()</code> === | === التابع <code>[[Python/deque/remove|remove()]]</code> === | ||
يحذف التابع أوّل عنصر يحمل القيمة المعطاة. | يحذف التابع أوّل عنصر يحمل القيمة المعطاة. | ||
=== التابع <code>reverse()</code> === | === التابع <code>[[Python/deque/reverse|reverse()]]</code> === | ||
يعكس التابع ترتيب عناصر الكائن <code>deque</code> في نفس المكان. | يعكس التابع ترتيب عناصر الكائن <code>deque</code> في نفس المكان. | ||
=== التابع <code>rotate()</code> === | === التابع <code>[[Python/deque/rotate|rotate()]]</code> === | ||
يدوّر التابع كائن <code>deque</code> إلى جهة اليمين بعدد الخطوات المعطاة. | يدوّر التابع كائن <code>deque</code> إلى جهة اليمين بعدد الخطوات المعطاة. | ||
| سطر 96: | سطر 96: | ||
== انظر أيضًا == | == انظر أيضًا == | ||
* [[Python/list|القوائم في بايثون.]] | * [[Python/list|القوائم في بايثون.]] | ||
* [[Python/namedtuple|كائنات <code>namedtuple</code>: ]] :دالة مولِّدة factory function لإنشاء أصناف فرعية من tuple تتضمن حقولًا مسمّاة | * [[Python/namedtuple|كائنات <code>namedtuple</code>:]] :دالة مولِّدة factory function لإنشاء أصناف فرعية من tuple تتضمن حقولًا مسمّاة | ||
* [[Python/ChainMap|كائنات <code>ChainMap</code>:]] :صنف شبيه بالقواميس يستخدم لإنشاء عرض منفرد لعمليات ربط mapping متعددة | |||
* [[Python/ChainMap|كائنات <code>ChainMap</code>: ]] :صنف شبيه بالقواميس يستخدم لإنشاء عرض منفرد لعمليات ربط mapping متعددة | * [[Python/Counter|كائنات <code>Counter</code>:]] :صنف فرعي من الصنف dict الهدف منه عدّ الكائنات القابلة للتقطيع hashable | ||
* [[Python/Counter|كائنات <code>Counter</code>: ]] :صنف فرعي من الصنف dict الهدف منه عدّ الكائنات القابلة للتقطيع hashable | * [[Python/OrderedDict|كائنات <code>OrderedDict</code>:]] :صنف فرعي من الصنف dict يمكنه تذكّر ترتيب العناصر عند إضافتها | ||
* [[Python/OrderedDict|كائنات <code>OrderedDict</code>: ]] :صنف فرعي من الصنف dict يمكنه تذكّر ترتيب العناصر عند إضافتها | * [[Python/defaultdict|كائنات <code>defaultdict</code>:]] :صنف فرعي من الصنف dict يستدعي دالة مولّدة تقدّم القيم المفقودة | ||
* [[Python/defaultdict|كائنات <code>defaultdict</code>: ]] :صنف فرعي من الصنف dict يستدعي دالة مولّدة تقدّم القيم المفقودة | * [[Python/UserDict|كائنات <code>UserDict</code>:]] :تغليف حول كائنات القواميس لتسهيل عملية تفريع أصناف القواميس | ||
* [[Python/UserDict|كائنات <code>UserDict</code>: ]] :تغليف حول كائنات القواميس لتسهيل عملية تفريع أصناف القواميس | * [[Python/UserList|كائنات <code>UserList</code>:]] :تغليف حول كائنات القوائم لتسهيل عملية تفريع أصناف القوائم | ||
* [[Python/UserList|كائنات <code>UserList</code>: ]] :تغليف حول كائنات القوائم لتسهيل عملية تفريع أصناف القوائم | * [[Python/UserString|كائنات <code>UserString</code>:]] :تغليف حول كائنات السلاسل النصية لتسهيل عملية تفريع أصناف السلاسل النصية | ||
* [[Python/UserString|كائنات <code>UserString</code>: ]] :تغليف حول كائنات السلاسل النصية لتسهيل عملية تفريع أصناف السلاسل النصية | |||
== مصادر == | == مصادر == | ||
مراجعة 08:18، 1 أغسطس 2018
تعدّ deques صورة عامة للأكداس والطوابير stacks and queues (يقرأ الاسم هكذا "deck" وهو اختصار للعبارة "double-ended queue").
تدعم deques عمليات الإضافة والحذف من طرفي الطابور مع ضمان سلامة الخيوط thread-safe ودون استهلاك كبير للذاكرة وبأداء مقارب لأداء O(1) في كلا الاتجاهين.
صحيح أن القوائم تدعم مثل هذه العمليات، إلا أنّها مصمّمة للعمليات السريعة ذات الطول الثابت وتكلّف الذاكرة بمقدار O(n) للعمليتين pop(0) و insert(0, v) واللتان تغيران حجم وموقع البيانات الضمنية الممثلة.
البنية العامة
class collections.deque([iterable[, maxlen]])
تعيد الدالة البانية كائن deque جديدًا مهيّئًا من اليسار إلى اليمن (باستخدام التابع append()) مع البيانات القادمة من الكائن المكرِّر iterable المعطى. وف يحال عدم تحديد الكائن المكرِّر يكون كائن deque الجديد فارغًا.
في حال عدم تحديد قيمة maxlen أو أخذ هذا المعامل القيمة None، فيمكن لكائن deque أن يصل إلى طول غير محدّد. وفيما عدا ذلك، يكون كائن deque محدّدًا بالطول المعطى.
تؤدي إضافة عناصر جديدة إلى كائن deque الممتلئ إلى حذف نفس عدد العناصر المضافة من الطرف المقابل. تؤدي كائنات deque ذات الطول المحدد نفس وظيفة المرشح tail في أنظمة يونكس.
كائنات deque مفيدة أيضًا في تعقب الإجراءات ومجموعات (pools) البيانات الأخرى حيث يكون المطلوب التعامل مع الأنشطة الحديثة فقط.
توابع كائنات deque
تدعم كائنات deque التوابع التالية:
التابع append()
يضيف التابع العنصر المعطى إلى الجانب الأيمن من كائن deque.
التابع appendleft()
يضيف التابع العنصر المعطى إلى الجانب الأيسر من كائن deque.
التابع clear()
يحذف جميع العناصر من كائن deque.
التابع copy()
ينشئ التابع نسخة سطحية من كائن deque.
التابع count()
يحسب التابع عدد عناصر deque المساوية للقيمة المعطاة.
التابع extend()
يمدّد الجانب الأيمن من كائن deque بإضافة العناصر المعطاة.
التابع extendleft()
يمدّد الجانب الأيسر من كائن deque بإضافة العناصر المعطاة.
التابع index()
يعيد التابع موقع العنصر المعطى في كائن deque.
التابع insert()
يدرج التابع القيمة المعطاة في الكائن deque في الموقع المحدّد.
التابع pop()
يحذف التابع ويعيد عنصرًا واحدًا من الجانب الأيمن في الكائن deque.
التابع popleft()
يحذف التابع ويعيد عنصرًا واحدًا من الجانب الأيسر في الكائن deque.
التابع remove()
يحذف التابع أوّل عنصر يحمل القيمة المعطاة.
التابع reverse()
يعكس التابع ترتيب عناصر الكائن deque في نفس المكان.
التابع rotate()
يدوّر التابع كائن deque إلى جهة اليمين بعدد الخطوات المعطاة.
خصائص كائنات deque
تقدّم كائنات deque خاصية واحدة للقراءة فقط:
الخاصية maxlen
تحمل هذه الخاصية قيمة الحجم الأقصى لكائن deque إن كان الكائن ذا طول محدّد، أو القيمة None إن كان الكائن غير محدّد الطول.
ملاحظة: هذه الخاصية جديدة في الإصدار 3.1.
تدعم deques إضافة إلى ما سبق عمليات التكرار iteration، وpickling، ويمكن معرفة طول كائن deque (عدد العناصر فيه) باستخدام الدالة len(d)، وقلب ترتيب العناصر بواسطة reversed(d)، وإجراء عمليات النسخ السطحية والعميقة بواسطة copy.copy(d) و copy.deepcopy(d)، والتأكد من وجود عنصر ما بواسطة العامل in، والإشارات الخلفية subscript references مثل d[-1].
تكون عملية الوصول المفهرس إلى العناصر بسرعة O(1) ولكنّها تصبح أبطأ لتصل إلى سرعة O(n) في الوسط. يمكن استخدام القوائم بدلًا من كائنات deque للحصول على أداء أسرع في الوصول العشوائي.
بدءًا من الإصدار 3.5 من بايثون، أصبحت كائنات deque تدعم التوابع __add__() و __mul__() و __imul__().
أمثلة
يبين المثال التالي طريقة إنشاء كائن deque:
>>> from collections import deque
>>> d = deque('ghi') # إنشاء كائن جديد يمتلك ثلاثة عناصر
>>> for elem in d: # deque المرور على عناصر
... print(elem.upper())
G
H
I
انظر أيضًا
- القوائم في بايثون.
- كائنات
namedtuple: :دالة مولِّدة factory function لإنشاء أصناف فرعية من tuple تتضمن حقولًا مسمّاة - كائنات
ChainMap: :صنف شبيه بالقواميس يستخدم لإنشاء عرض منفرد لعمليات ربط mapping متعددة - كائنات
Counter: :صنف فرعي من الصنف dict الهدف منه عدّ الكائنات القابلة للتقطيع hashable - كائنات
OrderedDict: :صنف فرعي من الصنف dict يمكنه تذكّر ترتيب العناصر عند إضافتها - كائنات
defaultdict: :صنف فرعي من الصنف dict يستدعي دالة مولّدة تقدّم القيم المفقودة - كائنات
UserDict: :تغليف حول كائنات القواميس لتسهيل عملية تفريع أصناف القواميس - كائنات
UserList: :تغليف حول كائنات القوائم لتسهيل عملية تفريع أصناف القوائم - كائنات
UserString: :تغليف حول كائنات السلاسل النصية لتسهيل عملية تفريع أصناف السلاسل النصية