نتائج البحث

تعيد الدالة كائن قراءة مهمّته هي المرور على جميع الأسطر في ملف csv المعطى. البنية العامة csv.reader(csvfile, dialect='excel', **fmtparams) ‎المعاملات csvfile ملف csv المراد قراءة محتوياته، ويمكن أن تكون قيمة هذا المعامل أيّ كائن يدعم بروتوكول المكرِّر iterator protocol ويعيد سلسلة نصية في كلّ مرة يجري فيها استدعاء التابع ‎__next__()‎، وعادة ما تكون كائنات الملفات وكائنات القوائم ملائمة لهذا الغرض. إن كانت قيمة هذا المعامل كائن ملف، فيجب أن يكون مفتوحًا مع المعامل ''newline=‎. ملاحظة: إن لم تحدد القيمة ''newline=‎ ...

تعيد الدالة كائن bytes الذي ستجري كتابته في ملفّ معين بواسطة الدالة dump(value, file)‎. البنية العامة marshal.dumps(value[, version]) ‎المعاملات value القيمة المطلوبة. version يحدد هذا المعامل تنسيق البيانات الذي يجب على الدالة استخدامه. (راجع الثابت marshal.version). القيمة المعادة تعيد الدالة كائن bytes الذي ستجري كتابته في ملفّ معين بواسطة الدالة dump(value, file)‎. يجب أن تكون القيمة المعطاة مدعومة، وتطلق اللغة الاستثناء ValueError إن كانت القيمة غير مدعومة أو تتضمّن كائنًا غير مدعوم. أمثلة يبين المثال التالي آلية عمل الدالة: >>> ...

تفتح الدّالة open()‎ ملفّا وتعيد كائن ملفّ (file object) مرتبط به. إن لم يُمكِن فتح الملفّ، فسيُطلَق الاستثناء OSError‎. البنية العامة open(file, mode='r', buffering=-1, encoding=None, errors=None, newline=None, closefd=True, opener=None) المعاملات file كائن مُشابه للمسارات (path-like object) يُمثّل مسار الملفّ (سواء أكان مُطلقا أو نسبيًّا) المرغوب فتحه. يُمكن كذلك أن يكون واصف ملفّ عدديّ (integer file descriptor) للملفّ لتغطيّته (wrap). إن مُرّر واصف ملفّات، فسيُغلَق عندما يُغلَق كائن I/O المُعاد، إلّا في حالة كانت قيمة المُعامل closefd تساوي False. mode مُعامل ...

تستبدل الدالة الحروف الخاصة في السلسلة النصية المعطاة باستخدام علامة التهريب ‎%xx. البنية العامة urllib.parse.quote(string, safe='/', encoding=None, errors=None) ‎المعاملات safe يحدّد هذا المعامل محارف ASCII الإضافية التي يجب على الدالة أن لا تحيطها بعلامات اقتباس. يحمل هذا المعامل القيمة الافتراضية '/'. string يمكن أن يكون سلسلة نصية أو كائن bytes. ملاحظة: اعتُمد المعيار RFC 3986 عوضًا عن المعيار RFC 2396 لاقتباس سلاسل URL النصية في الإصدار 3.7 من بايثون، وقد أضيف الرمز "~" إلى مجموعة المحارف المحجوزة. encoding و errors ...

تتحقق الدالة ممّا إذا كان ملف ZIP المعطى صالحًا للاستخدام أم لا وذلك بالاستناد إلى العدد السحري magic number الخاص بالملف. البنية العامة zipfile.is_zipfile(filename) ‎ المعاملات filename اسم ملف ZIP المراد التحقّق من صلاحيته للاستخدام. القيمة المعادة تعيد الدالة القيمة True إن كان الملف المعطى ملف ZIP صالحًا للاستخدام وذلك بالاستناد إلى العدد السحري magic number الخاص بالملف، وتعيد الدالة القيمة False إن لم يكن الملف صالحًا للاستخدام. أمثلة يبين المثال التالي طريقة استخدام الدالة: >>> import zipfile >>> zipfile.is_zipfile('files.zip') True مصادر ...

تصرّح هذه الدالة عن كون الكائن المعطى دالة بانية صحيحة. البنية العامة copyreg.constructor(object) ‎ المعاملات object الكائن الذي ستصرح الدالة بأنّه دالة بانية صحيحة. القيمة المعادة تصرّح هذه الدالة عن كون الكائن المعطى دالة بانية صحيحة. إن كان الكائن المعطى غير قابل للاستدعاء (وهكذا يكون غير صالح لأن يصبح دالة بانية) فإنّ الدالة تطلق الاستثناء TypeError. انظر أيضًا الدالة copyreg.pickle: تصرّح الدالة عن وجوب استخدام الدالة المعطاة كدالة اختزال reduction function للكائنات من النوع المعطى. مصادر صفحة Register pickle support ...

تطبع الدالة تقويم الشهر الذي تعيده الدالة month()‎. البنية العامة calendar.prmonth(theyear, themonth, w=0, l=0) المعاملات theyear السنة المطلوبة. themonth الشهر المطلوب (من 1 إلى 12). w معامل اختياري، يأخذ القيمة الافتراضية 0، ويحدّد عرض التقويم الذي ستطبعه الدالة. l معامل اختياري، يأخذ القيمة الافتراضية 0، ويحدّد مقدار الفاصل بين الأسطر في التقويم الذي ستطبعه الدالة. القيمة المعادة تعيد الدالة تقويم الشهر المعطى في السنة المعطاة. أمثلة يبين المثال التالي طريقة استخدام الدالة: >>> import calendar >>> calendar.prmonth(2018, 8, 1, 1) ...

تفكّ الدالة الضغط عن البايتات في البيانات المعطاة، وتعيد كائن bytes يحتوي على البيانات التي أزيل الضغط عنها. البنية العامة zlib.decompress(data, wbits=MAX_WBITS, bufsize=DEF_BUF_SIZE) ‎ المعاملات wbits يعتمد هذا المعامل على صيغة البيانات المعطاة، وسنتحدث عنه بتفصيل أكبر أدناه. يتحكّم المعامل wbits بحجم ذاكرة تخزين التاريخ history buffer (أو ما يطلق عليه "حجم النافذة window size") المستخدمة في ضغط البيانات، ويتحكّم كذلك فيما إذا كانت مخرجات الدالة تتضمّن ترويسة وتذييلًا. هذا المعامل يشبه نظيره في الدالة compressobj()‎ ولكنّه يأخذ نطاقات أكثر ...

تعيد الدّالة iter()‎ مُكرّرًا حسب المُعاملات المُعطاة. البنية العامة iter(object[, sentinel]) المعاملات object إن لم يكن المُعامل الثّاني sentinel حاضرًا، فلا بدّ لهذا المُعامل أن يكون كائنًا يدعم بروتوكول التّكرار (أي أنّ صنفه يُعرّف التّابع الخاصّ ‎_‎_‎iter‎_‎_‎(‎)‎)، أو يجب أن يدعم بروتوكول التّسلسلات (sequence protocol) الذي يُعرّف صنفه التّابع الخاصّ ‎_‎_‎getitem‎_‎_‎(‎)‎ مع مُعاملات تكون أعدادًا صحيحةً وتبدأ من الصّفر. وإن لم يدعم الكائن أيًّا من هذين البروتوكولين، فسيُطلق الاستثناء TypeError. sentinel مُعامل اختيّاريّ. إن مُرّرت قيمة لهذا المُعامل، فلا بدّ ...

تفتح الدالة العنوان المعطى في نافذة جديدة في المتصفّح الافتراضي، إن كان ذلك ممكنًا، وإلا فإنّها ستفتح العنوان المعطى في النافذة الموجودة فقط. البنية العامة webbrowser.open_new(url) المعاملات ‎url العنوان المراد فتحه في المتصفّح. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import webbrowser >>> webbrowser.open_new("http://wiki.hsoub.com") انظر أيضًا الدالة webbrowser.open()‎: تعرض الدالة العنوان المعطى في المتصفّح الافتراضي. الدالة webbrowser.open_new_tab()‎: تفتح الدالة العنوان المعطى في تبويب جديد (tab) في المتصفّح الافتراضي، إن كان ذلك ممكنًا. مصادر صفحة Convenient Web-browser controller في توثيق بايثون ...

تعيد الدّالة globals()‎ قاموسًا يحتوي على الكائنات العامّة الحاليّة. البنية العامة globals() المعاملات لا توجد مُعاملات لهذه الدالة. القيمة المعادة قاموس يُمثّل جدول الرّموز العامّ (global symbol table) ويكون دائمًا قاموسَ الوحدة الحاليّة، وفي داخل دالّة أو تابع، فإنّ القاموس يُمثّل الكائنات العامّة في الوحدة التي عُرّفت فيها الدّالة أو التّابع وليس الوحدة التي استُدعيَت منها. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة، لاحظ أنّ المُتغيّر x الذي نُعرّفه داخل الدّالة hello‎‎(‎)‎ لا يظهر في القاموس لأنّه كائن محليّ ...

تعيد الدّالة enumerate()‎ كائنًا قابلًا للتّكرار من النّوع enumerate. وتُستخدم لترقيم الكائنات القابلة للتّكرار. البنية العامة enumerate(iterable, start=0) المعاملات iterable كائن يدعم التّكرار (iteration)، مثل القوائم، والصّفوف والمولّدات والمكرّرات وغيرها. start العدد الذي سيبدأ منه التّرقيم، القيمة الافتراضيّة هي 0. القيمة المعادة كائن قابل للتّكرار من النّوع enumerate. يكون عبارة عن أزواج، الجزء الأول يكون رقم العنصر، والجزء الثّاني يكون العنصر نفسه. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] # قائمة بايثون ...

تُحوّل الدّالة hex()‎ عددًا صحيحًا إلى سلسلة نصيّة ست عشريّة (hexadecimal string) مسبوقة بالمقطع 0x. البنية العامة hex(x) المعاملات x كائن من النّوع int. إن لم الكائن كذلك، فيجب على الكائن أن يُعرّف التّابع الخاصّ ‎_‎_‎index‎_‎_‎()‎ والذي عليه أن يُعيد عددًا صحيحًا. القيمة المعادة سلسلة نصيّة ستّ عشريّة مسبوقة بالسّابقة 0x وفي حالة أحرف صغيرة (lowercase). أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> hex(255) # عدد صحيح موجب '0xff' >>> hex(-42) # عدد صحيح سالب '-0x2a' إن أردت تحويل عدد صحيح ...

تضغط الدالة البيانات المعطاة (كائن bytes) وتعيد البيانات المضغوطة على هيئة كائن bytes. البنية العامة lzma.compress(data, format=FORMAT_XZ, check=-1, preset=None, filters=None) المعاملات ‎data البيانات المراد ضغطها. راجع الكائن LZMACompressor للاطلاع على وصف مفصّل للمعاملات format و check و preset و filters. القيمة المعادة تعيد الدالة كائن bytes يتضمّن البيانات المضغوطة. أمثلة يبين المثال التالي طريقة ضغط البيانات في الذاكرة: import lzma data_in = b"Insert Data Here" data_out = lzma.compress(data_in) انظر أيضًا الدالة lzma.decompress()‎: تفكّ الدالة الضغط عن البيانات المعطاة (كائن bytes) وتعيد البيانات ...

تعيد الدّالة any()‎ القيمة True إن كان أحد عناصر الكائن القابل للتكرار (iterable) المعطى يساوي القيمة True أو إن كان الكائن القابل للتكرار فارغًا. البنية العامة any() المعاملات iterable كائن قابل للتكرار، يُمكن أن يكون قائمةً أو مجموعةً أو سلسلةً نصيّة أو أيّ كائنٍ يُمكنك استخدام حلقة التّكرار for عليه للوصول إلى كلّ قيمةٍ من قيمه على حدى. القيمة المعادة القيمة True إن كان أحد عناصر الكائن القابل للتكرار المعطى يُساوي القيمة True أو إن كان الكائن القابل للتكرار فارغًا. ...

تعيد الدّالة itertools.zip_longest()‎ مُكرّرًا يُركّب العناصر من كلّ كائن من الكائنات القابلة للتّكرار المُعطاة. إن كانت الكائنات القابلة للتّكرار غير مُتساويّة في الطّول، فستُستخدم قيمة لملء الفراغات. يُكمل التّكرار إلى أن تنتهي قيم أطول كائن من الكائنات القابلة للتّكرار. البنية العامة itertools.zip_longest(*iterables, fillvalue=None) المعاملات iterables الكائنات القابلة للتّكرار المُراد تركيبها. fillvalue القيمة التي ستُملؤ بها الفراغات. إن لم تُعيّن قيمة للمُعامل فالقيمة الافتراضيّة تكون القيمةَ None. القيمة المعادة مُكرّر يُعيد صفوفًا تُركّب عناصرها من عناصر الكائنات القابلة للتّكرار المُعطاة، ويملؤ ...

‎ تفتح الدالة الملف المعطى وتعيد كائنًا موافقًا له. البنية العامة dbm.open(file, flag='r', mode=0o666) المعاملات file إن كان ملف قاعدة البيانات موجودًا أصلًا، فستستخدم الدالة whichdb()‎ لتحديد نوعه والوحدة المناسبة للاستخدام، أما إن لم يكن الملف موجودًا فستستخدم الدالة أول وحدة قابلة للاستيراد من الوحدات dbm.gnu أو dbm.ndbm أو dbm.dumb. flag يأخذ المعامل الاختياري flag إحدى القيم التالية: القيمة الوصف 'r' فتح قاعدة البيانات للقراءة فقط (القيمة الافتراضية). 'w' فتح قاعدة البيانات للكتابة والقراءة. 'c' فتح قاعدة البيانات للكتابة والقراءة، ...

تُغلِق الدالة واصِف الملف المُمرَّر. البنية العامة close(fd) المعاملات fd واصِف الملف المُراد إغلاقه. القيمة المعادة لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None). ملاحظة: هذه الدالة مُخصَّصة لعمليات الإدخال والإخراج مُنخفِضة المستوى، وينبغي استخدامها على واصفات الملفات المُعادة من دوال مثل ()os.open أو ()os.pipe. لإغلاق "كائِن ملف" مُعاد من دالة مَضمَّنة في بايثون مثل ()open، أو من دوال مثل ()os.popen أو ()os.fdopen، استخدم التابِع ()close الخاص به. أمثلة يبيّن المثال التالي آلية عمل الدالة. >>> import os >>> ...

تعيد الدالة الإعدادات الحالية الخاصة باليوم الذي يبدأ به الأسبوع. البنية العامة ‎calendar.firstweekday() القيمة المعادة تعيد الدالة الإعدادات الحالية الخاصة باليوم الذي يبدأ به الأسبوع. أمثلة يبين المثال التالي طريقة استخدام الدالة: >>> import calendar >>> calendar.firstweekday() 1 انظر أيضًا الدالة setfirstweekday()‎: تعيّن الدالة اليوم الذي يبدأ به الأسبوع. مصادر صفحة General calendar-related functions في توثيق بايثون الرسمي.

سكربت اختبار CGI، يمكن استخدامه كبرنامج رئيسي. تكتب الدالة ترويسة HTTP مصغّرة وتنسّق جميع المعلومات المقدّمة إلى السكربت في نموذج HTML. البنية العامة cgi.test() مصادر صفحة Common Gateway Interface support في توثيق بايثون الرسمي.

تعيد الدالة مصفوفة matrix تمثّل تقويم الشهر. البنية العامة calendar.monthcalendar(year, month) المعاملات year السنة المطلوبة. month الشهر المطلوب (من 1 إلى 12). القيمة المعادة تعيد الدالة قائمة تتضمّن مصفوفة matrix تمثّل تقويم الشهر، ويعبّر كل صفّ row في هذه المصفوفة عن أسبوع واحد، أما الأيام التي تكون خارج نطاق الشهر المحدّد فتأخذ القيمة 0. يبدأ كل أسبوع بيوم الإثنين ما لم تحدّد بداية الأسبوع بواسطة الدالة setfirstweekday()‎. أمثلة يبين المثال التالي طريقة استخدام الدالة: >>> import calendar >>> calendar.monthcalendar(2018, 8) [[0, 1, ...

تعيد الدّالة callable()‎ قيمة منطقيّة تُشير إلى ما إذا كان الكائن المُعطى قابلًا للاستدعاء أم لا. البنية العامة callable(object) المعاملات object الكائن المرغوب التّحقق من قابليّة استدعائه. القيمة المعادة القيمة True إن كان الكائن قابلًا للاستدعاء، والقيمة False إن كان الكائن غير قابل للاستدعاء. أمثلة المثال التّالي يوضّح طريقة عمل الدّالة: >>> callable(len) # هنا الكائن دالّةٌ مُضمّنة True >>> x = 1 >>> callable(x) # المتغيّرات التي تحمل قيما عاديّة لا تكون قابلة للاستدعاء False >>> def test(): ... pass ... >>> ...

تعيد الدّالة vars()‎ قيمة الخاصيّة ‎_‎_‎dict‎_‎_‎ الخاصّة بوحدة، أو صنف، أو نُسخة، أو أيّ كائن يمتلك خاصيّةً باسم ‎_‎_‎dict‎_‎_‎. تملك الكائنات مثل الوحدات والنّسخ خاصيّة ‎_‎_‎dict‎_‎_‎ يُمكن تحديثها، لكنّ كائنات أخرى قد تفرض قيودًا على خاصيّة ‎_‎_‎dict‎_‎_‎ الخاصّة بها (فمثلا، يُمكن للأصناف استعمال النّوع ‎‎types‎.‎MappingProxyType‎ لمنع تحديث القاموس مُباشرةً). البنية العامة vars([object]) المعاملات object مُعامل اختياريّ يُمثّل الكائن المرغوب الحصول على قيمة الخاصيّة ‎_‎_‎dict‎_‎_‎ الخاصّة به. القيمة المعادة قيمة الخاصيّة ‎_‎_‎dict‎_‎_‎ الخاصّة بالكائن، وتُمثّل قيمته قاموسًا يحتوي على خاصيّات الكائن ...

تحوّل الدالة الحروف '&' و '>' و '<' في السلسلة النصية المعطاة إلى تسلسل حروف آمن في HTML. تُستخدم هذه الدالة لعرض النصوص التي قد تحتوي على مثل هذه المحارف. ملاحظة: هذه الدالة مهملة منذ الإصدار 3.2 من بايثون. هذه الدالة غير آمنة لأنّ المعامل quote يحمل قيمة خاطئة افتراضيًا. استخدم الدالة html.escape()‎ عوضًا عنها. البنية العامة cgi.escape(s, quote=False) المعاملات s السلسلة النصية التي ستحول الدالة حروفها إلى تسلسل حروف آمن في HTML. ‎quote معامل اختياري، إن أخذ قيمة صحيحة ...

تعيد الدالة قائمة تضمّ العدد المحدّد من أكبر العناصر في مجموعة البيانات dataset المعرّفة بواسطة كائنات التكرار المعطى. البنية العامة heapq.nlargest(n, iterable, key=None) المعاملات n عدد العناصر المطلوبة. iterable كائن التكرار المراد البحث فيه عن العناصر. key يحدّد هذا المعامل -في حال تعيينه- دالة ذات معامل واحد تُستخدم لاستخلاص مفتاح مقارنة من كل عنصر في المكرّر، مثل: key=str.lower. القيمة المعادة تعيد الدالة قائمة تضمّ n من أكبر العناصر في مجموعة البيانات dataset المعرّفة بواسطة كائن التكرار. هذه الدالة مكافئة للدالة ...

تُعيد الدالة تمثيل نظام الملفات من المسار المُمرَّر. البنية العامة fspath(path) سجل التغييرات الإصدار التغييرات 3.6 أُضيفت الدالة في هذا الإصدار. المعاملات path المسار المُراد الحصول على تمثيله بنظام الملفات. القيمة المعادة ستُعيد الدالة قيمة غير مُغيَّرة من الأصل إن مُرِّرَ لها سلسلة نصيّة أو سلسلة بايتات تُمثِّل تمثيل المسار المُمرَّر بنظام الملفات. سيُستدعى التابِع ()__fspath__ إن مُرِّرَ للدالة مُعطىً من نوع آخر، وسيُعيد التابِع قيمته فقط إن كان كائِنه سلسلةً نصيّة أو سلسلة بايتات. ستُصدِر الدالة الاستثناء TypeError إن ...

تعيد الدّالة itertools.groupby()‎ مُكرّرًا يُعيد مفاتيح مُتسلسلة ومجموعات (groups) تنتمي إلى هذه المفاتيح من الكائن القابل للتّكرار المعطى. العمليّة التي تقوم بها الدّالة مُشابهة لكيفيّة عمل المُرشّح uniq في أنظمة Unix. إذ تُولّد نقطة توقّف (break) أو مجموعة جديدة في كلّ مرّة تتغيّر فيها قيمة الدّالةِ المفتاح (لذا يجب في الغالب ترتيب البيانات باستعمال نفس الدّالة المفتاح). وطريقة العمل هذه تختلف عن طريقة عمل عبارة GROUP BY في لغة SQL التي تجمع العناصر المُشتركة بغضّ النّظر عن ترتيب البيانات. البنية ...

تحلّل الدالة مدخلات (ترتيب تحليل التوابع MRO) بصورة ديناميكية وكما هو محدّد في PEP 560. ملاحظة: هذه الدالة جديدة في الإصدار 3.7 من اللغة. البنية العامة types.resolve_bases(bases) المعاملات bases الأصناف الأساسية المراد تحليلها. القيمة المعادة تبحث هذه الدالة عن العناصر في الأصناف المعطاة في المعامل bases والتي لا تكون نسخًا من الصنف type، وتعيد الدالة صفًّا يُستبدل فيه كل كائن مماثل ولا يملك التابع __mro_entries__ بنتيجة استدعاء هذا التابع بعد فكّ تحزيمها. أما إن كان الصنف المعطى في المعامل bases ...

تعرض الدالة العنوان المعطى في المتصفّح الافتراضي. البنية العامة webbrowser.open(url, new=0, autoraise=True) ‎ المعاملات ‎url العنوان المراد فتحه في المتصفّح. new معامل اختياري، يمكن أن يأخذ القيمة 0 وحينئذٍ يُفتح العنوان المعطى في نفس نافذة المتصفّح إن كان ذلك ممكنًا. وإن أخذ القيمة 1، تفتح الدالة نافذة متصفّح جديدة إن كان ذلك ممكنًا، وإن أخذ المعامل القيمة 2 فإنّ الدالة تفتح صفحة متصفّح (tab) جديدة إن كان ذلك ممكنًا. autoraise إن أخذ هذا المعامل القيمة True، فإنّ نافذة المتصفّح ستُعرض ...

تعيد الدّالة round()‎ قيمة العدد المُعطى مُقرّبًا حسب عدد الأرقام كتقريب بعد الفاصلة. البنية العامة round(number[, ndigits]) المعاملات number العدد المُراد تقريبه. ndigits مُعامل اختياريّ يُمثّل عدد الأرقام بعد الفاصلة ويكون عددًا صحيحًا (سواء أكان سالبًا، أو موجبًا، أو صفرًا). إن لم تُمرّر له أيّة قيمة أو مُرّرت إليه القيمة None، فستُعيد الدّالة أقرب عدد صحيح للمُعامل number. القيمة المعادة عدد مُقرّب حسب المُعاملات المُعطاة. تُقرّب القيم إلى أقرب مُضاعف من مُضاعفات 10 مرفوعًا إلى قوّة ناقص العدد المُمرّر إلى ...

تعيد الدالة معرّف URI الكامل في الطلب، -يمكن أن تتضمّن النتيجة المعادة سلسلة الطلب النصية- باستخدام الخوارزمية الموجودة في قسم "URL Reconstruction" في PEP 3333. البنية العامة wsgiref.util.request_uri(environ, include_query=True) المعاملات environ ‎environ قاموس متوافق مع WSGI. يمكن مراجعة PEP 3333 للاطلاع على المزيد من التفاصيل. include_query لن تُضمّن سلسلة الطلب النصية في معرّف URI الناتج إن أخذ هذا المعامل قيمة خاطئة. القيمة المعادة تعيد الدالة معرّف URI الكامل في الطلب مصادر قسم WSGI environment utilities في صفحة WSGI Utilities and Reference ...

تُستخدم الدّالة eval()‎ لتقدير (evaluate) تعبير بايثون. يُقدّر التّعبير المُعطى باستخدام مُعامل الكائنات العامّة globals والكائنات المحليّة locals. البنية العامة eval(expression, globals=None, locals=None) المعاملات expression سلسلة نصيّة تُمثّل تعبير بايثون المُراد تقديره أو كائن شيفرة كذلك الذي تُعيده الدّالة compile()‎. globals مُعامل اختياريّ. قاموس يُمثّل الكائنات العامّة التي ستُمرّر إلى التّعبير. إن مُرّر هذا المُعامل دون الكائن ‎_‎_‎builtins‎_‎_‎، فستُنسَخ الكائنات العامّة الحاليّة وتُمرّر إلى المُعامل قبل مُعالجة التّعبير. ما يعني أنّ التّعبير يحصل طبيعيًّا على كامل حقوق الوصول إلى الوحدة ...

تعيد الدالة قائمة تضمّ العدد المحدّد من أصغر العناصر في مجموعة البيانات dataset المعرّفة بواسطة كائنات التكرار المعطى. البنية العامة heapq.nsmallest(n, iterable, key=None) المعاملات n عدد العناصر المطلوبة. iterable كائن التكرار المراد البحث فيه عن العناصر. key يحدّد هذا المعامل -في حال تعيينه- دالة ذات معامل واحد تُستخدم لاستخلاص مفتاح مقارنة من كل عنصر في المكرّر، مثل: key=str.lower. القيمة المعادة تعيد الدالة قائمة تضمّ n من أكبر العناصر في مجموعة البيانات dataset المعرّفة بواسطة كائن التكرار. هذه الدالة مكافئة للدالة ...

تُعيد الدالة مُعرِّف العملية الحالية. البنية العامة getpid() القيمة المعادة تُعيد الدالة نوع عددي صحيح يُمثِّل مُعرِّف العملية الحالية. أمثلة يعرض المقتطف أدناه مثال على الحصول على مُعرِّف العملية الحالية (مُفسِر بايثون). >>> from os import getpid >>> getpid() 2761 مصادر قسم الوحدة os في توثيق بايثون الرسمي.

يعالج هذا التابع خطأً معيّنًا في البروتوكول المعطى. يستدعي التابع معالج الخطأ المسجّل للبروتوكول المعطى مستخدمًا الوسائط المعطاة (والتي تكون خاصّة بكل بروتوكول). بروتوكول HTTP هو حالة خاصة تستخدم شيفرة استجابات HTTP لتحديد معالج الخطأ المطلوب. راجع التوابع http_error_*()‎ الخاصّة بأصناف المعالجة. البنية العامة OpenerDirector.error(proto, *args) ‎المعاملات معاملات هذا التابع والقيمة المعادة والاستثناءات التي يُطلقها مشابهة لتلك الموجودة في الدالة urlopen()‎. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

تتعامل هذه الدالة مع استثناء معيّن باستخدام الإعدادات الافتراضية (عرض التقرير في متصفّح الويب، ولكن عدم حفظه في ملف منفصل). يمكن استخدام هذه الدالة عندما يكون هناك استثناء لم تلتقطه بايثون وترغب في عرض تقرير عنه باستخدام الوحدة cgitb. البنية العامة cgitb.handler(info=None) ‎المعاملات info معامل اختياري، وهو عبارة عن صفٍّ tuple مكوّن من ثلاثة عناصر هي نوع الاستثناء، وقيمة الاستثناء وكائن traceback، وهذا الصفّ مشابه للصفّ الذي تعيده الدالة sys.exc_info()‎. في حال عدم تزويد الدالة بالمعامل info، يُؤخذ الاستثناء الحاليّ ...

تحوّل هذه الدالة أوائل الكلمات في السلسلة النصية المعطاة إلى أحرف كبيرة. البنية العامة string.capwords(s, sep=None) المعاملات s السلسلة النصية المراد معالجتها. sep تعتمد الدالة قيمة المعامل الاختياري sep كفاصل تقسم بواسطة كلمات السلسلة النصية ثم تربطها بعضها ببعض. في حال لم يأخذ هذا المعامل أيّ قيمة، أو أخذ القيمة None، فإنّ المسافات البيضاء مهما كان عددها ستستبدل بمسافة بيضاء واحدة، وستُحذف المسافات البيضاء من بداية ونهاية السلسلة النصية أيضًا. القيمة المعادة تقسم الدالة السلسلة النصية المعطاة إلى كلمات باستخدام ...

هذه الدالة هي المسؤولة الحقيقية عن جميع عمليات التنسيق، وهي دالة مكشوفة (exposed) كدالة منفصلة لاستخدامها في الحالات التي يكون المطلوب فيها تمرير قاموس معاملات معرّف مسبقًا، بدلًا عن فك تحزيم القاموس وإعادة تحزيمه مرة أخرى كمعاملات منفردة باستخدام الصيغتين ‎*args و ‎**kwargs. البنية العامة vformat(format_string, args, kwargs) طريقة عمل الدالة تؤدي هذه الدالة مهمّة تقسيم سلسلة التنسيق النصية إلى بيانات حرفية وحقول استبدال، وتستدعي جميع التوابع التالية: parse(format_string)‎ يمرّ هذا التابع على سلسلة التنسيق النصية الممرّرة بواسطة المعامل format_string ...

تعيد الدّالة abs()‎ القيمة المطلقة (absolute value) لعدد معيّن. البنية العامة abs() المعاملات number عدد يُمكن له أن يكون صحيحًا أو عشريًّا أو عددًا عقديًّا (complex number). القيمة المعادة تُعاد القيمة المطلقة للعدد، إن كان المُعامل عددًا عقديّا، فستُعاد جسامته (magnitude). أمثلة إليك مثالًا على بعضٍ من نتائج استدعاء الدّالة مع تمرير قيم عدديّة (number) إليها: >>> abs(5) 5 >>> abs(-5) 5 >>> abs(-5.2) 5.2 انظر أيضًا الأعداد الصحيحة (int). الأعداد العشرية (float). الأعداد المركبة (complex). مصادر قسم الدالة abs في صفحة Functions في ...

تعيد الدالة كائن controller لنوع المتصفّح المعطى. البنية العامة webbrowser.get(using=None) المعاملات ‎using إن أخذ هذا المعامل القيمة None فإنّ الدالة ستعيد كائنًا للمتصفّح الافتراضي يكون ملائمًا لبيئة الاستدعاء. هناك عددٌ من أنواع المتصفّحات المعرّفة مسبقًا، ويبين الجدول التالي أسماء هذه الأنواع والتي يمكن تمريرها إلى الدالة get()‎ وإنشاء أصناف ذات أنواع مختلفة: اسم المتصفح الصنف ملاحظات 'mozilla' Mozilla('mozilla')‎   'firefox' Mozilla('mozilla')‎   'netscape' Mozilla('netscape')‎   'galeon' Galeon('galeon')‎   'epiphany' Galeon('epiphany')‎   'skipstone' BackgroundBrowser('skipstone')‎   'kfmclient' Konqueror()‎ (1) 'konqueror' Konqueror()‎ (1) ...

تحوّل الدالة المسار المعطى من الصيغة المستخدمة في المسارات المحلية إلى الصيغة المستخدمة في عناوين URL. لا تنتج الدالة عنوان URL كاملًا. تكون النتيجة المعادة محاطة بعلامات الاقتباس وذلك باستخدام الدالة quote()‎. البنية العامة urllib.request.pathname2url(path) المعاملات path المسار المراد تحويله. أمثلة يبين المثال التالي طريقة عمل الدالة: >>> import urllib.request >>> urllib.request.pathname2url('main/images/big_title.png') 'main/images/big_title.png' >>> urllib.request.pathname2url('main/images/big title.png') 'main/images/big%20title.png' مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

تستدعي الدالة نداء النظام ()setsid الذي يُنشِئ جلسة جديدة ويضبط مُعرِّف مجموعة العملية. البنية العامة setsid() الدالة متوافرة في أنظمة يونكس. القيمة المعادة لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None). لاحظ أنَّ الدالة يجب أن تُنفَّذ من مُستخدِم يملك صلاحيات الجذر. طالِع صفحة الدليل لنداء النظام ()setsid للمزيد من التفاصيل. أمثلة يُبيّن المثال التالي آلية عمل الدالة. >>> from os import setsid >>> setsid() مصادر قسم الوحدة os في توثيق بايثون الرسمي.

هذه الدالة مشابهة للدالة urlparse()‎ ولكنّها لا تقسم المعاملات من عنوان URL. يجب استخدام هذه الدالة بصورة عامة عوضًا عن الدالة urlparse()‎ إن كان المطلوب استخدام صيغة URL حديثة تتضمّن السماح بتطبيق المعاملات لكل جزء من أجزاء المسار في عنوان URL (راجع المعيار RFC 2396). يجب استخدام دالة أخرى لفصل أقسام المسار ومعاملاته. تعيد هذه الدالة صفًّا مؤلّفًا من 5 عناصر (نظام العنونة addressing scheme، موقع الشبكة، المسار، الاستعلام، محدّد القطعة fragment identifier). البنية العامة urllib.parse.urlsplit(urlstring, scheme='', allow_fragments=True) ‎المعاملات urlstring ...

تفتح الدالة قاعدة بيانات dumbdbm وتعيد كائن dumbdbm. البنية العامة dbm.dumb.open(filename[, flag[, mode]]) المعاملات filename الاسم الأساسي لملف قاعدة البيانات (ليس هناك امتداد خاص). عند إنشاء قاعدة بيانات dumbdbm تنشئ الدالة ملفات بامتداد ‎.dat و ‎.dir أيضًا. flag يأخذ هذا المعامل الاختياري القيمتين 'c' (فتح قاعدة البيانات للكتابة والقراءة، وإنشائها في حال عدم وجودها) و 'n'(تنشئ الدالة قاعدة بيانات جديدة وفارغة، وتفتحها للكتابة والقراءة)، وتحوّل أي قيمة أخرى إلى القيمة 'c'. mode المعامل الاختياري mode هو وضع يونكس Unix mode ...

تحلّل الدالة عنوان URL إلى ستّة مكونات، وتعيد صفًّا يتضمّن 6 عناصر. تمثّل هذه المكونات البنية الرئيسية لعنوان URL وهي: scheme://netloc/path;parameters?query#fragment. يكون كل عنصر في الصفّ سلسلة نصية، وقد يكون فارغًا كذلك. لا تقسّم المكوّنات إلى أجزاء أصغر (على سبيل المثال، يكون موقع الشبكة سلسلة نصية مفردة) ولا يجري توسعة علامات التهريب %، ولا تكون الفواصل جزءًا من النتيجة المعادة، باستثناء الخط المائل الأمامي في مكوّن المسار، والتي تعاد مع النتائج إن كانت موجودة. البنية العامة urllib.parse.urlparse(urlstring, scheme='', allow_fragments=True) ‎المعاملات ...

تحوّل الدالة الكائنات الشبيهة بالبايتات إلى قيمة. البنية العامة marshal.loads(bytes) ‎المعاملات bytes كائن شبيه بالبايتات. القيمة المعادة تحوّل الدالة الكائنات الشبيهة بالبايتات إلى قيمة. في حال عدم عثور الدالة على أي قيمة سليمة، تطلق اللغة الاستثناء EOFError أو ValueError أو TypeError، وتتجاهل الدالة البايتات الإضافية في المدخلات. أمثلة يبين المثال التالي آلية عمل الدالة: >>> import marshal >>> b1 = marshal.dumps('Hello World') >>> print(b1) b'\xfa\x0bHello World' >>> marshal.loads(b1) 'Hello World' انظر أيضًا الدالة marshal.load()‎: تعيد الدالة كائن bytes الذي ستجري كتابته في ملفّ معين بواسطة ...

تعيد الدّالة itertools.compress()‎ مُكرّرًا يُرشّح العناصر المتواجدة داخل الكائن القابل للتّكرار المُعطى مُعيدًا فقط تلك التي تملك عنصرًا مُحدّدًا يُساوي القيمة المنطقيّة True. ويتوقّف المُكرّر عندما تنتهي قيم البيانات المُعطاة أو قيم المُحدّدات. البنية العامة itertools.compress(data, selectors) المعاملات data البيانات التي ستُرشّح. selectors المُحدّدات التي تُحدّد ما إذا كانت البيانات ستنضم إلى المُكرّر المُعاد أو لا. القيمة المعادة مُكرّر يحتوي على عناصر الكائن data التي تُساوي مُحدّداتها القيمة المنطقيّة True. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> data ...

تعيد الدّالة itertools.starmap()‎ مُكرّرًا يستدعي الدّالة باستخدام المُعاملات المُعطاة في الكائن القابل للتّكرار. تُستعمل عوضًا عن الدالة map()‎ عندما تكون قيم المُعاملات مُجموعةً في صفّ في كائن واحد قابل للتّكرار (أي أنّ البيانات قد جُمِّعَت مُسبقًا). الفرق بين الدالة map()‎ والدّالة itertools.starmap()‎ يُوازي الفرق بين الاستدعاء function(a,b)‎‎ والاستدعاء function(*c)‎‎. البنية العامة itertools.starmap(function, iterable) المعاملات function الدّالة المُراد استدعاؤها. iterable كائن قابل للتّكرار يحتوي على صفوف لتُمرّر إلى الدّالة كمُعاملات مُفكّكة. القيمة المعادة مُكرّر يُعيد نتائج استدعاء الدّالة واحدة بواحدة. أمثلة ...

تدمج الدالة عدة مدخلات مفروزة في مخرج مفرد مفروز . (على سبيل المثال: دمج عناصر ذات ختم زمني من ملفات تسجيل متعددة). البنية العامة heapq.merge(*iterables, key=None, reverse=False) المعاملات ‎*iterables يجب أن تكون جميع المُكرَّرات iterables مفروزة من الأكبر إلى الأصغر. key معامل اختياري يجب تعيينه كمعامل مفتاحي، يحدّد هذا المعامل دالة مفتاحية key function ذات معامل واحد تستخدم في استخلاص مفتاح مقارنة من كل عنصر في مدخلات الدالة. القيمة الافتراضية لهذا المعامل هي None وتجرى مقارنة العناصر على نحو مباشر ...

يقوم مُزخرف الأصناف functools.total_ordering()‎ بزخرفة صنف يُعرّف تابعًا أو عدّة توابع ترتيب مُقارنة غنيّة (rich comparison ordering methods)، ويقوم بإضافة بقيّة توابع المُقارنة. يُبسّط هذا الجهد المبذول في تحديد جميع عمليّات المُقارنة الغنيّة المُمكنة. يجب على الصّنف أن يُعرّف التّابع الخاصّ ‎__lt__()‎، أو ‎__le__()‎، أو ‎__gt__()‎، أو ‎__ge__()‎. إضافة إلى التّابع الخاصّ ‎__eq__()‎. البنية العامة @functools.total_ordering المعاملات لا توجد مُعاملات. أمثلة المثال التّالي يوضّح كيفيّة استعمال المُزخرف للمُقارنة بين سياراتٍ حسب سُرعتها، تابع حالة التّساوي يُشير إلى أنّ نُسخةً من ...

تفتح الدالة ملفًّا مضغوطًا بواسطة gzip في النمط الثنائي binary mode أو النصي text mode، وتعيد كائن ملف. البنية العامة gzip.open(filename, mode='rb', compresslevel=9, encoding=None, errors=None, newline=None) المعاملات ‎filename يمكن للمعامل filename أن يكون اسم ملف حقيقي (سلسلة نصية أو كائن bytes) أو كائن ملفٍّ موجودًا بالفعل، يمكن القراءة منه والكتابة فيه. mode يمكن يأخذ المعامل mode إحدى القيم التالية: ‎'r'، 'rb'، 'w'، 'wb'، 'x'، 'xb'، 'a'، 'ab'‎ للنمط الثنائي، والقيم ‎'rt'، 'wt'، 'xt'، 'at'‎ للنمط النصي، والقيمة الافتراضية لهذا المعامل ...

تعيد الدالة تمثيلًا على هيئة سلسلة نصية للكائن المعطى، ومحميًا تجاه بنى البيانات التعاودية. البنية العامة pprint.saferepr(object) القيمة المعادة تعيد الدالة تمثيلًا على هيئة سلسلة نصية للكائن المعطى، ومحميًا تجاه بنى البيانات التعاودية. إن تضمّن تمثيل الكائن المعطى عنصرًا تعاوديًا، فإنّ الإشارة التعاودية ستمثّل بالصيغة ‎<Recursion on typename with id=number>‎، ولا يُنسّق التمثيل بطريقة أخرى. أمثلة يبين المثال التالي آلية عمل الدالة: >>> import pprint >>> stuff = ['spam', 'eggs', 'lumberjack', 'knights', 'ni'] >>> stuff.insert(0, stuff) >>> pprint.pprint(stuff) [<Recursion on list with id=...>, 'spam', ...

ترمّز الدالة كائن bytes إلى سلسلة نصية تتضمن عددين ستّ عشريين مقابل كلّ بايت. البنية العامة hex() القيمة المعادة تعيد الدالة سلسلة نصية تتضمّن عددين ستّ عشريين مقابل كلّ بايت. أمثلة يبين المثال التالي النتائج المعادة من تطبيق الدالة: >>> bytes = b'\xf0\xf1\xf2' >>> bytes.hex() 'f0f1f2' انظر أيضًا الدالة bytes.fromhex()‎: فك ترميز سلسلة نصية تتضمن أعداد ست عشرية إلى كائن bytes. مصادر قسم hex في صفحة Types في توثيق بايثون الرسمي.

تُحوّل الدّالة format()‎ قيمةً مُعطاةً إلى تمثيل مُنسّق حسب ما تُحدّده مواصفة التّنسيق المُعطاة. البنية العامة format(value[, format_spec]) المعاملات value القيمة المرغوب تنسيقها. format_spec مُعامل اختياريّ تكون قيمته الافتراضيّة سلسلةً نصيّةً عادة ما تُعطي نفس تأثير الاستدعاء str‎(‎value‎)‎. القيمة المعادة القيمة المُنسّقة حسب المواصفة المُعطاة. تختلف آليّة تفسير المواصفة المُعطاة للمُعامل format_spec حسب نوع قيمة المُعامل value، لكنّ هناك بنية قياسيّة للتنسيق تُستخدم من طرف مُعظم الأنواع المُضمّنة في لغة بايثون. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> ...

تحسب هذه الدالة صنف ميتا المناسب وتنشئ نطاق الأسماء. البنية العامة types.prepare_class(name, bases=(), kwds=None) المعاملات name اسم الصنف المراد إنشاؤه. bases الأصناف الأساسية التي سيرث منها الصنف الجديد (حسب الترتيب). kwds المعاملات المفتاحية (مثل صنف ميتا). القيمة المعادة تعيد الدالة صفًّا يحمل ثلاث قيم هي: metaclass, namespace, kwds. metaclass هي صنف ميتا المناسب، و namespace هي نطاق الأسماء المحضّر للصنف، وkwds هي نسخة محدّثة من قيمة المعامل kwds بعد حذف أي مدخل من مدخلات 'metaclass'. وإن لم يمرّر المعامل kwds ...

هذه الدالة مشابهة للدالة quote()‎ ولكنّها تستقبل كائنات bytes عوضًا عن كائنات str، ولا تؤدي عمليات الترميز من السلاسل النصية إلى البايتات. البنية العامة urllib.parse.quote_from_bytes(bytes, safe='/') ‎المعاملات bytes كائن bytes. safe يحدّد هذا المعامل محارف ASCII الإضافية التي يجب على الدالة أن لا تحيطها بعلامات اقتباس. يأخذ هذا المعامل القيمة الافتراضية '/'. أمثلة يبين المثال التالي طريقة عمل الدالة: >>> import urllib.parse >>> urllib.parse.quote_from_bytes(b'a&\xef') 'a%26%EF' انظر أيضًا الدالة urllib.parse.quote()‎: تستبدل الدالة الحروف الخاصة في السلسلة النصية المعطاة باستخدام علامة التهريب ‎%xx. الدالة ...

تطبع الدّالة print()‎ الكائنات المُعطاة. تُفصَل القيم المطبوعة بقيمة المُعامل sep وتُتبع بقيمة المُعامل end. البنية العامة print(*objects, sep=' ', end='\n', file=sys.stdout, flush=False) المعاملات objects مُعامل اختياريّ يُمثّل الكائنات التّي ستُطبع. تُحوّل الكائنات إلى سلاسل نصيّة كما تفعل الدّالة ‎str‎(‎)‎ قبل كتابتها إلى التّيار file مفصولة بالفاصل sep ومتبوعة باللاحقة end. sep مُعامل كلمة مفتاحيّة (يجب عليك تمرير اسم المُعامل مع قيمته). وهو مُعامل اختياريّ. السّلسلةَ النّصيّة التّي ستَفصِل بين كلّ كائن من الكائنات التي ستُطبع. القيمة الافتراضيّة هي مسافة ...

تنشئ الدالة مخدّم WSGI يستمع إلى المضيف والمنفذ المعطيين، ويستقبل الاتصالات من التطبيق المعطى. تعيد الدالة نسخة من صنف المخدّم المعطى وستعالج الطلبات باستخدام صنف المعالجة المعطى. البنية العامة wsgiref.simple_server.make_server(host, port, app, server_class=WSGIServer, handler_class=WSGIRequestHandler) المعاملات host المضيف الذي ستستمع إليه الدالة. port المنفذ الذي ستستمع إليه الدالة. app يجب أن يكون كائن تطبيق WSGI كما هو معرّف في PEP 3333. server_class صنف المخدّم الذي ستعيد الدالة نسخة منه. handler_class صنف المعالجة الذي ستستخدمه الدالة في معالجة الطلبات. راجع وحدة wsgiref.handlers. ...

تعيد الدّالة all()‎ القيمة True إن كانت جميع عناصر الكائن القابل للتكرار (iterable) المعطى تُساوي القيمة True أو إن كان الكائن القابل للتكرار فارغًا. البنية العامة all() المعاملات iterable كائن قابل للتكرار، يُمكن أن يكون قائمةً أو مجموعةً أو سلسلةً نصيّة أو أيّ كائنٍ يُمكنك استخدام حلقة التّكرار for عليه للوصول إلى كلّ قيمةٍ من قيمه على حدى. القيمة المعادة القيمة True إن كانت جميع عناصر الكائن القابل للتكرار المعطى تُساوي القيمة True أو إن كان الكائن القابل للتكرار فارغًا. ...

تضبط الدالة المُعرَّف الحقيقي والفعلي لمُستخدِم العملية الحالية. البنية العامة setreuid(ruid, euid) الدالة متوافرة في أنظمة يونكس. المعاملات ruid المُعرِّف الحقيقي الجديد المُراد إسناده لمُستخدِم العملية الحالية. euid المُعرِّف الفعلي الجديد المُراد إسناده لمُستخدِم العملية الحالية. القيمة المعادة لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None). لاحظ أنَّ الدالة يجب أن تُنفَّذ من مُستخدِم يملك صلاحيات الجذر. أمثلة يُبيّن المثال التالي آلية عمل الدالة. >>> from os import setreuid >>> setreuid(1, 2) مصادر قسم الوحدة os في توثيق بايثون الرسمي. ...

تضبط الدالة مُعرِّف المجموعة الفعلي للعملية الحالية. البنية العامة setegid(egid) الدالة متوافرة في أنظمة يونكس. المعاملات egid المُعرِّف المُراد إسناده للعملية الحالية. القيمة المعادة لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None). لاحظ أنَّ الدالة يجب أن تُنفَّذ من مُستخدِم يملك صلاحيات الجذر. أمثلة في المقتطف أدناه مثال عن تعيين قيمة جديدة لمُعرِّف المجموعة الفعلي عبر الدالة ()os.setegid والحصول عليها بواسطة الدالة ()os.getresgid. >>> from os import setegid, getresgid >>> getresgid()[1] 0 >>> setegid(1) >>> getresgid()[1] 1 انظر أيضًا الدالة ()os.getresgid: تُعيد صفًّا يحتوي ...

تُعيد الدالة قائمة بمُعرِّفات المجموعات الإضافيّة (supplemental group) المرتبطة بالعملية الحالية. البنية العامة getgroups() الدالة متوافرة في أنظمة يونكس. القيمة المعادة تُعيد الدالة قائمة بمُعرِّفات المجموعات الإضافيّة (supplemental group) المرتبطة بالعملية الحالية. أمثلة >>> from os import getgroups >>> getgroups() [10, 63, 171, 994, 1000] مصادر قسم الوحدة os في توثيق بايثون الرسمي.

تعيد الدّالة hasattr()‎ قيمةً منطقيّةً تُحدّد ما إذا كانت الخاصيّةُ المُعطى اسمُها موجودةً في الكائن المُعطى أم لا. البنية العامة hasattr(object, name) المعاملات object الكائن المُراد التّحقق من وجود الخاصيّة فيه. name سلسلة نصيّة تُمثّل اسم الخاصيّة المرغوب التّحقق من وجودها في الكائن. القيمة المعادة القيمة True إن كانت الخاصيّة موجودة. والقيمة False إن لم تكن كذلك. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> class A: ... x = 1 ... >>> hasattr(A, 'x') # الخاصيّة ...

تخمّن الدالة ما يجب أن تكون عليه قيمة wsgi.url_scheme، إمّا "http" أو "https"، وذلك بالتحقق من قيمة متغير البيئة HTTPS في القاموس المعطى. البنية العامة wsgiref.util.guess_scheme(environ) ‎المعاملات ‎environ قاموس متوافق مع WSGI. يمكن مراجعة PEP 3333 للاطلاع على المزيد من التفاصيل. القيمة المعادة تعيد الدالة النتيجة على هيئة سلسلة نصية. تظهر فائدة هذه الدالة عند إنشاء بوابة لتغليف بروتوكول CGI أو بروتوكول شبيه به مثل FastCGI. وعادة ما تتضمّن المخدّمات التي تقدّم مثل هذه البروتوكولات متغير HTTPS يحمل القيمة "1" أو ...

تسترِد الدّالة ‎__‎‎import‎‎_‎_‎()‎‎ الوحدة المُعطاة. ملاحظة: هذه الدّالة مُتقدّمة غير مطلوبة في برمجة بايثون الاعتياديّة، على عكس الدّالة importlib.import_module. تستدعي الجملة import‎ الدّالةَ ‎__import__()‎ ويُمكن استبدالها عبر استيراد builtins وتعيين دالّة جديدة للخاصيّة ‎builtins‎.‎_‎_‎import‎_‎_‎‎ إن أردت تغيير كيفيّة تصرّف الجملة import‎، لكنّ هذا الأمر غير منصوح به بشدّة إذ عادةً ما تكون خُطّافات الاستيراد (انظر PEP 302) وسيلةً أكثر بساطة للوصول إلى نفس الغاية ولا تُسبّب مشاكل مع الشّيفرة التي تعتمد على كون آليّة الاستيراد طبيعيّة دون تغيّر. واستعمال الدّالة ...

تُعيد الدالة مُعرِّف مجموعة العملية الحالية. البنية العامة getpgrp() الدالة متوافرة في أنظمة يونكس. القيمة المعادة تُعيد الدالة نوع عددي صحيح يُمثِّل مُعرِّف مجموعة العملية الحالية. أمثلة >>> from os import getpgrp >>> getpgrp() 21704 مصادر قسم الوحدة os في توثيق بايثون الرسمي.

تفتح الدالة ملف tar المعطى وتعيد الدالة كائن TarFile للمسار المعطى. راجع قسم كائنات TarFile للاطلاع على المزيد من المعلومات حول هذه الكائنات والمعاملات المفتاحية المتاحة للاستخدام. البنية العامة tarfile.open(name=None, mode='r', fileobj=None, bufsize=10240, **kwargs) المعاملات name مسار ملف الأرشيف tar المراد فتحه. ملاحظة: في الإصدار 3.6 من بايثون أصبح المعامل name يستقبل كائنات شبيهة بالمسارات path-like objects. mode يجب أن يكون هذا المعامل سلسلة نصية بالصيغة ‎'filemode[:compression]'‎، ويأخذ القيمة الافتراضية 'r'. يعرض الجدول التالي قائمة كامل بالقيم المتاحة للاستخدام مع ...

تعيد الدّالة itertools.combinations_with_replacement()‎ تسلسلات فرعيّة (subsequences) تُعدّ تجميعات ذات طول مُحدّد لعناصر الكائن القابل للتّكرار المُعطى مع السّماح للعناصر بأن تُكرَّر لأكثر من مرّة. تُنتَج التّجميعات حسب الترتيب المُعجميّ (lexicographic). ما يعني بأنّ الصّفوف النّاتجة ستكون مُرتّبةً إن كان الكائن القابل للتّكرار المُعطى مُرتّبًا. تُعامَل العناصر على أنّها فريدة حسب موقعها، وليس حسب قيمها. لذا إن كانت عناصر الكائن القابل للتّكرار المُدخَل فريدةً فستكون التّجميعات المُنتجةُ فريدةً كذلك. البنية العامة itertools.combinations_with_replacement(iterable, r) المعاملات iterable الكائن القابل للتّكرار. r طول الصّفوف ...

تعيد الدّالة functools.partialmethod()‎ واصفًا يتصرّف مثل كائنات partial، إلّا أنّه مُصمّم ليُستخدم كتعريف تابع (method definition) عوضًا عن أن يكون قابلا للاستدعاء (callable) مُباشرة. البنية العامة functools.partialmethod(func, *args, **keywords) المعاملات func واصفٌ أو كائن قابل للاستدعاء (تُعامل الكائنات التي تجتمع فيها الصّفتان على أنّها واصفات، مثل الدّوال). عندما يكون func واصفًا (مثل دالّة بايثون عاديّة، أو الدّالة classmethod()‎، أو الدّالة staticmethod()‎، أو نسخة أخرى من partialmethod)، فستُفوّض استدعاءات الخاصيّة ‎__get__‎ إلى الواصف المنشأ، وسيُعاد كائن partial كنتيجة. عندما يكون func ...

تسترِد الدّالة ‎__‎‎import‎‎_‎_‎()‎‎ الوحدة المُعطاة. ملاحظة: هذه الدّالة مُتقدّمة غير مطلوبة في برمجة بايثون الاعتياديّة، على عكس الدّالة importlib.import_module. تستدعي الجملة import‎ الدّالةَ ‎__import__()‎ ويُمكن استبدالها عبر استيراد builtins وتعيين دالّة جديدة للخاصيّة ‎builtins‎.‎_‎_‎import‎_‎_‎‎ إن أردت تغيير كيفيّة تصرّف الجملة import‎، لكنّ هذا الأمر غير منصوح به بشدّة إذ عادةً ما تكون خُطّافات الاستيراد (انظر PEP 302) وسيلةً أكثر بساطة للوصول إلى نفس الغاية ولا تُسبّب مشاكل مع الشّيفرة التي تعتمد على كون آليّة الاستيراد طبيعيّة دون تغيّر. واستعمال الدّالة ...

تطبع الدالة تقويم السنة كاملة والذي تعيده الدالة calendar()‎. البنية العامة calendar.prcal(year, w=0, l=0, c=6, m=3) المعاملات year السنة المطلوبة. w معامل اختياري يأخذ القيمة الافتراضية 0، ويحدّد عرض التقويم الذي ستطبعه الدالة. l معامل اختياري يأخذ القيمة الافتراضية 0، ويحدّد مقدار الفاصل بين الأسطر في التقويم الذي ستطبعه الدالة. c معامل اختياري يأخذ القيمة الافتراضية 6، ويحدّد مقدار الفاصل بين الأعمدة في التقويم. m معامل اختياري يأخذ القيمة الافتراضية 3، ويحدّد عدد الأشهر في كل صفٍّ من صفوف التقويم. ...

تُستعمل الدّالة functools.wraps()‎ كمُزخرف لاستعمال الدّالة functools.update_wrapper()‎ عند تعريف دالّة مُحيطة. الدّالة مُكافئة للدالة الجزئية النّاتجة عن الاستدعاء التالي (انظر الدّالة functools.partial()‎): partial(update_wrapper, wrapped=wrapped, assigned=assigned, updated=updated) البنية العامة @functools.wraps(wrapped, assigned=WRAPPER_ASSIGNMENTS, updated=WRAPPER_UPDATES) المعاملات wrapped الدّالة المُحاطة. assigned الخاصيّات التي ستُعيّن. updated الخاصيّات التي ستُحدّث. القيمة المعادة تُحدّث دالّة مُحيطةً لتبدوَ مثل الدّالة المُحاطة. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> from functools import wraps >>> def my_decorator(f): ... @wraps(f) ... def wrapper(*args, **kwds): ... ...

تُحوّل الدّالة staticmethod()‎ تابعًا إلى تابعٍ ساكن (static method). البنية العامة staticmethod(fun) @staticmethod المعاملات fun الدّالة أو التّابع المُراد تحويله إلى تابعٍ ساكن. القيمة المعادة يُحوّل التّابع المُزخرَف إلى تابعٍ ساكن لا يستقبل مُعاملًا أولًا صريحًا (المُعامل المعروف بالاسم self في التّوابع). أمثلة المثال التّالي يوضّح كيفيّة إنشاء تابع ساكن باستعمال الدّالة staticmethod كمُزخرِف: >>> class A: ... @staticmethod ... def hello(): # لاحظ أنّ التّابع السّاكن لا يستقبل أيّ مُعامل تلقائيّ كما في التّوابع ...

تُعيد الدالة اسم ملف الطرفية المتحكمة بالعملية. البنية العامة ctermid() الدالة متوافرة في أنظمة يونكس. القيمة المعادة تُعيد الدالة اسم ملف الطرفية المتحكمة (controlling terminal) بالعملية. أمثلة >>> from os import ctermid >>> ctermid() '/dev/tty' مصادر قسم الوحدة os في توثيق بايثون الرسمي.

تستدعي الدالة نداء النظام ()setpgid لإسناد مُعرِّف المجموعة المُمرَّر للوسيط الثاني (pgrp) إلى العملية ذات المُعرِّف المُمرَّر للوسيط الأوَّل (pid). البنية العامة setpgid(pid, pgrp) الدالة متوافرة في أنظمة يونكس. المعاملات pid مُعرِّف العملية المُراد تحديدها. pgrp مُعرِّف المجموعة المُراد إسناده للعملية المُحدَّدة. القيمة المعادة لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None). لاحظ أنَّ الدالة يجب أن تُنفَّذ من مُستخدِم يملك صلاحيات الجذر. طالِع صفحة الدليل لنداء النظام ()setpgid للمزيد من التفاصيل. أمثلة يُبيّن المثال التالي آلية عمل الدالة. ...

تعيد الدالة القيمة True إن كان اسم الترويسة المعطى هو HTTP/1.0 "Hop-by-Hop"‎ وبحسب ما هو معرّف في RFC 2616. البنية العامة wsgiref.util.is_hop_by_hop(header_name) ‎المعاملات header_name اسم الترويسة الذي ستتحقّق الدالة منه. القيمة المعادة تعيد الدالة قيمة منطقية بالاعتماد على نتيجة عملية التحقّق التي ستجريها على اسم الترويسة. مصادر قسم WSGI environment utilities في صفحة WSGI Utilities and Reference Implementation في توثيق بايثون الرسمي.

تحوّل الدالة القائمة المعطاة إلى كومة، في نفس المكان، وفي زمن خطي linear time. البنية العامة heapq.heapify(x) المعاملات x القائمة المراد تحويلها إلى كومة. القيمة المعادة تعيد الدالة القيمة None. أمثلة يبين المثال التالي آلية عمل التابع: >>> import heapq >>> li = [5, 7, 9, 1, 3] >>> heapq.heapify(li) >>> print(list(li)) [1, 3, 9, 7, 5] مصادر صفحة General calendar-related functions في توثيق بايثون الرسمي.

تعيد الدّالة itertools.repeat()‎ مُكرّرًا يُعيد كائنًا مرارًا وتكرارًا بشكل لا نهائي أو لعدد مُحدّد من المرّات. تُستخدم مع الدالة map()‎ لاستدعاء دالّة عدّة مرّات بنفس المُعاملات. وتُستخدم كذلك مع الدالة zip()‎ لإنشاء جزء لا يتغيّر في كلّ صفّ. البنية العامة itertools.repeat(object[, times]) المعاملات object الكائن المُراد تكراره. times مُعامل اختياريّ يُحدّد عدد مرّات التّكرار، يكون التّكرار لا نهائيًّا إن لم تُمرّر له أيّة قيمة. القيمة المعادة مُكرّر يُعيد الكائنَ بشكل لا نهائيّ أو لعدد مُحدّد من المرّات حسب ما مُرِّرَ ...

تُعيد الدالة قيمة مُتغيّر البيئة المُمرَّر. القيمة المُعادة من هذه الدالة، وكذلك وسائِطها، مُمثَّلة بالبايتات. البنية العامة getenvb(key, default=None) المعاملات key مُتغيّر البيئة المُراد الحصول على قيمته. default القيمة الافتراضيّة لمتغيّر البيئة في حال عدم وجوده. القيمة المعادة تُعيد الدالة قيمة مُتغيّر البيئة المُمرَّر (key)، أو قيمة الوسيط default في حال عدم وجود المتغيّر. ينبغي أن تكون الوسائط والقيمة المعادة مُمثَّلة بالبايتات. تتوفر هذه الدالة فقط في حال كان للمتغيّر supports_bytes_environ القيمة True. الدالة متوفرة في معظم الأنظمة الشبيهة بيونكس. ...

تربط الدالة اللهجة المعطاة بالاسم المحدّد. البنية العامة csv.register_dialect(name[, dialect[, **fmtparams]]) المعاملات ‎name سلسلة نصية تتضمّن الاسم المراد ربطه باللهجة المعطاة. dialect يمكن تحديد اللهجة إمّا بتمرير صنف متفرّع عن الصنف Dialect، أو باستخدام المعاملات المفتاحية fmtparams أو كلاهما، مع الأخذ بنظر الاعتبار أنّ المعاملات المفتاحية ستعيد تعريف قيم المعاملات الخاصة باللهجة. راجع قسم اللهجات ومعاملات التنسيق للاطلاع على المزيد من المعلومات. أمثلة يبين المثال التالي طريقة تسجيل لهجة جديدة: import csv csv.register_dialect('unixpwd', delimiter=':', quoting=csv.QUOTE_NONE) with open('passwd', newline='') as f: ...

تعيد الدالة pow()‎ القيمة xy أي ترفع الأساس x إلى القوة y للقيمتين الممرَّرتين إليها، مع إمكانيّة الحصول على باقي القسمة عند تقسيم النّاتج على المُعامل z. البنية العامة pow(x, y[, z]) المعاملات x الأساس. y القوّة. z العدد الذي ستُقسم عليه النّتيجة لتُعيد الدّالة باقي القسمة. عند تمرير قيمة له، فالعمليّة تكون نسخةً تُحسبُ بطريقة أفضل من الجملة ‎pow‎(‎x‎,‎ ‎y‎)‎ ‎%‎ ‎z‎. القيمة المعادة تُعاد قيمة الأساس x مرفوعًا إلى القوّة y إن لم تُعط قيمة للمُعامل z ويكون ...

تعيد الدالة عدد الإشارات الضعيفة والوسائط المرتبطة بالكائن المعطى. البنية العامة weakref.getweakrefcount(object) المعاملات object الكائن المراد معرفة عدد الإشارات الضعيفة والوسائط المرتبطة به. القيمة المعادة تعيد الدالة عدد الإشارات الضعيفة والوسائط المرتبطة بالكائن المعطى. مصادر صفحة Weak references في توثيق بايثون الرسمي.

تحوّل الدالة مكونات المسار المعطى من عنوان URL مرمّز بعلامة النسبة المئوية إلى الصيغة المحلّية للمسارات. لا تستقبل الدالة عنوان URL كاملًا، وتُستخدم الدالة unquote()‎ لفكّ ترميز المسار المعطى. البنية العامة urllib.request.url2pathname(path) المعاملات path المسار المراد تحويله. أمثلة يبين المثال التالي طريقة عمل الدالة: >>> import urllib.request >>> urllib.request.url2pathname('main/images/big%20title.png') 'main/images/big title.png' مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

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

تتعامل هذه الدالة مع الاستثناء الموصوف في المعاملات، وتنسّق رسالة الخطأ على هيئة نصٍّ صرف plain text وتعيد النتيجة كسلسلة نصية. البنية العامة cgitb.text(info, context=5) ‎المعاملات info تصف قيمة هذا المعامل الاستثناء الذي ستتعامل معه الدالة، وقيمته عبارة عن صفٍّ tuple ذي ثلاثة عناصر وهو نتيجة استدعاء الدالة sys.exc_inf()‎. context معامل اختياري، يحدّد عدد الأسطر التي ستُعرض في رسالة الخطأ والتي تحيط بالسطر الذي يحتوي على الخطأ في الشيفرة المصدرية، ويأخذ هذا المعامل القيمة الافتراضية 5. القيمة المعادة تعيد الدالة ...

تنقل الدالة اسمًا منفردًا من PATH_INFO إلى SCRIPT_NAME وتعيد الاسم المنقول. يُعدّل القاموس المعطى في مكانه in-place، ويمكنك استخدام نسخة من القاموس إن كنت بحاجة إلى المحافظة على قيمة PATH_INFO أو SCRIPT_NAME الأصلية دون تعديل. تستخدم هذه الدالة عادة لمعالجة كل جزء من أجزاء مسار URI في الطلب، كأن تجري معالجة المسار كسلسلة من مفاتيح القاموس. تعدّل هذه الدالة البيئة الممرة لجعلها ملائمة للتنفيذ من قبل تطبيق WSGI آخر والموجود في معرّف URI الهدف. فعلى سبيل المثال لو كان هناك ...

تعيد الدّالة zip()‎ مُكرّرًا يُركّب عناصر كلّ من الكائنات القابلة للتّكرار المُعطاة. البنية العامة zip(*iterables) المعاملات iterables مُعامل اختياريّ يُمثّل الكائنات القابلة للتّكرار المرغوب تركيبها. القيمة المعادة مُكرّر يحتوي على صفوف تكون عناصرها ذات نفس الفهرس (index) في كلّ عنصر من عناصر الكائنات القابلة للتّكرار. إذ يحتوي مثلا أول صفّ على جميع العناصر التي تكون أول العناصر في الكائنات القابلة للتّكرار المُعطاة (انظر الأمثلة أدناه). يتوقّف المُكرّر عندما تنتهي عناصر أصغر كائن قابل للتّكرار. عند استدعائها بكائن واحد قابل للتّكرار ...

ترمّز الدالة كائن bytes إلى سلسلة نصية تتضمن عددين ستّ عشريين مقابل كلّ بايت. البنية العامة hex() القيمة المعادة تعيد الدالة سلسلة نصية تتضمّن عددين ستّ عشريين مقابل كلّ بايت. أمثلة يبين المثال التالي النتائج المعادة من تطبيق الدالة: >>> bytes = b'\xf0\xf1\xf2' >>> bytes.hex() 'f0f1f2' انظر أيضًا الدالة bytes.fromhex()‎: فك ترميز سلسلة نصية تتضمن أعداد ست عشرية إلى كائن bytes. مصادر قسم hex في صفحة Types في توثيق بايثون الرسمي.

تبني الدالة عنوان URL كاملًا (مطلقًا) عن طريق دمج عنوان URL الأساسي base URL المعطى، مع عنوان URL آخر. البنية العامة urllib.parse.urljoin(base, url, allow_fragments=True) ‎المعاملات base عنوان URL الأساسي. url عنوان URL المراد دمجه بالعنوان الأساسي. allow_fragments إن أخذ هذا المعامل قيمة خاطئة، فلن تتعرّف الدالة حينئذٍ على محدّدات القطع fragment identifiers، وتحلّل كجزء من مكونات المسار أو المعاملات أو الاستعلام، وتعين سلسلة نصية فارغة كقيمة للقطع في القيمة التي تعيدها الدالة. أمثلة يبين المثال التالي طريقة عمل الدالة: >>> ...

هذه الدالة مشابهة للدالة request_uri()‎ باستثناء أنّ هذه الدالة تتجاهل المتغيّرين PATH_INFO و QUERY_STRING. وتكون النتيجة معرف URI الأساسي لكائن التطبيق الذي يُوجّه إليه الطلب. البنية العامة wsgiref.util.application_uri(environ) ‎المعاملات environ قاموس متوافق مع WSGI. يمكن مراجعة PEP 3333 للاطلاع على المزيد من التفاصيل. ‎القيمة المعادة تعيد الدالة معرّف URI الكامل في الطلب. مصادر قسم WSGI environment utilities في صفحة WSGI Utilities and Reference Implementation في توثيق بايثون الرسمي.

تنسّق الدالة بيئة الصدفة بصيغة HTML. البنية العامة cgi.print_environ() ‎انظر أيضًا الدالة cgi.print_form()‎: تنسّق الدالة النموذج بصيغة HTML. الدالة cgi.print_directory()‎: تنسّق الدالة المجلّد الحالي بصيغة HTML. الدالة cgi.print_environ_usage()‎: تطبع الدالة قائمة من متغيرات البيئة المفيدة (المستخدمة من قبل CGI) بصيغة HTML. مصادر صفحة Common Gateway Interface support في توثيق بايثون الرسمي.

تعيد الدالة كائن فك الضغط يمكن استخدامه لفك الضغط عن البيانات التي لا يمكن وضعها في الذاكرة دفعة واحدة. البنية العامة zlib.decompressobj(wbits=MAX_WBITS[, zdict]) ‎المعاملات wbits يتحكّم المعامل wbits بحجم ذاكرة تخزين التاريخ history buffer (أو ما يطلق عليه "حجم النافذة window size") المستخدمة في ضغط البيانات، ويتحكّم كذلك فيما إذا كانت مخرجات الدالة تتضمّن ترويسة وتذييلًا. يماثل هذا المعامل ذلك الموصوف في الدالة decompress()‎. zdict يحدّد المعامل zdict قاموس ضغط معرّف مسبقًا. في حال تقديم قيمة لهذا المعامل، فإنّه يجب ...

هذه الدالة عبارة عن تطبيق WSGI بسيط ولكن كامل، ويعيد صفحة نصية تتضمّن الرسالة ‎"Hello world!"‎ وقائمة بأزواج مفتاح/قيمة الموجودة في المعامل environ. يمكن الاستفادة من هذه الدالة في التحقق من قدرة مخدّم WSGI (مثل wsgiref.simple_server) على العمل كتطبيق WSGI بطريقة سليمة. البنية العامة wsgiref.simple_server.demo_app(environ, start_response) المعاملات environ قاموس متوافق مع WSGI. يمكن مراجعة PEP 3333 للاطلاع على المزيد من التفاصيل. مصادر قسم WSGI environment utilities في صفحة WSGI Utilities and Reference Implementation في توثيق بايثون الرسمي.

تحدّد الدالة ما إذا كان الكائن المعطى يتطلب تمثيلًا تعاوديًا recursive. البنية العامة pprint.isrecursive(object) القيمة المعادة تعيد هذه الدالة القيمة True مع الكائنات التعاودية Recursive objects. أمثلة يبين المثال التالي آلية عمل الدالة: >>> import pprint >>> stuff = ['spam', 'eggs', 'lumberjack', 'knights', 'ni'] >>> stuff.insert(0, stuff) >>> pprint.pprint(stuff) [<Recursion on list with id=...>, 'spam', 'eggs', 'lumberjack', 'knights', 'ni'] >>> pprint.isrecursive(stuff) True انظر أيضًا التابع PrettyPrinter.isrecursive()‎: يحدّد التابع ما إذا كان الكائن المعطى يتطلب تمثيلًا تعاوديًا. مصادر صفحة Data pretty printer في توثيق بايثون الرسمي.

تحذف الدالة وتعيد أصغر عنصر في الكومة، وتضيف كذلك العنصر الجديد المعطى. البنية العامة heapq.heapreplace(heap, item) المعاملات heap الكومة التي ستُدرج فيها قيمة المعامل item. item القيمة المراد إدراجها في الكومة. القيمة المعادة تحذف الدالة وتعيد أصغر عنصر في الكومة heap، وتضيف كذلك العنصر الجديد item. لا يؤدي استخدام هذه الدالة إلى إحداث تغير في حجم الكومة، وتطلق الدالة الخطأ IndexError في حال كون الكومة فارغة. تؤدي هذه الدالة عملها بكفاءة أكبر من استدعاء الدالة heappop()‎ متبوعة بالدالة heappush()‎، إلى ...

تضبط الدالة مُعرِّف مجموعة العملية الحالية. البنية العامة setgid(gid) الدالة متوافرة في أنظمة يونكس. المعاملات gid المُعرِّف المراد إسناده لمجموعة العملية الحالية. القيمة المعادة لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None). لاحظ أنَّ الدالة يجب أن تُنفَّذ من مُستخدِم يملك صلاحيات الجذر. أمثلة >>> from os import setgid >>> setgid(0) مصادر قسم الوحدة os في توثيق بايثون الرسمي.

تسجّل الدالة نوع المتصفّح المعطى، وبعد تسجيل نوع المتصفّح باستخدام هذه الدالة يصبح بإمكان الدالة get()‎ أن تعيد متحكّمًا لنوع المتصفّح المسجَّل. البنية العامة webbrowser.register(name, constructor, instance=None, *, preferred=False) المعاملات ‎instance إن لم يكن هذا المعامل موجودًا، أو أخذ القيمة None، المعامل constructor سيستدعى دون أيّ معاملات وذلك لإنشاء نسخة عند الحاجة. أما إذا أخذ المعامل قيمة معيّنة، فإنّ المعامل constructor لن يستدعى إطلاقًا، وقد يحمل القيمة None. preferred يؤدي تعيين القيمة True لهذا المعامل إلى جعل هذا المتصفّح النتيجةَ ...

تعيد الدّالة super()‎ كائنًا وسيطًا يُفوّض استدعاءات التّوابع إلى صنف أبٍ أو صنف شقيق للصّنف الذي استُدعيَت منه الدّالة. هذا مُفيد للوصول إلى التّوابع الموروثة التي أعيدت كتابتها في صنف مُعيّن. ترتيب البحث يكون هو نفسه التّرتيب المُستخدم من طرف الدّالة getattr()‎ لكنّ النّوع type‎ المُعطى يُتجاهَل. البنية العامة super([type[, object-or-type]]) المعاملات type النّوع الذي ستقوم الدّالة super()‎ بتفويض استدعاءات التّوابع إلى صنف أبٍ أو صنف شقيق له. تعرض الخاصيّة __mro__ الخاصّة بالصّنف type ترتيب البحث عن التوابع (method resolution ...

تعيد الدّالة itertools.tee()‎ عددًا مُحدّدًا من المُكرّرات المُستقلّة عن بعضها البعض من كائن واحد قابل للتّكرار. البنية العامة itertools.tee(iterable, n=2) المعاملات iterable الكائن القابل للتّكرار. n عدد المُكرّرات المُستقلّة المرغوب إنشاؤها من الكائن iterable. القيمة المعادة عددٌ n من المُكرّرات المُستقلّة المُولَّدة من الكائن القابل للتّكرار المُعطى. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> it = itertools.tee('abc', 2) >>> it (<itertools._tee object at 0x7f79c6fc9f48>, <itertools._tee object at 0x7f79c4e73588>) >>> [list(i) for i in it] [['a', 'b', 'c'], ['a', 'b', 'c']] ملاحظات الدّالة ...

تتحقّق الدالة من أنّ البيانات الثنائية تبدأ بالقيمة التي يحدّدها المستخدم. البنية العامة b.startswith() المعاملات prefix التسلسل الذي ستبحث عنه الدالة، ويمكن أن يكون أيّ كائن شبيه بالبايتات (bytes-like object). start الموقع الذي تبدأ منه الدالة عملية الاختبار ضمن التسلسل الأصلي. end الموقع الذي تنهي فيه الدالة عملية المقارنة ضمن التسلسل الأصلي. القيمة المعادة تعيد الدالة startswith()‎ القيمة True إن كان التسلسل الأصلي يبدأ بالقيمة الممرّرة إلى المعامل prefix، وتعيد القيمة False فيما عدا ذلك. أمثلة >>> name = b'Hsoub ...