نتائج البحث

 الصنف pathlib.WindowsPath في بايثون هو الصنف الخاص الذي يتم إنشاؤه في أنظمة ويندوز للتعامل مع المسارات مع السماح بالقيام بعمليات إدخال وإخراج عن طريق استدعاءات النظام. يمكن إنشاء كائن من هذا الصنف بإحدى طريقتين: 1- عن طريق استخدام الباني الخاص بالصنف WindowsPath في أي نظام تشغيل >>> windows_path_object=WindowsPath() >>> windows_path_object WindowsPath('.') 2- عن طريق استخدام الباني الخاص بالصنف العام Path عند العمل في نظام ويندوز حصرًا >>> OSdependant_path_object=Path() >>> OSdependant_path_object WindowsPath('.') ملاحظة: في نظام لينوكس سيعطي المثال السابق كائنًا من الصنف PosixPath بدلًا من WindowsPath ...

تُنشئ الدّالة setattr()‎ قيمة لخاصيّة كائن مُعيّن. البنية العامة setattr(object, name, value) المعاملات object الكائن المُراد تعديل خاصيّة من خاصيّاته أو إضافة خاصّية جديدة إليه إن لم تكن موجودة مُسبقًا. name سلسلة نصيّة تُمثّل اسم الخاصيّة، يُمكن أن تكون الخاصيّة موجودة مُسبقًا (ستُغيّر قيمتها) أو غير موجودة (ما يعني أنّها ستُنشأ). value القيمة المرغوب إسنادها للخاصيّة. القيمة المعادة القيمة None. ملاحظات يجب على الكائن أن يسمح بتعديل خاصيّاته. الاستدعاء ‎setattr‎(‎x,‎ ‎'foobar'‎, 123‎)‎ مُكافئ للجملة ‎x.‎‎foobar‎ ‎=‎‎ 123‎. أمثلة المثال التّالي ...

يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق datetime.date، وتعاد الأيام على هيئة صفوف تتضمن رقم اليوم في الشهر ورقم اليوم في الأسبوع. البنية العامة itermonthdays2(year, month) المعاملات year السنة المطلوبة. month الشهر المطلوب (من 0 إلى 12). القيمة المعادة يعيد التابع كائن تكرار للشهر month في السنة year بصورة مشابهة للتابع ()itermonthdates، ولكنّ النتيجة لا تكون مقيّدة بالنطاق datetime.date. تكون الأيام المعادة على هيئة صفوف تتضمن رقم اليوم في الشهر ورقم اليوم في الأسبوع. ...

يعيد التابع كائن datetime الناتج عن دمج كائني date و time بعضهما ببعض. البنية العامة ‎classmethod datetime.combine(date, time, tzinfo=self.tzinfo) المعاملات date كائن date المراد استخدامه لإنشاء الكائن الجديد. time كائن time المراد استخدامه لإنشاء الكائن الجديد. tzinfo معامل اختياري تُحدّد بواسطته المنطقة الزمنية المطلوبة. تستخدم قيمة المعامل tzinfo في حال توفّرها كقيمة لخاصية tzinfo في الكائن الجديد، أما في حال عدم توفّرها فتُستخدم خاصية tzinfo التابعة لمعامل time. القيمة المعادة يعيد التابع كائن datetime تكون مكوّنات التاريخ فيه مساوية لكائنات ...

يفسِّر التابع البيانات الثنائية كحروف في ترميز ASCII ويحوّل الحرف الأول إلى حرف كبير، والحروف الأخرى إلى حروف صغيرة. البنية العامة bytes.capitalize() القيمة المعادة يفسر التابع البيانات الثنائية كحروف في ترميز ASCII ويحوّل الحرف الأول إلى حرف كبير، والحروف الأخرى إلى حروف صغيرة. إن تضمّنت البيانات الثنائية قيم بايتات خارج ترميز ASCII لن يغير التابع قيمة هذه البايتات. أمثلة يوضح المثال التالي النتائج المعادة من هذا التابع: >>> name = b'hsoub' >>> name.capitalize() b'Hsoub' انظر أيضًا البايتات في بايثون. التابع bytes.islower()‎: التحقق ...

تُعيد الدالة كائِن ملف مفتوح مُتَّصِل بواصِف الملف المُمرَّر. البنية العامة fdopen(fd, [, mode[, bufsize]]) المعاملات fd واصِف الملفات المُراد ربط كائِن الملف المُعاد به. mode مُعطى اختياري ينبغي تمرير سلسلة نصيّة له تحوي الوضع المُراد فتح الملف به. bufsize مُعطى اختياري يُحدِّد حجم الصِوان (buffer) المُراد استخدامه. القيمة المعادة تُعيد الدالة كائِن ملف مفتوح مُتَّصِل بواصِف الملف المُمرَّر للمعامِل fd. هذه الدالة مُكافِئة للدالة ()open المُضمَّنة داخليًّا في بايثون، وكذلك تستقبل نفس مُعطياتها. الفرق الوحيد بين الدالة ()fdopen والدالة ...

هذا التابع غير معرّف في الصنف BaseHandler، ولكن يجب على الأصناف المتفرّعة منه أن تعرّف هذا التابع إن كان المطلوب التقاط جميع عناوين URL. يُستدعى هذا التابع، في حال استخدامه، من قبل كائن OpenerDirector الأب. يُستدعى هذا التابع قبل أي تابع open خاصّ بالبروتوكول. البنية العامة BaseHandler.default_open(req) القيمة المعادة يجب أن يعيد التابع كائنًا شبيهًا بالملفات file-like object كما هو موصوف في القمية المعادة من التابع open()‎ في كائنات OpenerDirector، أو يعيد القيمة None. يجب أن يطلق التابع الخطأ URLError ...

يطلق هذا التابع افتراضيًا الاستثناء UnpicklingError. البنية العامة persistent_load(pid) المعاملات pid في حال تعريف هذا التابع فإنّه يعيد الكائن المحدّد بواسطة المعرّف المستمر pid، وإذا كان المعرّف المستمّر غير صالحٍ فإنّ التابع يُطلق الاستثناء UnpicklingError. راجع قسم "استمرارية الكائنات الخارجية" في وحدة pickle للاطلاع على المزيد من التفاصيل والأمثلة حول هذا الموضوع. انظر أيضًا التابع Unpickler.persistent_id()‎ : لا يؤدي هذا التابع افتراضيًا أي وظيفة، والهدف من وجوده هو إمكانية إعادة تعريفه override بواسطة صنف فرعي. مصادر صفحة DB-API 2.0 interface for ...

يحول التابع المصفوفة إلى مصفوفة من قيم الجهاز ويعيد كذلك تمثيل البايتات (تسلسل البايتات نفسه الذي يمكن كتابته إلى ملف باستخدام التابع tofile()‎). تغير اسم التابع tostring()‎ إلى tobytes()‎ في الإصدار 3.2 وذلك لزيادة الإيضاح. البنية العامة ‎array.tobytes() القيمة المعادة يعيد التابع التمثيل الخاص بالبايتات (تسلسل البايتات نفسه الذي يمكن كتابته إلى ملف باستخدام التابع tofile()‎). أمثلة يبين المثال التالي آلية عمل التابع: >>> import array >>> a1 = array.array('l', [1, 2, 3, 4, 5]) >>> a1 array('l', [1, 2, 3, 4, 5]) >>> ...

تعيد الدّالة itertools.cycle()‎ مُكرّرًا يُعيد عناصر الكائن القابل للتّكرار المُعطى ويحفظ نسخة منه، عندما تنتهي قيم الكائن القابل للتّكرار، يُعيد المُكرّر عناصر النّسخة المحفوظة، ويُكرّر ذلك مرارًا وتكرارًا دون نهاية. البنية العامة itertools.cycle(iterable) المعاملات iterable الكائن القابل للتّكرار المرغوب الدّوران على قيمه بشكل لا نهائيّ. القيمة المعادة مُكرّر يُعيد قيم الكائن المُعطى مرارًا وتكرارًا. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة، لاحظ استعمال الدّالة next‎()‎ للوصول إلى القيمة المواليّة في المُكرّر، وهذا لأنّ المُكرّر النّاتج لا متناهٍ، وتحويله إلى ...

يسجّل هذا التابع استدعاءً خلفيًا يجري تنفيذه لكل n من تعليمات SQLite في الجهاز الافتراضي virtual machine. هذا التابع مفيد عند الحاجة إلى اجراء استدعاء من SQLite أثناء عملية طويلة، كتحديث واجهة رسومية مثلًا. البنية العامة set_progress_handler(handler, n) المعاملات handler يمكن استدعاء التابع مع تمرير القيمة None للمعامل handler للتخلص من أي استدعاء خلفي معدّ مسبقًا. تؤدي إعادة قيمة غير الصفر من الاستدعاء الخلفي إلى إنهاء الاستعلام الحالي وإطلاق الاستثناء OperationalError. n عدد تعليمات SQLite. انظر أيضًا التابع Connection.set_authorizer()‎:يسجّل هذا ...

تُعيد الدالة صفًّا يحتوي على المُعرِّف الحقيقي والفعلي والمحفوظ لمجموعة العملية الحالية. البنية العامة getresuid() القيمة المعادة تُعيد الدالة صفًّا يحتوي (بالترتيب المذكور) على المُعرِّف الحقيقي (real) والفعلي (effective) والمحفوظ (saved) لمجموعة العملية الحالية. أمثلة في المقتطف أدناه مثالين على استخدام الدالة للحصول على المُعرِّفات الثلاث لمجموعة العملية الحالية. >>> from os import getresuid >>> getresuid() (1000, 1000, 1000) >>> getresuid() (0, 0, 0) مصادر قسم الصفحة os في توثيق بايثون الرسمي.

تحدّد الدالة ما إذا كان التمثيل المنسّق للكائن المعطى "قابلًا للقراءة" أو يمكن استخدامه لإعادة بناء القيمة باستخدام الدالة eval()‎. البنية العامة pprint.isreadable(object) القيمة المعادة تعيد هذه الدالة القيمة False دائمًا مع الكائنات التعاودية 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.isreadable(stuff) False انظر أيضًا التابع PrettyPrinter.isreadable()‎: يحدّد التابع ما إذا كان التمثيل المنسّق للكائن المعطى "قابلًا ...

تصرّح الدالة عن وجوب استخدام الدالة المعطاة كدالة اختزال reduction function للكائنات من النوع المعطى. البنية العامة copyreg.pickle(type, function, constructor=None) ‎المعاملات type نوع الكائنات التي ستعمل دالة الاختزال عليها. function الدالة التي ستستخدم كدالة اختزال. يجب أن تعيد الدالة المعطاة سلسلة نصية أو صفًّا يتضمّن عنصرين أو ثلاثة. constructor يجب أن يكون هذا المعامل الاختياري كائنًا قابلًا للاستدعاء يمكن استخدامه لإعادة بناء الكائن عند استدعاءه مع صفّ المعاملات المعاد بواسطة الدالة المعطاة عند إجراء عملية السَلسَلة. القيمة المعادة راجع وحدة ...

يكتب التابع جميع العناصر (كقيم جهاز) في كائن الملف المعطى. البنية العامة ‎array.tofile(f) المعاملات f كائن ملف المراد كتابة عناصر المصفوفة فيه. القيمة المعادة أمثلة يبين المثال التالي آلية عمل التابع: انظر أيضًا التابع array.tobytes()‎: يحول التابع المصفوفة إلى مصفوفة من قيم الجهاز. التابع array.tolist()‎: يحول التابع المصفوفة إلى قائمة عادية تتضمن نفس العناصر. التابع array.tounicode()‎: يحول التابع المصفوفة إلى سلسلة نصية بترميز Unicode. مصادر صفحة Efficient arrays of numeric values في توثيق بايثون الرسمي.

تُغيّر الدالة مُجلَّد الجذر للعملية الحالية إلى المسار المُمرَّر. البنية العامة chroot(path) الدالة متوافرة في أنظمة يونكس. المعاملات path المسار المراد تغيير مُجلَّد الجذر للعملية الحالية إليه. القيمة المعادة لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None). لاحظ أنَّ الدالة ينبغي تنفيذها بصلاحية الجذر. أمثلة يُبيّن المثال التالي آلية عمل الدالة. >>> from os import chroot >>> chroot("/home") مصادر قسم الوحدة os في توثيق بايثون الرسمي.

يستدعي هذا التابعُ التابعَ Cursor.executescript()‎ مع تمرير المعاملات المعطاة. البنية العامة executescript(sql_script) ‎المعاملات sql_script سلسلة نصية تتضمن شيفرة SQL المراد تنفيذها. القيمة المعادة هذا التابع هو طريقة مختصرة لإنشاء كائن مؤشر عن طريق استدعاء التابع cursor()‎، حيث يستدعي التابع executescript()‎ في كائن المؤشر مع تمرير قيمة المعامل sql_script، ثم يعيد كائن المؤشر. أمثلة يبين المثال التالي آلية عمل التابع: import sqlite3 conn = sqlite3.connect('example.db') conn.executescript(""" insert into recipe (name, ingredients) values ('broccoli stew', 'broccoli peppers cheese tomatoes'); ...

يجب أن تكون nnn عددًا من ثلاث مراتب يمثّل شيفرة خطأ HTTP. هذا التابع غير معرّف في الصنف BaseHandler أيضًا، ولكن سيُستدعى إن كان موجودًا على نسخة من الصنف المتفرّع عن الصنف BaseHandler عند حدوث خطأ HTTP يحمل الشيفرة nnn. يجب على الأصناف الفرعية أن تعيد تعريف هذا التابع لمعالجة أخطاء HTTP معيّنة. البنية العامة BaseHandler.http_error_nnn(req, fp, code, msg, hdrs) يجب أن تكون المعاملات والقيم المعادة والاستثناءات المُطلقة مشابهة لنظيراتها في التابع http_error_default()‎. مصادر صفحة Extensible library for opening URLs ...

يستخرج التابع جميع الأعضاء من ملف الأرشيف إلى المجلد الحالي أو المسار المعطى. البنية العامة TarFile.extractall(path=".", members=None, *, numeric_owner=False) المعاملات ‎memebers معامل اختياري، ويجب أن يكون مجموعة متفرّعة subset من القائمة المعادة من التابع getmembers()‎. يجري تحديد المعلومات الخاصة بالمجلد مثل صاحب المجلد ووقت التعديل والأذونات بعد استخراج جميع الأعضاء من ملف الأرشيف، ويحدث هذا لسببين: يعاد تعيين قيمة وقت التعديل للمجلد في كل مرة يتم فيها إنشاء ملف جديد فيه. إن لم تسمح أذونات مجلّد معين بالكتابة فيه، ستفشل ...

يحمّل التابع الإعدادات من أي كائن يوفّر تابعًا شبيهًا بالتابع items()‎ في كائنات dict. تتضمّن المفاتيح أسماء الأقسام، أمّا القيم فعبارة عن قواميس تتضمّن المفاتيح والقيم التي تنطوي عليها الأقسام. إن كان القاموس المستخدم قادرًا على الاحتفاظ بترتيب العناصر، فستضاف الأقسام ومفاتيحها بحسب الترتيب. تُحوّل القيم إلى سلاسل نصية تلقائيًا. يمكن استخدام هذا التابع لنسخ الحالة بين المحلّلات المختلفة. البنية العامة read_dict(dictionary, source='<dict>') ‎المعاملات dictionary القاموس الذي سيقرأ التابع منه الإعدادات. ‎source معامل اختياري يحدد اسمًا خاصًّا بالسياق context-specific name ...

تحوّل هذه الدالة دالة مولّدة إلى دالة coroutine تعيد coroutine مبنيًا على مولّد. يكون هذا الـ coroutine هو كائن تكرار مولِّد، ويعدّ كذلك كائن coroutine ومن نوع awaitable. ولكن ليس بالضرورة أن يستخدم التابع ‎__await__()‎. ملاحظة: هذه الدالة جديدة في الإصدار 3.5 من بايثون. البنية العامة ‎types.coroutine(gen_func) المعاملات gen_func إن كانت دالة مولدة، فسيجري تعديلها في مكانها. وإن لم تكن دالة مولدة، فسيجري تغليفها. إن كانت الدالة تعيد نسخة من collections.abc.Generator، فإنّ النسخة ستُغلّف في كائن وسيط من نوع awaitable. ...

كائنات Cursor هي وسيلة التواصل بين المستخدم وقاعدة البيانات، حيث يمكن باستخدام الخصائص والتوابع التي تقدّمها هذه الكائنات تنفيذ جمل SQL وإجراء الاستعلامات وجلب النتائج من قاعدة البيانات. خصائص كائنات Cursor يمتلك كائن المؤشر الخصائص التالية: الخاصية rowcount بالرغم من أنّ صنف Cursor في وحدة sqlite3 يتضمّن هذه الخاصية، إلا أنّ الدعم الذي يقدّمه محرّك SQLite لتحديد "عدد الصفوف المتأثرة"/"عدد الصفوف المحدّدة" جيّد أيضًا. يُجمع عدد التعديلات في الخاصية rowcount عند تنفيذ جمل الاستعلام بواسطة التابع executemany()‎. تتطلب معايير بايثون ...

ينشئ تابع الصنف هذا كائن ZipInfo للملف المعطى، ويهيّئه لإضافته إلى ملف zip. البنية العامة ZipInfo.from_file(filename, arcname=None) ‎ المعاملات filename مسار الملف أو المجلّد المعطى. arcname معامل اختياري، يستخدم كاسمٍ للملف المعطى داخل الأرشيف. في حال عدم تعيين قيمة لهذا المعامل، فإنّ اسم الملف المعطى سيبقى نفسه داخل الأرشيف، ولكن بعد اقتطاع محرف محرّك الأقراص وفواصل المسارات. ملاحظات: هذا التابع جديد في الإصدار 3.6 من بايثون. يستقبل المعامل filename كائنًا شبيهًا بالمسارات في الإصدار 3.6.2. مصادر صفحة Work with ZIP ...

يتيح التابع القدرة على تحديد ما إذا كان التوقيت الصيفي مستخدمًا أم لا. البنية العامة ‎datetime.dst() القيمة المعادة إن أخذ الكائن tzinfo القيمة None، فإنّ التابع يعيد القيمة ذاتها، وإلاّ فإنّه يعيد self.tzinfo.dst(None)‎‎، ويطلق التابع استثناءً إن لم تُعِد العبارة السابقة القيمة None أو كائن timedelta بفارق زمني لا يتجاوز اليوم الواحد. ملاحظة: في الإصدار 3.7 من بايثون، لم يعد مقدار الإزاحة عن نظام التوقيت الصيفي مقيّدًا بعدد صحيح من الدقائق. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from ...

يعكس التابع ترتيب عناصر الكائن deque في نفس المكان. البنية العامة d.reverse() القيمة المعادة يعيد التابع القيمة None. ملاحظة: هذا التابع جديد في الإصدار 3.2. أمثلة يبين المثال التالي آلية عمل التابع. >>> from collections import deque >>> d = deque('abcdefg') >>> d deque(['a', 'b', 'c', 'd', 'e', 'f', 'g']) >>> d.reverse() >>> d deque(['g', 'f', 'e', 'd', 'c', 'b', 'a']) مصادر قسم deque Objects في صفحة Container Datatypes في توثيق بايثون الرسمي.

يجلب التابع المجموعة اللاحقة من الصفوف rows في نتيجة الاستعلام، ويعيد النتيجة كقائمة. البنية العامة fetchmany(size=cursor.arraysize) المعاملات size يمكن تحديد عدد الصفوف التي يجلبها التابع مع كل استدعاء عن طريق المعامل size. وفي حال عدم تحديد قيمة لهذا المعامل فإنّ قيمة خاصية arraysize في كائن المؤشر ستحدّد عدد الصفوف التي سيجلبها التابع (القيمة الافتراضية لهذه الخاصية هي 1 وهذا يعني أنّ التابع سيجلب صفًّا واحدًا فقط). سيحاول التابع جلب الصفوف المحدّدة في معامل size، وإن كان ذلك غير ممكنًا بسبب ...

يقرأ التابع جميع الملفات في الأرشيف ويفحص ترويساتها وCRC الخاصة بها. البنية العامة ZipFile.testzip() ‎القيمة المعادة يعيد التابع اسم أول ملف معطوب أو يعيد القيمة None إن لم يكن هناك ملف معطوب. يؤدي استدعاء التابع testzip()‎ على كائن ZipFile مغلق إلى إطلاق الاستثناء ValueError في الإصدار 3.6 من بايثون. كان التابع يطلق الاستثناء RuntimeError في الإصدارات السابقة. أمثلة يبين المثال التالي آلية عمل التابع: >>> import zipfile >>> zip = zipfile.ZipFile('files.zip') >>> zip.testzip() >>> >>> print(zip.testzip()) None مصادر صفحة Work with ZIP archives في ...

يقلب التابع ترتيب العناصر في المصفوفة. البنية العامة ‎array.reverse() القيمة المعادة يعيد التابع القيمة None. أمثلة يبين المثال التالي آلية عمل التابع: >>> import array >>> a1 = array.array('l', [1, 2, 3, 4, 5]) >>> a1.reverse() >>> a1 array('l', [5, 4, 3, 2, 1]) مصادر صفحة Efficient arrays of numeric values في توثيق بايثون الرسمي.

ينشأ كائن التعبير النمطي regex من تصريف التعبير النمطي بواسطة الدالة re.compile()‎، ويقدّم هذا الكائن مجموعة من الخصائص والتوابع التي يمكن من خلالها إجراء العديد من العمليات على التعابير النمطية المصرّفة. خصائص الكائن regex يقدّم الكائن regex الخصائص التالية: regex.flags رايات التطابق الخاص بالكائن regex، وتمثّل مجموعة الرايات التي تمرّر إلى الدالة re.compile()‎، إضافة إلى الرايات السطرية (‎?...‎) في التعابير النمطية، والرايات الضمنية مثل UNICODE إن كان التعبير النمطي سلسلة نصية بترميز Unicode. regex.groups عدد مجموعات الالتقاط في التعبير النمطي. ...

يستخدم هذا الصنف لعرض المعلومات الخاصّة بعضو من أعضاء ملف الأرشيف. يعيد التابعان getinfo()‎ و infolist()‎ في كائنات ZipFile نسخًا من هذا الصنف. لن تحتاج في أغلب الأحيان إلى إنشاء نسخة من هذا الصنف بنفسك، بل ستستخدم النسخ التي تنشئها الوحدة zipfile. البنية العامة class zipfile.ZipInfo(filename='NoName', date_time=(1980, 1, 1, 0, 0, 0)) ‎المعاملات filename الاسم الكامل لعضو الأرشيف. date_time يجب أن يكون هذا المعامل صفًّا يتضمن ستة حقول تمثّل الوقت الذي جرى فيه آخر تعديل للملف. راجع قسم خصائص ZipInfo ...

يحذف التابع البايتات المحدّدة من نهاية التسلسل. البنية العامة bytes.rstrip([chars]) المعاملات chars تسلسل ثنائي يحدّد مجموعة البايتات التي سيحذفها التابع من التسلسل الأصلي. يؤدي عدم استخدام هذا المعامل أو إعطائه القيمة None إلى أن تحذف الدالة المسافات البيضاء بترميز ASCII. يحذف التابع أي مزيج من الحروف الموجودة في chars. القيمة المعادة يعيد التابع نسخة من التسلسل بعد حذف البايتات المحدّدة من نهاية التسلسل. أمثلة يبين المثال التالي النتائج المعادة من تطبيق التابع: >>> b' spacious '.rstrip() b' ...

يعيد التابع كائن datetime مع خاصية tzinfo الممرّرة كمعامل للتابع، ويَجري تعديل بيانات الوقت والتاريخ بحيث تكون النتيجة مشابهة لوقت الكائن نفسه حسب التوقيت العالمي المنسّق، ولكنّ بالتوقيت المحلّي المحدّد بالمعامل tz. البنية العامة ‎datetime.astimezone(tz=None) المعاملات tz يجب أن يكون المعامل tz -في حال توفّره- نسخة من صنف tzinfo فرعي، ويجب أن لا يعيد تابعاه utcoffset()‎ و dst()‎ القيمة None. إن كان الكائن نفسه بسيطًا، فإنّ اللغة تفترض أنّه يمثّل الوقت حسب المنطقة الزمنية الخاصة بنظام التشغيل. في حال استدعاء ...

يعيد التابع قاموسًا يتضمّن القيم الافتراضية على مستوى نسخة الصنف instance-wide defaults. البنية العامة defaults() ‎القيمة المعادة يعيد التابع قاموسًا يتضمّن القيم الافتراضية على مستوى نسخة الصنف instance-wide defaults. أمثلة لنفرض أن لدينا ملف الإعدادات التالي: [DEFAULT] ServerAliveInterval = 45 Compression = yes CompressionLevel = 9 ForwardX11 = yes [bitbucket.org] User = hg [topsecret.server.com] Port = 50022 ForwardX11 = no يؤدي استدعاء التابع defaults()‎ إلى الحصول على المخرجات التالية: >>> import configparser >>> config = configparser.ConfigParser() >>> config.read('config.cfg') ['config.cfg'] >>> config.defaults() OrderedDict([('serveraliveinterval', '45'), ('compression', 'yes'), ('compressionlevel', '9'), ('forwardx11', 'yes')]) مصادر صفحة Configuration file parser في ...

هذا الصنف مشابه للصنف BaseCGIHandler، ولكنّه مصمّم للاستخدام مع المخدمّات من نوع HTTP. إن كنت تكتب شيفرة تستخدم بروتوكول بوابة فمن الأفضل تفريع هذا الصنف عوضًا عن الصنف BaseCGIHandler. يتفرّع هذا الصنف من الصنف BaseHandler، ويعيد تعريف التوابع ‎__init__()‎ و get_stdin()‎ و getstderr()‎ و add_cgi_vars()‎ و ‎_write()‎ و ‎_flush()‎ لدعم إمكانية تعيين بيئة CGI وتدفقات المدخلات والمخرجات والأخطاء في الدالة البانية. تُخزّن البيئة والتدفقات التي يقدّمها المستخدم في الخصائص stdin و stdout و stderr و environ. يجب أن يكتب التابع ...

تقدّم وحدة copyreg طريقة لتعريف دوال تستخدم أثناء سلسلة كائنات معيّنة في بايثون. تستخدم وحدتا pickle و copy هذه الدوال عند سلسلة أو نسخ تلك الكائنات. تقدّم الوحدة كذلك معلومات إعدادات حول الدوال البانية للكائنات التي ليست أصنافًا. يمكن لهذه الدوال البانية أن تكون دوال منشئة للكائنات factory functions أو نسخًا للأصناف. دوال الوحدة copyreg تقدّم الوحدة copyreg الدوال التالية: الدالة ‎copyreg.constructor()‎ تصرّح هذه الدالة عن كون الكائن المعطى دالة بانية صحيحة. إن كان الكائن المعطى غير قابل للاستدعاء (وهكذا ...

تُحوّل الدّالة functools.singledispatch()‎ دالّةً عاديّة إلى دالّة عموميّة وحيدة الإرسال (single-dispatch generic function). الدّالة العموميّة هي كلّ دالّة تتكوّن من عدّة دوال تُنفّذ نفس العمليّة لعدّة أنواع. تُحدّد الدّالة التي ستُنفّذ عبر خوارزميّة الإرسال (dispatch algorithm). تكون الدّالة العموميّة وحيدةَ إرسالٍ إذا كان نوع مُعامل واحد هو الذي يُحدّد الدّالة التي ستُنفَّذ. البنية العامة @functools.singledispatch المعاملات لا توجد مُعاملات القيمة المعادة دالّة عموميّة وحيدة الإرسال. أمثلة لإنشاء دالّة عموميّة، زخرِفها بالمُزخرِف ‎@singledispatch‎. لاحظ أنّ الإرسال يحدث عند نوع أوّل مُعامل: ...

يقدّم الصنف Chainmap طريقة سريعة لربط عدد من عمليات الربط mappings ليصبح بالإمكان التعامل معها كوحدة واحدة. وعادة ما تكون هذه الطريقة أسرع من إنشاء قاموس جديد واستدعاء التابع update()‎ مرّات عدة. يمكن استخدام هذا الصنف لمحاكاة النطاقات المتشعّبة وهو مفيد في عملية القولبة templating. البنية العامة class collections.ChainMap(*maps) يجمع الصنف CmainMap عددًا من القواميس أو وسائل الربط الأخرى لإنشاء عرض مفرد قابل للتحديث. في حال تعيين قيمة المعامل maps، فإنّ الصنف يقدّم قاموسًا واحدًا فارغًا، وبهذا ستمتلك السلسلة الجديدة كائن ...

يكتب التابع البيانات النصية المعطاة في الأرشيف. البنية العامة ZipFile.writestr(zinfo_or_arcname, data, compress_type=None, compresslevel=None) ‎المعاملات ‎zinfo_or_arcname يأخذ هذا المعامل إحدى قيمتين، فإمّا أن يكون اسم الملف في الأرشيف، أو نسخة من الصنف ZipInfo. في حال كانت القيمة المعطاة هي نسخة من الصنف فيجب على الأقل تعيين قيمة للمعاملات filename و date و time على الأقل. أما إن كانت القيمة المعطاة هي اسم الملف، فسيعتمد التابع الوقت والتاريخ الحاليين. يجب أن يكون الأرشيف مفتوحًا في الوضع 'w' أو 'x' أو 'a'. compress_type ...

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

يضيف التابع صنف معالجة إلى كائن OpenerDirector. البنية العامة OpenerDirector.add_handler(handler) ‎المعاملات ‎يبحث التابع في التوابع التالية وتُضاف إلى سلاسل التوابع المحتملة (لاحظ أنّ أخطاء HTTP تعدّ حالة خاصة). protocol_open()‎: إشارة إلى أنّ المعالج يعرف كيف يفتح عناوين URL الخاصة بالبروتوكول. http_error_type()‎: إشارة إلى أنّ المعالج يعرف كيف يعالج أخطاء HTTP مع شيفرة أخطاء HTTP ‏type. protocol_error()‎: إشارة إلى أنّ المعالج يعرف كيف يعالج أخطاء من بروتوكول (غير http). protocol_request()‎: إشارة إلى أنّ المعالج يعرف كيف يعالج طلبات protocol مسبقًا. protocol_response()‎: ...

تقدم كائنات Counter (العدادات) أداة سريعة ومريحة لإجراء عمليات العدّ والحصول على المجموع. العدّاد هو صنف متفرع من الصنف dict وظيفته عدّ الكائنات القابلة للتقطيع hashable. وهو عبارة عن مجموعة غير مرتّبة تكون فيها العناصر مخزّنة على هيئة مفاتيح قاموس ويخزّن تعداد هذه العناصر كقيم لتلك المفاتيح. يمكن للتعداد أن يكون عددًا صحيحًا وأن يكون صفرًا أو عددًا سالبًا. جدير بالذكر أن الصنف Counter مشابه للـ bags أو multisets في لغات البرمجة الأخرى. البنية العامة ‎class collections.Counter([iterable-or-mapping]) يمكن عدّ العناصر ...

صنف مخلوط mixin class يساعد في عمليات استيثاق HTTP لكلٍّ من المضيف البعيد remote host والوسيط proxy. البنية العامة urllib.request.AbstractDigestAuthHandler(password_mgr=None) المعاملات password_mgr معامل اختياري، ويجب أن تكون قيمته متوافقة مع الصنف HTTPPasswordMgr. راجع قسم كائنات HTTPPasswordMgr للاطلاع على معلومات مفصّلة حول الواجهة التي يجب أن تكون مدعومة. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

يحلّل التابع النموذج المعطى ويعيد صنفًا متفرعًا من الصنف Dialect الذي يعكس المعاملات التي عثر عليها التابع. البنية العامة sniff(sample, delimiters=None) المعاملات ‎delimiters معامل اختياري، تُفسّر قيمته كسلسلة نصية تحتوي على المحارف التي يحتمل استخدامها كفواصل في ملف CSV. القيمة المعادة يعيد التابع صنفًا متفرعًا من الصنف Dialect. أمثلة يبين المثال التالي طريقة عمل التابع: with open('example.csv', newline='') as csvfile: dialect = csv.Sniffer().sniff(csvfile.read(1024)) csvfile.seek(0) reader = csv.reader(csvfile, dialect) ...

البنية العامة HTTPPasswordMgrWithPriorAuth.add_password(realm, uri, user, passwd, is_authenticated=False) المعاملات realm, uri, user, passwd هذه المعاملات مشابهة لنظيراتها في التابع HTTPPasswordMgr.add_password()‎. is_authenticated يعين هذا المعامل القيمة الابتدائية للراية is_authenticated لعنوان URI المعطى أو لقائمة عناوين URI المعطاة. في حال تعيين القيمة True للمعامل is_authenticated، سيتجاهل التابع قيمة المعامل realm. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

صنف متفرّع من الصنف الداخلي dict يعيد تعريف override تابع واحد ويضيف متغير نسخة واحدًا قابلًا للكتابة. البنية العامة ‎class collections.defaultdict([default_factory[, ...]]) تعيد الدالة البانية لهذا الصنف كائنًا جديدًا شبيهًا بالقاموس، وdefaultdict هو صنف متفرّع من الصنف الداخلي dict يعيد تعريف override تابع واحد ويضيف متغير نسخة واحدًا قابلًا للكتابة. أما بقية التوابع فهي مماثلة للصنف الرئيسي ولن توثّق هنا. يحدّد المعامل الأول القيمة الابتدائية للخاصية default_factory ويأخذ هذا المعامل القيمة الافتراضية None. أما بقية المعاملات (ومن ضمنها المعاملات المفتاحية) ...

تدرج الدالة القيمة المعطاة في الكومة، مع الحفاظ على ثبات الكومة. البنية العامة ‎heapq.heappush(heap, item) المعاملات item القيمة المراد إدراجها في الكومة. heap الكومة التي ستُدرج فيها قيمة المعامل item. أمثلة يبين المثال التالي آلية عمل التابع: >>> import heapq >>> li = [5, 7, 9, 1, 3] >>> heapq.heapify(li) >>> print (list(li)) [1, 3, 9, 7, 5] >>> heapq.heappush(li, 4) >>> print(list(li)) [1, 3, 4, 7, 5, 9] انظر أيضًا الدالة heappop()‎: تحذف الدالة وتعيد أصغر عنصر في الكومة، مع الحفاظ على ثبات الكومة. الدالة heappushpop()‎: ...

يقدّم هذا الصنف توابع لقراءة الأسئلة عن ملف robots.txt وتحليلها والإجابة عن الأسئلة المتعلّقة بها في عنوان URL المعطى. البنية العامة urllib.robotparser.RobotFileParser(url='') توابع الصنف RobotFileParser يقدّم الصنف RobotFileParser التوابع التالية: التابع set_url(url)‎ يعين التابع عنوان URL الذي يشير إلى ملف robots.txt. التابع read()‎ ‎يقرأ التابع عنوان URL الخاص بملف robots.txt ويرسله إلى المحلّ. التابع parse(lines)‎ يحلّل التابع الأسطر المعطاة في الملف. التابع can_fetch(useragent, url)‎ يعيد التابع القيمة True إن كان مسموحًا لوكيل المستخدم المعطى أن يجلب عنوان URL بالاعتماد على القواعد المضمّنة ...

تُغلِق الدالة واصفات الملفات بدءً من الواصِف المُمرَّر للمعامل fd_low وصولًا إلى الواصِف الذي يَسبُق الواصِف المُمرَّر للمعامل fd_high، مُتجاهلةً الأخطاء التي قد تَحدُث. البنية العامة closerange(fd_low, fd_high) المعاملات fd_low العدد البادِئ لمجال الواصِفات التي ستُغلَق (سيُغلَق الواصِف المُقابِل لهذا العدد). fd_high العدد المُمثِّل لنهاية مجال الواصِفات التي ستُغلَق (لن يُغلَق الواصِف المُقابِل لهذا العدد). القيمة المعادة لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None). أمثلة يُكافِئ استخدام الدالة تنفيذ الكود (ولكن الدالة تفعل ذلك بشكل أسرع): import ...

تُعيد الدالة صفًّا يحتوي على المُعرِّف الحقيقي والفعلي والمحفوظ لمُستخدِم العملية الحالية. البنية العامة getresuid() القيمة المعادة تُعيد الدالة صفًّا يحتوي (بالترتيب المذكور) على المُعرِّف الحقيقي (real) والفعلي (effective) والمحفوظ (saved) لمُستخدِم العملية الحالية. أمثلة في المقتطف أدناه مثالين على استخدام الدالة للحصول على المُعرِّفات الثلاث لمُستخدِم عملية مرَّة يكون بصلاحيات عادية والأخرى بصلاحيات الجذر. >>> from os import getresuid >>> getresuid() (1000, 1000, 1000) >>> getresuid() (0, 0, 0) مصادر قسم الوحدة os في توثيق بايثون الرسمي.

تعيد الدّالة itertools.product()‎ حاصل الضرب الديكارتي (أو الضرب المباشر) للكائنات القابلة للتّكرار المُعطاة. طريقة العمل مُكافئة لحلقات for المُتداخلة في تعبير مُولّد. مثلًا، الاستدعاء product(A, B)‎ يُعيد ما يُعيده التّعبير ‎((x,y)‎ for‎ x‎ in A‎ for y in B‎)‎. تدور الحلقات المُتداخلة مثل عدّاد مسافة (odometer) من العنصر على أقصى اليمين مُتقدّمةً عند كلّ تكرار. يُنشئ هذا النّسق ترتيبًا مُعجميًّا (lexicographic)، لذا فإن كانت الكائنات القابلة للتّكرار المُعطاة مُرتّبةً، فستُنتج صفوف الضّرب المُباشر مُرتّبةً. البنية العامة itertools.product(*iterables, repeat=1) المعاملات iterables ...

لا تؤدي عبارة pass أي عمل على الإطلاق، ويمكن استخدامها عندما تكون عبارة معيّنة مطلوبة لغويًّا ولكنّها لا تؤدّي وظيفة معينة. فعلى سبيل المثال يؤدي تنفيذ الشيفرة التالية إلى جعل مفسّر بايثون مشغولًا وبانتظار قطع عملية التنفيذ عن طريق الضغط على مفتاحي Ctrl+C: >>> while True: ...     pass ... تستخدم هذه العبارة عادة في إنشاء أصناف مصغّرة: >>> class MyEmptyClass: ...     pass ... يمكن استخدام عبارة pass أيضًا كنصّ بديل مؤقت لدالة أو جملة شرطية معيّنة عند العمل على شيفرة جديدة، الأمر الذي ...

تُحوّل الدّالة functools.cmp_to_key()‎ دالّة مُقارنة (comparison function) إلى دالّة مفتاح (key function). تُستعمل مع الأدوات التي تقبل دوالّ مفتاح مثل sorted()‎، وmin()‎، وmax()‎، وheapq.nlargest()‎، وheapq.nsmallest()‎، وitertools.groupby()‎. تُستعمل هذه الدّالة أساسًا كأداة لنقل البرامج من Python 2 التي دعمت استعمال دوال المُقارنة. دالّة المُقارنة هي كلّ كائن قابل للاستدعاء يستقبل مُعاملين ويُقارن بينهما، ويُعيد عددًا سالبًا في حالة أصغر من، الصّفر في حالة التّساوي، وعددًا موجبًا في حالة أكبر من. ودالّة مفتاح هي كائن قابل للاستدعاء يستقبل مُعاملًا واحدًا ويُعيد قيمةً ...

يعيد التابع سلسلة نصية تمثل التاريخ، وتتضمّن الاسم المختصر لكل من اليوم والشهر يتبعهما اليوم ثم الساعة والدقيقة والثانية ثم السنة. البنية العامة ‎date.ctime() القيمة المعادة يعيد التابع سلسلة نصية تمثل التاريخ. التعبير d.ctime()‎ مكافئ للتعبير time.ctime(time.mktime(d.timetuple()))‎ في المنصّات التي تكون فيها دالة ctime()‎ بلغة C (والتي يستدعيها التابع time.ctime()‎ ولا يستدعيها التابع date.ctime()‎) متوافقة مع معايير لغة C. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import date >>> d = date(2018, 6, 27) >>> d.ctime() 'Wed Jun 27 00:00:00 ...

هذا التابع مشابه للتابع Template.substitute()‎ ، باستثناء أنّه لا يطلق خطأً أو استثناءً عند حدوث مشكلة أثناء عملية الاستبدال. البنية العامة safe_substitute(mapping, **kwds) المعاملات mapping أي كائن شبيه بالقاموس يتضمّن مفاتيح مطابقة للمعرّفات المستخدمة في القالب. ‎‎**kwds‎ يمكن بدلًا مما سبق تقديم معاملات مفتاحية، تكون فيها الكلمات المفتاحية مطابقة للمعرّفات المستخدمة في القالب. عند استخدام المعامل mapping مع المعاملات المفتاحية، تأخذ المعاملات المفتاحية الأولوية في حال وجود معرّفات متكرّرة بينهما. القيمة المعادة يعيد التابع سلسلة نصية جديدة ناتجة عن إجراء ...

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

يطلق هذا التابع افتراضيًا الاستثناء UnpicklingError. البنية العامة persistent_load(pid) المعاملات pid في حال تعريف هذا التابع فإنّه يعيد الكائن المحدّد بواسطة المعرّف المستمر pid، وإذا كان المعرّف المستمّر غير صالحٍ فإنّ التابع يُطلق الاستثناء UnpicklingError. راجع قسم "استمرارية الكائنات الخارجية" في وحدة pickle للاطلاع على المزيد من التفاصيل والأمثلة حول هذا الموضوع. انظر أيضًا التابع Unpickler.persistent_id()‎ : لا يؤدي هذا التابع افتراضيًا أي وظيفة، والهدف من وجوده هو إمكانية إعادة تعريفه override بواسطة صنف فرعي. مصادر صفحة DB-API 2.0 interface for ...

يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة. البنية العامة itermonthdates(year, month) المعاملات year السنة المطلوبة. month الشهر المطلوب (من 0 إلى 12). القيمة المعادة يعيد التابع كائن تكرار للشهر month في السنة year، وسيعيد هذا الكائن جميع الأيام (ككائنات datetime.date) للأشهر والأيام كلها قبل بداية الشهر أو بعد نهاية الشهر والتي تكون مطلوبة للحصول على أسبوع كامل. أمثلة يبين المثال التالي آلية عمل التابع: >>> from calendar import Calendar >>> cal = Calendar() >>> for c in cal.itermonthdates(2018, 8): ... ...

تقرأ الدالة قيمة واحدة من الملف المفتوح وتعيدها. البنية العامة marshal.load(file) ‎المعاملات file الملف الذي ستقرأ الدالة منه قيمة واحدة. يجب أن يكون الملف المعطى ملفًّا ثنائيًا قابلًا للقراءة. القيمة المعادة تقرأ الدالة قيمة واحدة من الملف المفتوح وتعيدها. في حال عدم تمكّن الدالة من قراءة أيّ قيمة سليمة (كأن يكون السبب هو أنّ البيانات تمتلك نسخة ترتيب مختلفة وغير متوافقة مع نسخة الترتيب في إصدار بايثون المستخدم) تطلق اللغة الخطأ EOFError أو ValueError أو TypeError. أمثلة يبين المثال التالي ...

يعالج هذا الصنف عملية الاستيثاق مع الوسيط. البنية العامة urllib.request.ProxyDigestAuthHandler(password_mgr=None) المعاملات password_mgr معامل اختياري، ويجب أن تكون قيمته متوافقة مع الصنف HTTPPasswordMgr. راجع قسم كائنات HTTPPasswordMgr للاطلاع على معلومات مفصّلة حول الواجهة التي يجب أن تكون مدعومة. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

تختبر الدالة ما إذا كان اختبار السلامة مدعومًا من قبل نظام التشغيل أم لا. البنية العامة lzma.is_check_supported(check) المعاملات ‎check الاختباران CHECK_NONE و CHECK_CRC32 مدعومان دائمًا، أما الاختباران CHECK_CRC64 و CHECK_CRC256 فقد لا يكونان متوفّرين إن كنت تستخدم نسخة من liblzma بنيت مع مجموعة محدّدة من الميزات. القيمة المعادة تعيد الدالة القيمة True إن كان اختبار السلامة مدعومًا من قبل نظام التشغيل. مصادر صفحة Compression using the LZMA algorithm في توثيق بايثون الرسمي.

يعيد التابع نسخة من كائن الضغط. يمكن استخدام هذا التابع لإجراء عملية ضغط وبكفاءة عالية لمجموعة من البيانات التي تمتلك سابقة prefix مشتركة. البنية العامة Compress.copy() انظر أيضًا التابع Decompress.copy()‎: يعيد التابع نسخة من كائن فك الضغط. مصادر صفحة Compression compatible with gzip في توثيق بايثون الرسمي.

يعيد التابع سلسلة نصية تمثّل التاريخ بصيغة ISO 8601. البنية العامة ‎date.isoformat() القيمة المعادة يعيد التابع سلسلة نصية تمثّل التاريخ بصيغة ISO 8601 وهي 'YYYY-MM-DD'. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import date >>> d = date(2018, 6, 27) >>> d.isoformat() '2018-06-27' انظر أيضًا التابع date.isocalendar()‎: يعيد التابع صفًّا يضمّ ثلاثة عناصر هي (ISO year, ISO week number, ISO weekday). التابع date.isoweekday()‎: يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، حيث يأخذ يوم الاثنين الرقم 0 ويوم الأحد ...

يحدّد التابع مقدار إزاحة الوقت في كائن datetime عن التوقيت العالمي المنسّق. البنية العامة ‎datetime.utcoffset() القيمة المعادة إن أخذ الكائن tzinfo القيمة None، فإنّ التابع يعيد القيمة ذاتها، وإلاّ فإنّه يعيد self.tzinfo.utcoffset(None)‎، ويطلق التابع استثناءً إن لم تُعِد العبارة السابقة القيمة None أو كائن timedelta بفارق زمني لا يتجاوز اليوم الواحد. ملاحظة: في الإصدار 3.7 من بايثون، لم يعد مقدار الإزاحة عن التوقيت العالمي المنسّق مقيّدًا بعدد صحيح من الدقائق. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime ...

يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح. البنية العامة ‎datetime.weekday() القيمة المعادة يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، حيث يأخذ يوم الاثنين الرقم 0 ويوم الأحد الرقم 6. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import datetime >>> d = date(2018, 6, 26, 20, 47) >>> d.weekday() 1 انظر أيضًا التابع datetime.isoweekday()‎: يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، حيث يأخذ يوم الاثنين الرقم 1 ويوم الأحد الرقم 7. مصادر قسم datetime Objects ...

تابع صنف classmethod ينشئ ويعيد كائن TarInfo من سلسلة ذاكرة نصية string buffer (أو ما يعرف بملف الذاكرة) معطاة. البنية العامة TarInfo.frombuf(buf, encoding, errors) المعاملات buf سلسلة ذاكرة نصية string buffer يستخدمها التابع لإنشاء كائن TarInfo. القيمة المعادة يعيد التابع كائن TarInfo. يطلق التابع الاستثناء HeaderError إن كان ملف الذاكرة غير صالح للاستخدام. انظر أيضًا التابع TarInfo.fromtarfile()‎: تابع صنف يقرأ العضو التالي من كائن TarFile المعطى ويعيده على هيئة كائن TarInfo. مصادر صفحة Read and write tar archive files في توثيق ...

يفسّر التابع الإعدادات من سلسلة نصية. ملاحظة: هذا التابع جديد في الإصدار 3.2 من بايثون. البنية العامة read_string(string, source='<string>') المعاملات ‎string السلسلة النصية المراد تفسير الإعدادات فيها. source معامل اختياري يحدد اسمًا خاصًّا بالسياق context-specific name للسلسلة النصية الممرّرة. تُستخدم القيمة '<string>' في حال عدم استخدام هذا المعامل. عادة ما تكون قيمة هذا المعامل مسارًا في ملفات النظام أو عنوان URL. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import configparser >>> sample_config = """ ... [mysqld] ... user = mysql ... ...

يتحقق التابع من وجود عناصر مشتركة مع مجموعة أخرى. البنية العامة isdisjoint(other) المعاملات other مجموعة يتحقّق التابع من وجود عناصر مشتركة بينها وبين المجموعة الأصلية. القيمة المعادة يعيد التابع القيمة True عندما لا يكون هناك عناصر مشتركة بين المجموعتين. تكون المجموعتان مفكوكتين (disjoint) إذا -وفقط إذا- كان حاصل تقاطعهما مجموعةً فارغة. أمثلة يبين المثال التالي النتائج المعادة من تطبيق التابع على مجموعات مختلفة: >>> s = {1, 2, 4, 9, 10} >>> t = {3, 5, 7, 11, 15} >>> s.isdisjoint(t) True >>> t ...

الدّالة functools.lru_cache()‎ مُزخرفٌ يُحيط دالّة بكائن قابل للاستدعاء مُتذكّر (memoizing callable). الكائن المُتذكِّر يحتفظ بعددٍ من آخر الاستدعاءات حسب قيمة المُعامل maxsize. ويُمكن أن تختصر الوقت إن كانت دالّة تأخذ الكثير من الوقت تُستدعَى بنفس المُعاملات عدّة مرّات. ولأنّ النّتائج تُخبّأ (cache) في قاموس، فيجب على المُعاملات المُمرّرة للدّالة المُزخرَفة أن تكون قابلة للتّجزئة (hashable). البنية العامة @functools.lru_cache(maxsize=128, typed=False) المعاملات maxsize عدد الاستدعاءات التي ستُخبّأ، إن مُرّرت له القيمة None، تُعطّل ميّزة LRU (الأقلّ استخدامًا مؤخّرًا، Least recently used) ويُمكن ...

يعيد التابع التاريخ والوقت المحلّيين والموافقين لختم POSIX الزمني كالذي يعيده التابع time.time()‎. البنية العامة ‎datetime.fromtimestamp(timestamp, tz=None) المعاملات timestamp سلسلة نصية تحتوي ختم POSIX الزمني والذي يستخدمه التابع لإنشاء كائن datetime. tz صنف فرعي من الصنف tzinfo، يحدّد المنطقة الزمنية. يحوّل الختم الزمني إلى التاريخ والوقت المحلّيين في المنصّة ويكون كائن datetime المعاد كائنًا بسيطًا في حال إعطاء القيمة None إلى المعامل الاختياري tz أو في حال عدم تحديد أيّ قيمة له. إن لم يأخذ المعامل tz القيمة None، فيجب ...

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

ينشئ التابع قاموسًا جديدًا من التسلسل الذي يحدّده المستخدم في المعاملات. البنية العامة fromkeys(seq[, value]) المعاملات seq تسلسل يستخدمه التابع لإنشاء مفاتيح القاموس الجديد. value معامل اختياري وقيمته الافتراضية هي None. يحدّد هذا المعامل القيمة التي سيُسندها التابع إلى مفاتيح القاموس الجديد. القيمة المعادة قاموس جديد تنشأ مفاتيحه من التسلسل seq ويحمل كل مفتاح القيمة value. أمثلة يبين المثال التالي طريقة استخدام التابع لإنشاء قاموس جديد: >>> s = {1, 2, 3, 4, 5} >>> numbers = dict.fromkeys(s) >>> numbers {1: None, 2: ...

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

يقسم هذا التابع التسلسل عند أول ظهور للقيمة التي يحدّدها المستخدم. البنية العامة str.partition(sep) المعاملات sep كائن شبيه بالبايتات (bytes-like object) يحدّد الفاصل الذي ستعتمده الدالة في تقسيم التسلسل. القيمة المعادة تعيد هذه الدالة صفًّا مكوّنًا من ثلاثة عناصر، الأول هو جزء التسلسل الذي يسبق الفاصل، والثاني هو الفاصل نفسه أو نسخة عنه من نوع مصفوفة البايتات، والثالث هو الجزء الذي يلي الفاصل. في حال عدم العثور على الفاصل يعيد التابع صفًّا مكوّنًا من ثلاثة عناصر، الأوّل هو نسخة عن ...

تتيح وحدة pprint إمكانية طباعة بنى البيانات في بايثون بصورة جميلة pretty-print بطريقة تسمح باستخدام هذه البيانات كمدخلات في مفسّر بايثون. وإن تضمنت البنى المنسّقة كائنات ليست من أنواع بايثون الأساسية، فمن الممكن أن يكون تمثيل ذلك الكائن غير قابل للتحميل. تظهر هذه الحالة عند تضمين كائنات مثل الملفات أو المنافذ sockets أو الأصناف، إلى جانب العديد من الكائنات الأخرى والتي تكون غير قابلة للتمثيل على هيئة حروف في بايثون. يُبقي التمثيل المنسّق الكائنات في سطر واحد إن كان ذلك ...

حذف جميع العناصر من كائن deque ويصبح طول الكائن 0. البنية العامة d.‎clear() أمثلة يبين المثال التالي آلية عمل التابع: >>> from collections import deque >>> d = deque('abcdef') >>> d deque(['a', 'b', 'c', 'd', 'e', 'f']) >>> d.clear() >>> d deque([]) >>> len(d) 0 انظر أيضًا التابع pop()‎:  :يحذف التابع ويعيد عنصرًا واحدًا من الجانب الأيمن في الكائن deque. التابع popleft()‎:  :يحذف التابع ويعيد عنصرًا واحدًا من الجانب الأيسر في الكائن deque. التابع remove()‎:  :يحذف التابع أوّل عنصر يحمل القيمة المعطاة. مصادر قسم deque Objects في صفحة ...

تفتح الدّالة 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 مُعامل ...

يحمل هذا التابع إحدى ملحقات SQlite من المكتبة المشتركة. يجب تفعيل خاصية تحميل الملحقات بواسطة التابع enable_load_extension()‎ قبل استخدام هذا التابع. يجدر التنبيه إلى أنّ الملحقات القابلة للتحميل معطّلة بصورة افتراضية، وذلك لأنّ بعض المنصّات (وبالخصوص Mac OS X) تمتلك مكتبات SQLite مصرّفة دون تضمين هذه الميزة. لتفعيل ميزة الملحقات القابلة للتحميل يجب تمرير ‎-enable-loadable-sqlite-extensions إلى الإعدادات. ملاحظة: هذا التابع جديد في الإصدار 3.2. البنية العامة load_extension(path) المعاملات path المسار المؤدي إلى الملحقة المطلوب تحميلها. أمثلة يبين المثال التالي طريقة ...

هذا هو تابع الواجهة البرمجية العام، ويأخذ سلسلة تنسيق نصية وعددًا من المعاملات الموقعية والمفتاحية. ويعدّ تابع تغليف wrapper يستدعي التابع vformat()‎. البنية العامة format(format_string, *args, **kwargs) المعاملات format_string سلسلة التنسيق النصية التي يعالجها التابع. القيمة المعادة يعيد التابع سلسلة نصية هي نتيجة معالجة سلسلة التنسيق النصية المعطاة. ملاحظة: أصبح تمرير سلسلة تنسيق نصية كمعامل format_string مفتاحي مهملًا في الإصدار 3.5 من اللغة. أمثلة يبين المثال التالي طريقة استخدام التابع: >>> import string >>> formatter = string.Formatter() >>> formatter.format("From {} to {}", ...

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

يعيد التابع التاريخ والوقت الموافقين لسلسلة التاريخ النصية والمنسّقة بالصيغة التي تنشأ من استخدام التابع datetime.isoformat()‎. البنية العامة ‎datetime.fromisoformat(date_string) المعاملات date_string سلسلة نصية تتضمّن التاريخ والوقت المطلوب تحويلهما إلى كائن datetime، وتتبع السلسلة النصية الصيغة: ‎DD[*HH[:MM[:SS[.mmm[mmm]]]][+HH:MM[:SS[.ffffff]]]]‎ ويمكن للرمز * أن يطابق أيّ حرف مفرد. القيمة المعادة كائن datetime يكون التاريخ والوقت فيه موافقين للتاريخ والوقت المعطيين في السلسلة النصية date_string. تنبيه: لا يفسّر هذا التابع جميع سلاسل المعيار ISO 8601، بل الهدف منه هو أداء الوظيفة المعاكسة للتابع datetime.isoformat()‎. ملاحظة: ...

يجلب التابع محتويات عنوان URL المعطى ويضعها في الملف المعطى. البنية العامة URLopener.retrieve(url, filename=None, reporthook=None, data=None) ‎المعاملات ‎reporthook معامل اختياري، يجب أن يكون دالة تستقبل ثلاثة معاملات عددية هي: عدد قطعة البيانات chunk، أقصى حجم لقطع البيانات، والحجم الكلي لعملية التحميل (‎-1 إن كان الحجم مجهولًا). تستدعى هذه الدالة مرة واحدة عند بدء عملية قراءة قطعة البيانات وبعد قراءة كلّ قطعة بيانات من الشبكة. يتجاهل التابع المعامل reporthook عند استخدام عناوين URL محلية. ‎data إن استخدم المعامل url المخطط http:‎ ...

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

ملاحظة: هذا التابع مهمل منذ الإصدار 3.2 من بايثون، استخدم التابع read_file()‎ عوضًا عنه. ملاحظة: يمرّ التابع readfp()‎ على عناصر fp عوضًا عن استدعاء التابع fp.readline()‎. البنية العامة readfp(fp, filename=None) إن تضمنت الشيفرة استدعاءات للتابع readfp()‎ مع معاملات لا تدعم التكرار، فيمكن استخدام المولّد التالي لتغليف الكائن الشبيه بالملف: def readline_generator(fp): line = fp.readline() while line: yield line line = ...

يعيد التابع أعلى قيمة للفهرس في التسلسل الأصلي حيث تجد فيه التسلسل الفرعي. البنية العامة str.rfind(sub[, start[, end]]) المعاملات sub التسلسل الفرعي المراد معرفة موقعه. يمكن أن يكون هذا المعامل أي كائن شبيه بالبايتات (bytes-like object) أو عددًا صحيحًا يبدأ من 0 وينتهي بالعدد 255. start الموقع الذي يبدأ منه التابع عملية البحث ضمن التسلسل الأصلي. end الموقع الذي ينهي فيه التابع عملية البحث ضمن التسلسل الأصلي. يسلك هذان المعاملان الاختياريان نفس السلوك المتّبع في عملية اقتطاع السلاسل النصية slicing. ...

تطبع الدالة تقويم الشهر الذي تعيده الدالة 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()‎ ولكنّه يأخذ نطاقات أكثر ...

يحدّد التابع المهلة المسموحة للاتصالات بالثواني. البنية العامة CacheFTPHandler.setTimeout(t) المعاملات t عدد الثواني التي تمثّل المهلة المسموح بها للاتصالات. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

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

يتحقق هذا التابع ممّا إذا كان التسلسل الثنائي مكوّنًا من الأعداد العشرية بترميز ASCII فقط، وأنّ التسلسل ليس فارغًا. البنية العامة bytes.isdigit() القيمة المعادة يعيد التابع القيمة True إذا كانت التسلسل الثنائي مكوّنًا من الأعداد العشرية بترميز ASCII فقط، وكان فيه حرف واحد على الأقل، ويعيد القيمة False فيما عدا ذلك. الأعداد العشرية هي قيم البايتات التي تقع ضمن التسلسل: ‎b'0123456789'‎. أمثلة يبين المثال التالي النتائج المعادة من تطبيق التابع isdigit()‎ على تسلسلات ثنائية مختلفة: >>> b'1234'.isdigit() True >>> b'1.23'.isdigit() False انظر أيضًا ...

تفتح الدالة العنوان المعطى في نافذة جديدة في المتصفّح الافتراضي، إن كان ذلك ممكنًا، وإلا فإنّها ستفتح العنوان المعطى في النافذة الموجودة فقط. البنية العامة 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 في توثيق بايثون ...

يحذف التابع القسم المحدّد من ملف الإعدادات. البنية العامة remove_section(section) ‎المعاملات ‎section القسم المراد حذفه من ملف الإعدادات. القيمة المعادة يعيد التابع القيمة True إن كان القسم موجودًا، ويعيد القيمة False فيما عدا ذلك. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import configparser >>> config = configparser.ConfigParser() >>> config.read('config.cfg') ['config.cfg'] >>> config.remove_section('bitbucket.org') True >>> config.remove_section('github.com') False انظر أيضًا التابع remove_option()‎: يحذف التابع الخيار المعطى من القسم المحدّد من ملف الإعدادات. مصادر صفحة Configuration file parser في توثيق بايثون الرسمي.

يمكن إنشاء دوال لا تحمل أسماء باستخدام الكلمة المفتاحية lambda، وتأخذ هذه الدوال الصيغة التالية: lambda arguments: expression تسلك هذه الصيغة المختصرة سلوك دالة معرفة بالطريقة التالية: def <lambda>(arguments): return expression على سبيل المثال، تعيد الدالة التالية مجموع الوسيطين الخاصين بها: lambda a, b: a+b يمكن استخدام دوال lambda عند الحاجة إلى كائنات الدالة (function objects)، وتأخذ هذه الدوال تعبيرًا واحدًا فقط، وهي تعدّ صيغةً مختصرةً للطريقة الاعتيادية في تعريف الدوال. كما هو الحال مع تعريفات الدوال المتداخلة، يمكن لدوال ...

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

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

يحذف هذا التابع أول عنصر في القائمة تساوي قيمته القيمة التي يحدّدها المستخدم. البنية العامة l.remove() المعاملات x العنصر المراد حذفه من القائمة. القيمة المعادة يعيد هذا التابع القيمة None، ويُطلِق الخطأ ValueError إن كان العنصر المراد حذفه غير موجودٍ في القائمة. أمثلة يبين المثال التالي كيفية استخدام هذا التابع لحذف العناصر من القائمة: >>> fruits = ['orange', 'apple', 'pear', 'banana', 'kiwi', 'apple', 'banana'] >>> fruits.remove('banana') >>> fruits ['orange', 'apple', 'pear', 'kiwi', 'apple', 'banana'] >>> fruits.remove('watermelon') Traceback (most recent call last): File "<input>", line ...

تعدّ هذه الكائنات المفسّر الرئيسي لملفات الإعدادات. البنية العامة configparser.ConfigParser(defaults=None, dict_type=dict, allow_no_value=False, delimiters=('=', ':'), comment_prefixes=('#', ';'), inline_comment_prefixes=None, strict=True, empty_lines_in_values=True, default_section=configparser.DEFAULTSECT, interpolation=BasicInterpolation(), converters={}) المعاملات ‎defaults معامل اختياري، تهيّئ قيمته إلى القاموس الذي يحتوي على القيم الافتراضية الداخلية. dict_type معامل اختياري، يُستخدم في إنشاء كائنات القاموس لقائمة الأقسام، وللخيارات التي ينطوي عليها القسم، وللقيم الافتراضية. delimiters معامل اختياري يُستخدم كمجموعة السلاسل النصية الفرعية التي تقسم المفاتيح عن القيم. comment_prefixes معامل اختياري، يُستخدم كمجموعة السلاسل النصية الفرعية التي تسبق التعليقات التي تكتب في ...

تقدّم وحدة webbrowser واجهة متطوّرة تسمح بعرض مستندات الويب على المستخدمين. في أغلب الحالات يكفي استدعاء الدالة open()‎ ببساطة للقيام بكلّ شيء على نحو سليم. تكون متصفّحات الويب الرسومية graphical browser مفضّلة مع محرّك العرض X11، ولكنّ تستخدم الوحدة المتصفّحات النصية text-mode browsers إن كانت المتصفّحات الرسومية غير متوفّرة، أو كان محرّك العرض X11 غير متاح لاستخدام. وعند استخدام المتصفّحات النصية تتوقّف عملية الاستدعاء إلى حين خروج المستخدم من المتصفّح. إن كان متغيّر البيئة BROWSER موجودًا، فإنّه سيفسّر كقائمة os.pathsep ...

يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق datetime.date، وتعاد الأيام على هيئة صفوف تتضمّن رقم السنة، ورقم الشهر، ورقم اليوم في الشهر، ورقم اليوم في الأسبوع. البنية العامة monthdatescalendar(year, month) المعاملات year السنة المطلوبة. month الشهر المطلوب (من 0 إلى 12). القيمة المعادة يعيد التابع قائمة بالأسابيع في الشهر month في السنة year كأسابيع كاملة. الأسابيع هي قوائم تتضمّن سبعة كائنات datetime.date. أمثلة يبين المثال التالي آلية عمل التابع: >>> for c in cal.monthdatescalendar(2018, ...

تعيد الدّالة 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' إن أردت تحويل عدد صحيح ...