Python/frozenset

تعيد الدّالة frozenset()‎ كائنًا جديدًا من النّوع frozenset‎ مع عناصر مأخوذة من الكائن القابل للتكرار الذي يُمرّر إليها اختياريًّا. انظر الصّنف frozenset‎ للمزيد من المعلومات حول كيفيّة استعماله.

القيمة المُعادة تكون مجموعة جامدةً غير قابلة للتّغيير، أي عكس المجموعات في بايثون، فالمجموعات الجامدة لا تقبل تعديل مُحتوياتها إمّا إضافةً أو حذفًا أو غير ذلك.

البنية العامة

frozenset([iterable])

المعاملات

iterable

مُعامل اختياريّ. وهو كائن قابل للتّكرار لإنشاء مجموعة جامدة من عناصره.

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

مجموعة جامدة تحتوي على العناصر الفريدة الموجودة في الكائن القابل للتّكرار المُمرّر. أو مجموعة جامدة فارغة إن استدعيت الدالة دون مُعاملات.

أمثلة

المثال التّالي يوضّح كيفيّة عمل هذه الدّالة:

>>> example = frozenset([1, 2, 3, 3, 4, 4])
>>> example # تُحذف القيم المُكرّرة كما في المجموعات
frozenset({1, 2, 3, 4})
>>> example.add(5) # على النّقيض من المجموعات، لا يُمكن إضافة عنصر آخر للمجموعة الجامدة
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
AttributeError: 'frozenset' object has no attribute 'add'

انظر أيضًا

• المجموعات set في بايثون.
• القواميس في بايثون.
• القوائم lists في بايثون.

مصادر

• قسم الدالة frozenset في صفحة Functions في توثيق Python الرسمي.