Python/tuples

يتكوّن الصفّ من عدد من القيم المفصولة عن بعضها بفاصلة، مثل:

>>> t = 12345, 54321, 'hello!'
>>> t[0]
12345
>>> t
(12345, 54321, 'hello!')

إنشاء الصفوف

يكفي لإنشاء الصفوف إسناد أكثر من قيمة إلى متغيّر واحد مع فصل كل قيمة عن الأخرى بفاصلة ',':

>>> t = 12345, 54321, 'hello!'
>>> t[0]
12345
>>> t
(12345, 54321, 'hello!')

إيمكن أيضًا استخدام الدالة tuple()‎ لإنشاء صف جديد:

>>>tuple('abc')
('a', 'b', 'c')
>>>tuple([1,2,3])
(1, 2, 3)

يستخدم زوج من الأقواس الفارغة لإنشاء صفّ فارغ، ولإنشاء صفٍّ يحتوي على عنصر واحدٍ فقط، يجب أن يكون العنصر الوحيد في الصفّ متبوعًا بفاصلة، ولا يكفي إحاطة القيمة بالأقواس فقط.

>>> empty = ()
>>> singleton = 'hello',    # لاحظ الفاصلة في نهاية العبارة
>>> len(empty)
0
>>> len(singleton)
1
>>> singleton
('hello',)

يمكن للصفوف أن تكون متداخلة، بمعنى أنّه يمكن إنشاء صفوف داخل الصفوف:

>>> # يمكن للصفوف أن تكون متداخلة:‏
... u = t, (1, 2, 3, 4, 5)
>>> u
((12345, 54321, 'hello!'), (1, 2, 3, 4, 5))

الصفوف من الأنواع غير القابلة للتغيير (immutable) ولكن يمكن لها أن تتضمن كائنات قابلة للتغيير:

>>> # الصفوف غير قابلة للتغيير
... t[0] = 88888
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: 'tuple' object does not support item assignment
>>> # ولكن يمكن أن تحتوي على كائنات قابلة للتغيير
... v = ([1, 2, 3], [3, 2, 1])
>>> v
([1, 2, 3], [3, 2, 1])

تحاط الصفوف بالأقواس دائمًا في المخرجات، وبهذا تُمثَّل الصفوف المتداخلة بصورة صحيحة. يمكن استخدام الأقواس أو الاستغناء عنها عند إنشاء الصفوف، ولكن في بعض الأحيان يصبح استخدامها إلزاميًا (إن كان الصف جزءًا من تعبير أكبر).

لا يمكن إسناد قيم إلى عناصر الصف، ولكن يمكن إنشاء صفوف تتضمن كائنات قابلة للتغيير مثل القوائم.

قد تبدو الصفوف والقوائم متشابهة، ولكنّها غالبًا ما تستخدم في حالات مختلفة ولأغراض متباينة. فالصفوف غير قابلة للتغيير، وتتضمّن عادة تسلسلًا من عناصر ذات أنواع مختلفة، ويمكن الوصول إليها من خلال فك التحزيم (unpacking) أو الفهرسة (indexing) أو حتى بواسطة الخاصية في حالة الصفوف المسمّاة named tuples (راجع الصفوف المسمّاة أدناه). أما القوائم فقابلة للتغيير، وعادة ما تكون عناصرها متجانسة (أي من النوع ذاته) ويمكن الوصول إليها عن طريق المرور على القائمة.

العبارة t = 12345, 54321, 'hello!'‎ هي مثال عن تحزيم الصف، إذ تحزّم القيم 12345 و 54321 و ‎'hello!'‎ جميعها في صفّ واحد.

يمكن أيضًا إجراء العملية العكسية:

>>> x, y, z = t

تدعى هذه العملية بفك تحزيم التسلسل (sequence unpacking) ويمكن استخدام أي نوع من أنواع التسلسلات في الجانب الأيمن من عملية الإسناد. تتطلب عملية فك تحزيم التسلسل أن يكون عدد المتغيرات في الجانب الأيسر من عملية الإسناد مساويًا لعدد العناصر الموجودة في التسلسل.

لاحظ أن عملية الإسناد المتعددة هي في الواقع دمج لعمليتي تحزيم الصف وفك تحزيم التسلسل.

الصفوف المسمّاة (named tuples)

تعطي الصفوف المسمّاة معنى لكل عنصر ضمن الصف، وينتج عن ذلك شيفرة أسهل في القراءة وموثّقة ذاتيًّا. يمكن استخدام الصفوف المسمّاة في أيّ مكان تستخدم فيه الصفوف العادية، وتمتاز بإمكانية الوصول إلى الحقول عن طريق الأسماء بدلًا من فهرس العنصر.

يعطي المثال التالي صورة عامة عن الصفوف المسمّأة وكيفية استخدامها:

>>> Point = namedtuple('Point', ['x', 'y'])
>>> p = Point(11, y=22)     # إنشاء نسخة باستخدام وسائط موقعية أو مفتاحية
>>> p[0] + p[1]             # يمكن فهرستها مثل الصفوف العادية
33
>>> x, y = p                # فك التحزيم مثل الصفوف العادية
>>> x, y
(11, 22)
>>> p.x + p.y               # يمكن الوصول إلى الحقول عن طريق اسمائها
33
>>> p                       # تمثيل سهل القراءة
Point(x=11, y=22)

راجع كائنات namedtuple التي تقدّمها وحدة collections للاطلاع على المزيد من المعلومات حول الصفوف المسمّاة.

انظر أيضًا

• القوائم list في بايثون.
• القواميس dict في بايثون.
• المجموعات set في بايثون.
• الدالة tuple()‎: تعيد صفًا يُولَّد من الكائن القابل للتّكرار المُعطى.
• كائنات namedtuple في بايثون.

مصادر

• صفحة Built-in Types في توثيق بايثون الرسمي.
• قسم namedtuple في توثيق بايثون الرسمي.