عرض مصدر Python/frozenset

<noinclude>{{DISPLAYTITLE:الدالة <code>frozenset()‎</code> في بايثون}}</noinclude>
تعيد الدّالة <code>frozenset()‎</code> كائنًا جديدًا من النّوع <code>[[Python/set/frozenset|frozenset‎]]</code> مع عناصر مأخوذة من الكائن القابل للتكرار الذي يُمرّر إليها اختياريًّا. انظر [[Python/set/frozenset|الصّنف <code>frozenset‎</code>]] للمزيد من المعلومات حول كيفيّة استعماله.

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

== البنية العامة ==
<syntaxhighlight lang="python3">
frozenset([iterable])
</syntaxhighlight>

== المعاملات ==
=== <code>iterable</code> ===
مُعامل اختياريّ.

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

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

== أمثلة ==
المثال التّالي يوضّح كيفيّة عمل هذه الدّالة:
<syntaxhighlight lang="python3">
>>> 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'
</syntaxhighlight>

== انظر أيضًا ==
* [[Python/set|المجموعات set في بايثون]].
* [[Python/dict|القواميس في بايثون]].
* [[Python/list|القوائم lists في بايثون]].

== مصادر ==
* [https://docs.python.org/3/library/functions.html#func-frozenset قسم الدالة frozenset في صفحة Functions في توثيق Python الرسمي].
[[تصنيف:Python]]
[[تصنيف:Python Function]]
[[تصنيف:Python Built-in Functions]]