نتائج البحث

يعيد التابع الخيارات المنطوية تحت القسم المعطى. البنية العامة items(raw=False, vars=None) items(section, raw=False, vars=None) ‎المعاملات section ‎في حال عدم تمرير المعامل section فإنّ التابع يعيد قائمة تتضمّن أزواج اسم القسم، وسيط القسم (section_name, section_proxy) إضافة إلى قسم الإعدادات الافتراضية DEFAULTSECT. أما في حال تمرير المعامل section فإنّ التابع يعيد قائمة تتضمّن أزواج اسم، قيمة (name, value) للخيارات الموجودة في القسم المعطى. راجع التابع get()‎ للمزيد من التفاصيل حول المعاملات raw و vars. القيمة المعادة يعيد التابع قائمة تتضمن قيمًا مختلفة بالاعتماد ...

يضيف التابع العدد ‎b'0'‎ من الترميز ASCII إلى يسار التسلسل الثنائي ليصبح التسلسل بالطول المحدد من قبل المستخدم. البنية العامة bytes.zfill(width) المعاملات width يحدّد الطول المطلوب للتسلسل الثنائي بعد إضافة الأصفار. إذا كانت القيمة المحدّدة للمعامل width أقل من أو تساوي القيمة المعادة من len(seq)‎، فسيعيد التابع التسلسل الأصلي. في حال تضمّن التسلسل الثنائي إحدى السابقتين (‎b'+' / b'-'‎) فإنّ الأصفار تضاف بعد السابقة وليس قبلها. القيمة المعادة يعيد التابع نسخة من السلسلة النصية بعد إضافة العدد ‎‎b'0'‎ من الترميز ...

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

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

يضغط التابع البيانات المعطاة ويعيد كائن bytes يحتوي على البيانات المضغوطة لجزء من البيانات المعطاة على الأقل. البنية العامة Compress.compress(data) المعاملات data البيانات المراد ضغطها. يجب أن تكون هذه البيانات مرتبطة concatenated بالمخرجات الناتجة من أي استدعاءات سابقة للتابع compress()‎. قد يحتفظ التابع ببعض المدخلات في ذواكر داخلية لغرض المعالجة في وقت لاحق. انظر أيضًا التابع Decompress.decompress()‎: يفكّ التابع الضغط عن البيانات المعطاة، ويعيد كائن bytes يتضمّن البيانات مفكوكة الضغط والمرتبطة على الأقل بجزء من البيانات في السلسلة النصية string. ...

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

يعيد التابع عدد الثواني الكلّي في المدّة الزمنية التي يمثّلها كائن timedelta. البنية العامة ‎timedelta.total_seconds()‎ القيمة المعادة يعيد التابع عدد الثواني الكلّي في المدّة الزمنية التي يمثّلها كائن timedelta. يمكن الحصول على نفس نتيجة هذا التابع باستخدام التعبير td / timedelta(seconds=1)‎. ملاحظات 1- عندما تكون المدّة الزمنية التي يمثّلها كائن timedelta كبيرة جدًّا (أكثر من 270 سنة في معظم الأنظمة)، تظهر بعض الأخطاء على مستوى أجزاء من الثانية. 2- هذا التابع جديد في الإصدار 3.2 من اللغة. أمثلة يبين المثال ...

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

يحوّل التابع جميع الحروف بترميز ASCII في التسلسل الثنائي إلى حروف كبيرة. البنية العامة bytes.upper() القيمة المعادة يعيد التابع نسخة من التسلسل الثنائي بعد تحويل جميع الحروف بترميز ASCII إلى حروف كبيرة. الحروف الصغيرة في ترميز ASCII هي قيم البايتات التي تقع ضمن التسلسل: ‎b'abcdefghijklmnopqrstuvwxyz'‎. أما الحروف الكبيرة في ترميز ASCII هي قيم البايتات التي تقع ضمن التسلسل: ‎b'ABCDEFGHIJKLMNOPQRSTUVWXYZ'‎. أمثلة يبين المثال التالي النتائج المعادة من استخدام التابع: >>> b = b"Hsoub" >>> b.upper() b'HSOUB' >>> b = b"hsoub wiki" >>> b.upper() b'HSOUB WIKI' انظر ...

تحذف الدالة الملفات المؤقتة التي خلّفتها الاستدعاءات السابقة للدالة urlretrieve()‎. البنية العامة urllib.request.urlcleanup() انظر أيضًا الدالة urllib.request.urlretrieve()‎: تنسخ الدالة كائن شبكة network object المشار إليه بواسطة عنوان URL إلى ملف محلّي. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

يسجّل هذا التابع كائن استدعاء خلفيٍّ، وينفّذ هذا الكائن في كل محاولة للوصول إلى عمود في جدول ضمن قاعدة البيانات. البنية العامة set_authorizer(authorizer_callback) ‎ المعاملات authorizer_callback كائن استدعاء خلفي يُنفّذ في كل محاولة للوصول إلى أعمدة الجداول في قاعدة البيانات. يجب أن يعيد الاستدعاء الخلفية النتيجة SQLITE_OK إن كان الوصول مسموحًا به، والنتيجة SQLITE_DENY إن كان المطلوب تجاهل جملة SQL بأكملها مع إطلاق خطأ، والنتيجة SQLITE_IGONRE إن كن المطلوب التعامل مع العمود على أنّه يحمل القيمة NULL. هذه الثوابت متاحة ...

يُقسِّم هذا التابع السلسلة النصية إلى قائمة من الأسطر. البنية العامة x.splitlines() المعاملات keepends قيمة منطقية (Boolean). تُدرج فواصل الأسطر في القائمة المعادة عندما يأخذ هذا المعامل القيمة True. القيمة المعادة يعيد التابع قائمة من الأسطر التي تكوّن السلسلة النصية، وتجري عملية التقسيم عند حدود الأسطر، ولا تُدرج فواصل الأسطر في القائمة المعادة إلا إذا أخذ المعامل keepends القيمة True. يقسم التابع السلاسل النصية عند حدود الأسطر التالية: الفاصل الوصف ‎\n محرف السطر الجديد (Line Feed). ‎\r محرف العودة إلى ...

يعيد التابع مكرِّرًا iterator يمكن استخدامه لعرض (dump) قاعدة البيانات بصيغة SQL النصية. البنية العامة iterdump() ‎القيمة المعادة يعيد التابع مكرِّرًا iterator يمكن استخدامه لعرض (dump) قاعدة البيانات بصيغة SQL النصية. هذا التابع مفيد عند التعامل مع قواعد البيانات المخزّنة في الذاكرة. يقدّم هذا التابع نفس الإمكانات التي يقدّمها الأمر ‎.dumb في صدفة sqlite3. أمثلة يعرض المثال التالي كيفية تحويل الملف existing_db.db إلى ملف عرض SQL يحمل الاسم dump.sql: import sqlite3 con = sqlite3.connect('existing_db.db') with open('dump.sql', 'w') as f: ...

يعيد التابع المعلومات المطلوبة لتوثيق المستخدم عند المضيف المعطى في حقل الأمان security realm المحدّد. البنية العامة FancyURLopener.prompt_user_passwd(host, realm) ‎المعاملات ‎host المضيف الذي يعيد التابع منه المعلومات المطلوبة لتوثيق المستخدم. realm حقل الأمان المطلوب. القيمة المعادة يجب أن تكون القيمة المعادة صفًّا بهيئة (user, password) والذي يمكن استخدامه لإجراء عمليات الاستيثاق البسيطة. يطلب التابع إدخال هذه المعلومات في الطرفية، ويمكن للتطبيق أن يعيد تعريف هذا التابع لاستخدام الطريقة الملائمة للتفاعل مع المستخدم في البيئة المحلية. مصادر صفحة Extensible library for ...

ينفّذ التابع جملة SQL المعطاة. البنية العامة execute(sql[, parameters]) ‎المعاملات sql سلسلة نصية تتضمن جملة SQL المراد تنفيذها. يمكن استخدام جمل تتضمن معاملات (أي استخدام محتوى نائب placeholder عوضًا عن الحروف). تدعم وحدة sqlite3 نوعين من المحتويات النائبة، هما: علامة الاستفهام (نمط qmark) ومحتوى نائب مسمّى (نمط التسمية). ينفّذ تابع execute()‎ جملة SQL واحدة، ويطلق التابع تحذيرًا في حال استخدام أكثر من جملة واحدة. يمكن استخدام التابع executescript()‎ لتنفيذ جمل متعددة في استدعاء واحد. أمثلة يبين المثال التالي طريقة استخدام ...

يعيد التابع‎ الحروف في السلسلة النصية بالاعتماد على جدول التحويل (translation table). البنية العامة x.translate() المعاملات table يجب أن يكون الجدول كائنًا يؤدي عملية الفهرسة (indexing) باستخدام التابع __getitem()‎__ وعادة ما يكون تسلسلًا أو قاموسًا. (راجع التابع str.maketrans()‎ للمزيد من المعلومات حول كيفية إنشاء هذا الجدول). القيمة المعادة يعيد التابع نسخة من السلسلة النصية بعد استبدال الحروف بالاعتماد على جدول الترجمة. عند فهرسة كائن الجدول حسب رتب الترميز الموحد (أعداد صحيحة) يمكن للكائن أن يؤدي ما يلي: إعادة رتبة ترميز ...

يقسم التابع التسلسل الثنائي إلى قائمة من تسلسلات ثنائية فرعية من النوع ذاته، بالاعتماد على فاصل محدّد. البنية العامة bytes.split(sep=None, maxsplit=-1) المعاملات maxsplit يحدد هذا المعامل الحد الأقصى لعمليات التقسيم التي سيجريها التابع، وبهذا تمتلك القائمة المعادة maxsplit+1 من العناصر على الأكثر. في حال عدم تحديد قيمة المعامل maxsplit أو كانت قيمته -1، فلن يكون هناك حدّ لعمليات التقسيم (ستجري الدالة جميع عمليات التقسيم الممكنة). sep يحدّد هذا المعامل الفاصل الذي سيعتمده التابع في تقسيم السلسلة النصية. في حال تحديد ...

يعيد التابع سلسلة نصية تمثل التاريخ والوقت، وتتضمّن الاسم المختصر لكل من اليوم والشهر يتبعهما اليوم ثم الساعة والدقيقة والثانية ثم السنة. البنية العامة ‎datetime.ctime() القيمة المعادة يعيد التابع سلسلة نصية تمثل التاريخ والوقت، مثل: datetime(2002, 12, 4, 20, 30, 40).ctime() == 'Wed Dec 4 20:30:40 2002' التعبير d.ctime()‎ مكافئ للتعبير time.ctime(time.mktime(d.timetuple()))‎ في المنصّات التي تكون فيها دالة ctime()‎ بلغة C (والتي يستدعيها التابع time.ctime()‎ ولا يستدعيها التابع datetime.ctime()‎) متوافقة مع معايير لغة C. أمثلة يبين المثال التالي آلية ...

يؤدي استدعاء هذا التابع إلى معالجة جميع المدخلات المعلّقة، ويعيد التابع كائن bytes يحتوي على المخرجات المضغوطة المتبقية. البنية العامة Compress.flush([mode]) المعاملات mode يمكن أن يأخذ المعامل mode إحدى القيم الثابتة التالية: Z_NO_FLUSH، Z_PARTIAL_FLUSH، Z_SYNC_FLUSH، Z_FULL_FLUSH، Z_BLOCK (في الإصدار 1.2.3.4 من zlib) أو ‎Z_FINISH، ويأخذ القيمة الافتراضية Z_FINISH. تسمح جميع الثوابت -باستثناء الثابت Z_FINISH- بضغط سلاسل بايتات إضافية من البيانات، في حين ينهي الثابت Z_FINISH تدفق البيانات المضغوطة ويمنع ضغط المزيد من البيانات. لا يمكن استدعاء التابع compress()‎ مرة أخرى ...

يستخرج التابع جميع الأعضاء في ملف الأرشيف إلى المجلد الحالي. البنية العامة ZipFile.extractall(path=None, members=None, pwd=None) ‎المعاملات ‎path يحدّد المعامل مسارًا بديلًا لاستخراج الملفات فيه. members معامل اختياري يجب أن يكون مجموعة فرعية من القائمة المعادة بواسطة التابع namelist()‎. pwd كلمة المرور المستخدمة لتعمية الملفات. تحذير لا تستخرج ملفات الأرشيف القادمة من مصادر غير موثوقة دون فحصها. من الممكن أن تكون الملفات قد أنشئت خارج المسار المحدد في المعامل path (مثل: ملفات تبدأ أسماءها بخط مائل "/" أو تتضمّن نقطتين ".."). ...

يختبر التابع ما إذا كان العدد العشري محدودًا (finite) ويمتلك قيمة صحيحة أم لا. البنية العامة (x).is_integer() القيمة المعادة يعيد التابع float.is_integer()‎ القيمة True إذا كان العدد العشري محدودًا ويمتلك قيمة صحيحة، ويعيد القيمة False فيما عدا ذلك. أمثلة يوضّح المثال التالي القيم المعادة من استخدام التابع على أعداد عشرية متنوعة: >>> (-2.0).is_integer() True >>> (3.2).is_integer() False انظر أيضًا الأعداد الصحيحة في بايثون. الأعداد العشرية في بايثون. التابع float.as_integer_ratio()‎: إعادة زوج من الأعداد الصحيحة التي تكون نسبتها مساوية للعدد العشري تمامًا، ويكون المقام ...

يستبدل التابع القيم المعطاة في المعاملات بالقيم الأصلية في كائن التاريخ. البنية العامة date.replace(year=self.year, month=self.month, day=self.day)‎ المعاملات يأخذ التابع ثلاث معاملات مفتاحية هي year و month و day (السنة والشهر واليوم). تحلّ القيمة المحدّدة لأيّ من هذه المعاملات محلّ القيمة المقابلة في كائن التاريخ. تأخذ هذه المعاملات قيمًا افتراضية تساوي القيم المحدّدة في كائن التاريخ. القيمة المعادة يعيد التابع كائن التاريخ بعد إجراء عملية الاستبدال المحدّدة بواسطة المعاملات. أمثلة يبين المثال التالية آلية عمل التابع: >>> from datetime import date >>> ...

يتحقّق هذا التابع ممّا إذا كانت السلسلة النصية تضمّ حروفًا وأرقامًا وأنّها تضمّ حرفًا واحدًا على الأقل. البنية العامة x.isalnum() القيمة المعادة يعيد التابع القيمة True إن كانت جميع الحروف في السلسلة النصية حرفية ورقمية وأنّ هناك على الأقل حرفًا واحدًا فيها، ويعيد القيمة False فيما عدا ذلك. يكون الحرف c حرفيًا ورقميًا إن أعادت إحدى الدوال التالية القيمة True: ‏‎c.isalpha()، أو c.isdecimal()، أو c.isdigit()‎، أو c.isnumeric()‎. أمثلة يبيّن المثال التالي النتائج المعادة من تطبيق التابع isalnum()‎ على أنواع مختلفة ...

يؤدي التابع عملية نسخ سطحية (shallow copy) للقاموس. البنية العامة dict.copy() القيمة المعادة يعيد التابع قاموسًا جديدًا هو عبارة عن نسخة سطحية عن القاموس الأصلي. أمثلة يبين المثال التالي النتائج المعادة من تطبيق التابع: >>> sphere = {"x": 2, "y": 3, "z": 1} >>> cube = sphere.copy() >>> cube {'x': 2, 'y': 3, 'z': 1} انظر أيضًا القواميس في بايثون. التابع dict.fromkeys()‎: إنشاء قاموس جديد من التسلسل الذي يحدّده المستخدم في المعاملات. مصادر قسم copy في صفحة Types في توثيق بايثون الرسمي.

يتحقق هذا التابع ممّا إذا كانت جميع البايتات في التسلسل الثنائي حروفًا أو أرقامًا عشرية في ترميز ASCII، ومن أنّ التسلسل ليس فارغًا. البنية العامة bytes.isalnum() القيمة المعادة يعيد التابع القيمة True إن كانت جميع البايتات في التسلسل الثنائي حروفًا أو أرقامًا عشرية في ترميز ASCII وأنّ التسلسل ليس فارغًا، ويعيد القيمة False فيما عدا ذلك. يتضمّن التسلسل الثنائي التالي جميع قيم البايتات التي تمثل الحروف في ترميز ASCII: b'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ' ويتضمّن التسلسل الثنائي التالي جميع قيم البايتات التي تمثل الأعداد العشرية ...

يعيد التابع from_bytes()‎ العدد الصحيح الذي تمثّله مصفوفة البايتات الممرّرة إلى الدالة. البنية العامة x.from_bytes() المعاملات bytes يجب أن يكون هذا الوسيط كائنًا شبيهًا بالبايتات أو كائنًا يمكن المرور على عناصره (iterable) وينتج البايتات. bytesorder يحدد هذا الوسيط ترتيب البايتات المستخدمة لتمثيل العدد الصحيح. يأخذ هذا المعامل القيمة "big" ويصبح البايت الأكثر أهمّية في بداية مصفوفة البايتات، ويأخذ القيمة "little" فيصبح البايت الأكثر أهمّية في نهاية مصفوفة البايتات. وللحصول على الترتيب المعتمد في النظام المضيف يمكن استخدام sys.byteorder كقيمة لهذا ...

يُحدّث التابع المجموعة الأصلية بعد دمج عناصرها مع جميع عناصر المجموعة أو المجموعات الأخرى الممررة إلى التابع. يؤدي العامل (=|) الوظيفة نفسها عند استخدامه مع المجموعات. البنية العامة update(*others) المعاملات ‎*others المجموعة أو المجموعات المراد دمجها مع المجموعة الأصلية. القيمة المعادة يحدّث التابع المجموعة الأصلية بعد أن تدمج عناصرها مع عناصر المجموعة أو المجموعات الممرّرة إلى التابع. أمثلة يبين المثال التالي النتائج المعادة من تطبيق التابع على مجموعات متنوعة: >>> s = {1, 2, 3, 4, 5} >>> t = {6, ...

يعيد التابع عدد مرات ظهور القيمة المعطاة في المصفوفة. البنية العامة ‎array.count(x) المعاملات x القيمة المراد معرفة عدد مرات ظهورها في المصفوفة. القيمة المعادة يعيد التابع عدد مرات ظهور القيمة المعطاة في المصفوفة. أمثلة يبين المثال التالي آلية عمل التابع: >>> import array >>> a1 = array.array('l', [1, 1, 3, 5, 5, 5, 6]) >>> a1.count(1) 2 >>> a1.count(5) 3 >>> a1.count(2) 0 انظر أيضًا التابع array.index()‎: يعيد التابع موقع أول ظهور للقيمة المعطاة في المصفوفة. مصادر صفحة Efficient arrays of numeric values في توثيق بايثون الرسمي. ...

يحلّل التابع النموذج النصي المعطى (والذي يُفترض أن يكون بصيغة CSV) ويعيد القيمة True إن كان السطر الأول في الملف عبارة عن سلسلة من ترويسات الأعمدة. البنية العامة has_header(sample) القيمة المعادة يعيد القيمة True إن كان السطر الأول في الملف عبارة عن سلسلة من ترويسات الأعمدة. مصادر صفحة CSV File Reading and Writing في توثيق بايثون الرسمي.

يتحقق التابع من وجود تسلسل فرعي في نهاية البيانات الثنائية الأصلية. البنية العامة bytes.endswith(suffix[, start[, end]]) المعاملات suffix التسلسل الذي يختبر التابع وجوده في نهاية البيانات الثنائية. start الموقع الذي يبدأ منه التابع عملية الاختبار ضمن البيانات الثنائية. end الموقع الذي ينهي فيه التابع عملية المقارنة ضمن البيانات الثنائية. القيمة المعادة يعيد التابع endswith()‎ القيمة True إن كانت البيانات الثنائية تنتهي بالقيمة الممرّرة إلى المعامل suffix، ويعيد القيمة False فيما عدا ذلك، ويمكن للمعامل suffix أن يكون أي كائن شبيه ...

يعيد التابع القيمة الثابتة لاسم المنطقة الزمنية والتي جري تحديدها عند بناء نسخة الصنف timezone. البنية العامة ‎timezone.tzname(dt) المعاملات dt كائن datetime المراد معرفة اسم المنطقة الزمنية الخاصة به. القيمة المعادة يعيد التابع القيمة الثابتة والتي يجري تحديدها عند بناء نسخة الصنف timezone. في حال عدم تحديد قيمة للمعامل name في الدالة البانية لهذا الصنف، فإن الاسم الذي يعيده التابع tzname(dt)‎ يُولّد من قيمة الإزاحة عن التوقيت العالمي المنسّق وبالطريقة التالية: إن كان المعامل offset يحمل القيمة timedelta(0)‎، فإنّ الاسم ...

يحوّل التابع جميع الحروف بترميز ASCII في التسلسل الثنائي إلى حروف صغيرة. البنية العامة bytes.lower() القيمة المعادة يعيد التابع نسخة من التسلسل الثنائي بعد تحويل جميع الحروف بترميز ASCII إلى حروف صغيرة. الحروف الصغيرة في ترميز ASCII هي قيم البايتات التي تقع ضمن التسلسل: ‎b'abcdefghijklmnopqrstuvwxyz'‎. أما الحروف الكبيرة في ترميز ASCII هي قيم البايتات التي تقع ضمن التسلسل: ‎b'ABCDEFGHIJKLMNOPQRSTUVWXYZ'‎. أمثلة يبين المثال التالي النتائج المعادة من استخدام التابع: >>> b = b"Hsoub" >>> b.lower() b'hsoub' >>> b = b"HSOUB WIKI" >>> b.lower() b'hsoub wiki' انظر ...

يضيف التابع العنصر المعطى إلى الجانب الأيسر من كائن deque. البنية العامة d.‎appendleft(x) المعاملات x العنصر المراد إضافته إلى الجانب الأيسر من كائن deque. أمثلة يبين المثال التالي آلية عمل التابع: >>> from collections import deque >>> d = deque('ghi') >>> d.appendleft('f') >>> d deque(['f', 'g', 'h', 'i']) انظر أيضًا التابع append()‎:  :يضيف التابع العنصر المعطى إلى الجانب الأيمن من كائن deque. مصادر قسم deque Objects في صفحة Container Datatypes في توثيق بايثون الرسمي.

يعيد التابع تقويم السنة المعطاة على هيئة صفحة HTML كاملة. البنية العامة formatyearpage(theyear, width=3, css='calendar.css', encoding=None) المعاملات theyear السنة المطلوبة. width يحدّد المعامل (والذي يأخذ القيمة الافتراضية 3) عدد الأشهر في كل صفّ من صفوف الجدول المعاد. css يحدّد هذا المعامل اسم ملف الأنماط التشعبية CSS الذي سيُستخدم مع صفحة HTML المعادة. يمكن تمرير القيمة None إلى هذا المعامل في حال عدم الرغبة في استخدام أي أنماط تشعبية. encoding يحدّد هذا المعامل الترميز المستخدم في صفحة HTML المعادة، ويأخذ هذا ...

يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، بالاعتماد على تقويم ISO. البنية العامة ‎date.isoweekday() القيمة المعادة يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، حيث يأخذ يوم الاثنين الرقم 1 ويوم الأحد الرقم 7، وذلك بالاعتماد على تقويم ISO. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import date >>> d = date(2018, 6, 26) >>> d.isoweekday() 2 انظر أيضًا التابع date.isocalendar()‎: يعيد التابع صفًّا يضمّ ثلاثة عناصر هي (ISO year, ISO week number, ISO weekday). التابع date.isoformat()‎: ...

يعيد التابع قائمة بالأسابيع في الشهر المعطى في السنة المعطاة على هيئة قوائم تضمّ أرقام الأيام السبعة. البنية العامة monthdayscalendar(year, month) المعاملات year السنة المطلوبة. month الشهر المطلوب (من 0 إلى 12). القيمة المعادة يعيد التابع قائمة بالأسابيع في الشهر month في السنة year كأسابيع كاملة. تكون الأسابيع على هيئة قوائم مكوّنة من سبعة صفوف تضمّ بدورها أرقام الأيام وأرقام أيام الأسبوع. أمثلة يبين المثال التالي آلية عمل التابع: >>> from calendar import Calendar >>> cal = Calendar() >>> for c in ...

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

يعيد هذا التابع موقع نهاية السلسلة الفرعية التي طوبقت بواسطة المجموعة الممرّرة. البنية العامة match.end([group]) المعاملات group المجموعة التي سيستخدمها التابع لمطابقة السلسلة النصية معها. يأخذ المعامل group القيمة الافتراضية 0 (أي أن التطابق حصل في السلسلة النصية الفرعية بأكملها). القيمة المعادة يعيد التابع موقع بداية السلسلة الفرعية التي طوبقت بواسطة المجموعة الممرّرة. ويعيد التابع القيمة ‎-1 إن كانت المجموعة موجودة ولكنّها لا تساهم في حالة التطابق. لو فرضنا وجود كائن تطابق m ومجموعة g تساهم في حالة التطابق، فإن ...

ينهي التابع عملية الضغط، ويعيد كائن bytes يتضمّن البيانات المخزّنة في الذواكر الداخلية. البنية العامة flush() لا يمكن ضغط البيانات بعد استدعاء هذا التابع. مصادر صفحة Compression using the LZMA algorithm في توثيق بايثون الرسمي.

يعيد هذا التابع الساكن جدول تحويل (translation table) يمكن استخدامه بواسطة التابع bytes.translate()‎. البنية العامة str.maketrans(x[, y[, z]]) المعاملات from كائن شبيه بالبايتات (bytes-like object) يتضمّن الحروف التي ستربطها الدالة بحروف المعامل to. to كائن شبيه بالبايتات يتضمن الحروف التي ستربط بها الدالة حروف المعامل from. ملاحظة: يجب أن يمتلك المعاملان الطول نفسه، ويجب أن يكون المعاملان كائنين شبيهين بالبايتات. ملاحظة: هذه الدالة موجودة في الإصدار 3.1 وما بعده من بايثون. القيمة المعادة يعيد التابع جدول تحويل يمكن استخدامه بواسطة ...

يعيد التابع as_integer_ratio()‎ زوجًا من الأعداد الصحيحة التي تكون نسبتها مساوية للعدد العشري تمامًا، ويكون المقام في هذه النسبة موجبًا. البنية العامة x.as_integer_ratio() يطلق التابع خطأً من نوع OverflowError عند استخدام قيم ما لا نهاية، والخطأ ValueError عند استخدام قيم NaN. أمثلة يبيّن المثال التالي طريقة استخدام التابع as_integer_ratio()‎ والقيم التي يعيدها: >>> f = 4.0 >>> f.as_integer_ratio() (4, 1) >>> f = 1.5 >>> f.as_integer_ratio() (3, 2) >>> f = 1.2 >>> f.as_integer_ratio() (5404319552844595, 4503599627370496) انظر أيضًا الأعداد الصحيحة في بايثون. الأعداد العشرية في بايثون. التابع float.is_integer()‎: اختبار ...

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

يؤدي هذا التابع نفس وظيفة التابع bytes.find()‎ ولكنّه يطلق الخطأ ValueError إن لم يعثر على التسلسل الفرعي. البنية العامة bytes.index(sub[, start[, end]]) المعاملات sub التسلسل الفرعي المراد معرفة موقعه، ويمكن أن يكون أيّ كائن شبيه بالبايتات (bytes-like objects) أو عددًا صحيحًا من 0 إلى 255. start الموقع الذي يبدأ منه التابع عملية البحث ضمن البيانات الثنائية. end الموقع الذي ينهي فيه التابع عملية البحث ضمن البيانات الثنائية. يسلك هذان المعاملان نفس السلوك المتّبع في عملية اقتطاع السلاسل النصية slicing. القيمة ...

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

يعيد التابع center()‎ البيانات الثنائية مزاحة نحو الوسط ضمن تسلسل يحمل طولًا يحدّده المستخدم. البنية العامة bytes.center(width[, fillbyte]) المعاملات width يحدّد هذا المعامل طول السلسلة المعادة. fillbytes يحدّد هذا المعامل البايتات التي سيستخدمها التابع لإجراء عملية الإزاحة، ويأخذ هذا المعامل قيمة افتراضية هي المسافة البيضاء في ترميز ASCII.  القيمة المعادة يعيد التابع التسلسل الأصلي مزاحًا نحو الوسط ضمن تسلسل ذي عرض محدّد، وتزاح البيانات الثنائية باستخدام البايتات التي يحدّدها المستخدم. إذا كانت القيمة المحدّدة للمعامل width أقل من أو تساوي القيمة ...

يضيف التابع الموجّه المعطى كموجّه أب. البنية العامة BaseHandler.add_parent(director) ‎المعاملات director الموجه المراد إضافته. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

يعيد التابع العناصر الموجودة في المجموعة الأصلية والمجموعة الأخرى الممررة إلى التابع ولكن ليس في كليهما. يؤدي العامل (^) الوظيفة نفسها عند استخدامه مع المجموعات. البنية العامة symmetric_difference(other) المعاملات other المجموعة التي سيبحث التابع فيها عن العناصر. القيمة المعادة يعيد التابع العناصر الموجودة في المجموعة الأصلية والمجموعة الأخرى الممررة إلى التابع ولكن ليس في كليهما. إن لم يفلح التابع في العثور على العناصر المطلوبة فسيعيد مجموعة فارغة. أمثلة يبين المثال التالي النتائج المعادة من تطبيق التابع على مجموعات متنوعة: >>> ...

يفتح التابع عنوان URL الكامل المعطى باستخدام البروتوكول المناسب. يهيّئ هذا التابع الذاكرة المخبئية ومعلومات الوسيط، ثم يستدعي تابع الفتح الملائم مع وسائط الإدخال الخاصة به. إن لم يتمكن التابع من التعرّف على المخطّط يُستدعى التابع open_unknown()‎. البنية العامة URLopener.open(fullurl, data=None) ‎المعاملات ‎data يحمل المعامل data المعنى نفسه لنظيره في الدالة urlopen()‎. القيمة المعادة يعيد التابع كائن urllib.response.addinfourl. أمثلة يقرأ المثال التالي أول 300 بايت من موقع Python: >>> from urllib import request >>> opener = request.URLopener() >>> result = opener.open("https://www.python.org") >>> print(result.read(300)) b'<!doctype ...

يمثّل كائن TarInfo عضوًا واحدًا في كائن TarFile. يحفظ هذا الكائن جميع الخصائص المطلوبة في الملف (مثل نوع الملف، وحجمه، ووقت التعديل، والأذونات، ومالك الملف وغيرها)، إلى جانب أنّه يقدّم بعض التوابع المفيدة لتحديد نوع الملف، ولا يحتوي هذا الكائن على بيانات الملف. تعيد التوابع getmember()‎ و getmembers()‎ و gettarinfo()‎ كائنات TarInfo. البنية العامة الدالة البانية للصنف TarInfo: class tarfile.TarInfo(name="") خصائص كائنات TarInfo يمتلك كائن TarInfo الخصائص العامة التالية: TarInfo.name اسم عضو الأرشيف. TarInfo.size الحجم بالبايتات. TarInfo.mtime وقت آخر تعديل. ...

يعيد التابع سلسلة نصية تمثّل التاريخ بصيغة ISO 8601. البنية العامة isoformat(sep='T', timespec='auto') المعاملات sep معامل اختياري يأخذ القيمة الافتراضية 'T' ويمثّل فاصلًا يتكوّن من حرف واحد يوضع بين جزئي الوقت والتاريخ في النتيجة المعادة. timespec يحدّد المعامل الاختياري timespec عدد المكوّنات الإضافية التي سيتضمّنها كائن الوقت (القيمة الافتراضية هي 'auto')، ويمكن للمكونات أن تكون واحدة ممّا يلي: 'auto': مشابه للمكون 'second' إن كانت أجزاء الثانية مساوية للصفر، وإلا فإنّه مشابه للمكوّن 'microseconds'. 'hours': تضمين الساعة بهيئة رقمين HH. 'minutes': ...

يتحقق التابع من وجود الخيار المعطى في القسم المحدّد. البنية العامة has_option(section, option) ‎المعاملات ‎section القسم الذي سيبحث فيه التابع عن الخيار المعطى. option الخيار الذي سيبحث عنه التابع. القيمة المعادة إن كان القسم المعطى موجودًا ويتضمّن الخيار المعطى فإنّ التابع يعيد القيمة True، ويعيد القيمة False فيما عدا ذلك. إن كان القسم المحدّد هو None أو سلسلة نصية فارغة، فإنّ التابع يفترض بأنّه القسم DEFAULT. أمثلة لنفرض أن لدينا ملف الإعدادات التالي: [DEFAULT] ServerAliveInterval = 45 Compression = yes CompressionLevel = 9 ForwardX11 ...

يحذف هذا التابع جميع عناصر القائمة. البنية العامة l.clear() القيمة المعادة يعيد هذا التابع القيمة None. أمثلة يبين المثال التالي كيفية استخدام هذا التابع: >>> fruits = ['orange', 'apple', 'pear', 'banana', 'kiwi', 'apple', 'banana'] >>> fruits.clear() >>> fruits [] انظر أيضًا القوائم في بايثون. التابع list.sort()‎: فرز القائمة في مكانها وذلك بإجراء مقارنة بين عناصر القائمة بواسطة العامل ‎<‎ فقط. التابع list.append()‎: إضافة عنصر إلى نهاية القائمة. التابع list.extend()‎: إضافة مجموعة من العناصر إلى نهاية القائمة. التابع list.insert()‎: إضافة عنصر إلى القائمة في الموقع ...

يكتب التابع صفًّا مع أسماء الحقول (كما هو محدّد في الدالة البانية). ملاحظة: هذا التابع جديد في الإصدار 3.2. البنية العامة writeheader() ‎مصادر صفحة CSV File Reading and Writing في توثيق بايثون الرسمي.

يعيد هذا التابع عدد مرات ظهور تسلسل فرعي ضمن كائن bytes. البنية العامة bytes.count(sub[, start[, end]]) المعاملات sub التسلسل الفرعي المراد معرفة عدد مرات ظهوره ضمن كائن bytes. يمكن للتسلسل الفرعي أن يكون أيّ كائن شبيه بالبايتات (bytes-like object). ملاحظة: في الإصدار 3.3 من بايثون، أصبح بالإمكان استخدام الأعداد الصحيحة من 0 إلى 255 كقيمة لهذا المعامل. start معامل اختياري، يحدد الموقع الذي يبدأ منه التابع عملية البحث ضمن كائن bytes. end معامل اختياري، يحدد الموقع الذي ينهي فيه التابع ...

يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق 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()‎: التحقق ...

هذا التابع غير معرّف في الصنف 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]) >>> ...

يعيد التابع find()‎ أدنى قيمة للفهرس في السلسلة النصية والذي تكون السلسلة الفرعية موجودة فيه ضمن الجزء المقتطع من السلسلة. البنية العامة x.find() المعاملات sub السلسلة الفرعية المراد معرفة موقعها. start الموقع الذي يبدأ منه التابع عملية البحث ضمن السلسلة الأصلية. end الموقع الذي ينهي فيه التابع عملية البحث ضمن السلسلة الأصلية. يسلك هذان المعاملان نفس السلوك المتّبع في عملية اقتطاع السلاسل النصية slicing. القيمة المعادة يعيد التابع أدنى قيمة للفهرس في السلسلة النصية حيث تكون السلسلة الفرعية sub موجودة ...

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

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

يستدعي هذا التابعُ التابعَ 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 ...

ينشئ تابع الصنف هذا كائن 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 في توثيق بايثون الرسمي.

يحذف التابع البايتات المحدّدة من نهاية التسلسل. البنية العامة 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 في ...

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

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

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

يطلق هذا التابع افتراضيًا الاستثناء 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): ... ...

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

يعيد التابع join()‎ كائن البياتات أو كائن مصفوفة البايتات الناتج عن ربط البيانات الثنائية التابعة لكائن قابل للتكرار (iterable). البنية العامة str.join(iterable) المعاملات iterable كائن قابل للتكرار مثل الصفوف، والقواميس، والقوائم، والمجموعات. القيمة المعادة يعيد التابع join()‎ كائن البياتات أو كائن مصفوفة البايتات الناتج عن ربط البيانات الثنائية التابعة لكائن قابل للتكرار (iterable). يطلق التابع الخطأ TypeError إن تضمن المعامل iterable أي قيمة ليست شبيهة بالبايتات (bytes-like object)، إضافة إلى السلاسل النصية. أمثلة يبين المثال التالي القيم المعادة من تطبيق ...

يعيد التابع سلسلة نصية تمثّل التاريخ بصيغة 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 ...

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

يحذف التابع الحروف التي يحدّدها المستخدم من بداية السلسلة النصية. البنية العامة x.lstrip() المعاملات chars سلسلة نصية تحدّد مجموعة الحروف المراد حذفها من السلسلة النصية الهدف. في حال عدم تمرير هذا المعامل أو تمرير القيمة None، تحذف الدالة المسافات البيضاء من بداية السلسلة النصية. يحذف التابع أي مزيج من الحروف الموجودة في chars. القيمة المعادة يعيد التابع نسخةً من السلسلة النصية بعد حذف الحروف التي يحدّدها المستخدم من بداية السلسلة النصية. أمثلة يوضح المثال التالي النتائج المعادة من تطبيق هذا ...

هذا التابع من التوابع غير المعيارية والذي يسهل عملية تنفيذ جمل SQL متعددة دفعة واحدة. ينفّذ هذا التابع جملة COMMIT في البداية، ثم ينفّذ بعدها شيفرة SQL المعطاة في المعاملات. البنية العامة executescript(sql_script) ‎المعاملات sql_script يمكن لهذا المعامل أن يكون نسخة من الكائن str. أمثلة يبين المثال التالي آلية عمل التابع: import sqlite3 con = sqlite3.connect(":memory:") cur = con.cursor() cur.executescript(""" create table person( firstname, lastname, ...

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

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

حذف جميع العناصر من كائن 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 في صفحة ...

يحمل هذا التابع إحدى ملحقات 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 {}", ...

يعيد التابع التاريخ والوقت الموافقين لسلسلة التاريخ النصية والمنسّقة بالصيغة التي تنشأ من استخدام التابع 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()‎. ملاحظة: ...