نتائج البحث

هذا التابع غير معرّف في الصنف BaseHandler، ولكن يجب على الأصناف المتفرّعة منه أن تعرّف هذا التابع إن كان المطلوب إجراء معالجة بعدية للطلبات الخاصّة بالبروتكول المعطى. يُستدعى هذا التابع، في حال استخدامه، من قبل كائن OpenerDirector الأب. يجب أن تستخدم القيمة المعادة نفس الواجهة المستخدمة من قبل القيمة المعادة في الدالة urlopen()‎. البنية العامة BaseHandler.protocol_request(req) المعاملات req سيكون كائن Request. response سيكون كائنًا يستخدم نفس الواجهة المستخدمة من قبل القيمة المعادة من الدالة urlopen()‎. مصادر صفحة Extensible library for ...

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

يعيد هذا التابع قيمة واحدة دائمًا ترتبط بالحقل الذي يحمل الاسم المعطى، ويعيد التابع القيمة الأولى فقط في حال إرسال عدد من القيم التي تحمل هذا الاسم. يجدر الانتباه هنا إلى أنّ ترتيب العناصر قد يختلف باختلاف المتصفّح ولا يجدر الاعتماد عليه. ملاحظة: تحدّد بعض الإصدارات الحديثة من معايير HTML الترتيب المتّبع في تزويد قيم الحقول، ولكن التحقّق ممّا إذا كان الطلب قادمًا من متصفّح يعتمد هذه المعايير أم لا، أو أنّ الطلب قادم من متصفّح أصلًا أمر صعبٌ وقد ...

يقرأ التابع تمثيل كائن مسلسل من كائن الملف المفتوح في الدالة البانية للصنف، ويعيد هيكل الكائن المعاد بناؤها والموصوفة في هذا الملف، ويتجاهل التابع البايتات التي تسبق تمثيل الكائن المسَلسَل. البنية العامة load() ‎القيمة المعادة يعيد التابع هيكل الكائن المعاد بناؤها والموصوفة في هذا الملف، ويتجاهل التابع البايتات التي تسبق تمثيل الكائن المسَلسَل. أمثلة يبين المثال التالي طريقة عمل التابع (راجع المثال في صفحة التابع Pickler.dump()‎ للاطلاع على الكائن المسَلسَل في الملف file1.dat): >>> import pickle >>> f = open('file1.dat', 'rb') >>> ...

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

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

يستدعي هذا التابعُ التابعَ Cursor.executemany()‎ مع تمرير المعاملات المعطاة. البنية العامة executemany(sql[, parameters]) ‎المعاملات sql سلسلة نصية تتضمن جملة SQL المراد تنفيذها. القيمة المعادة هذا التابع هو طريقة مختصرة لإنشاء كائن مؤشر عن طريق استدعاء التابع cursor()‎، حيث يستدعي التابع executemany()‎ في كائن المؤشر مع تمرير المعاملات المعطاة، ثم يعيد كائن المؤشر. أمثلة يبين المثال التالي آلية عمل التابع: import sqlite3 conn = sqlite3.connect('example.db') purchases = [('2006-03-28', 'BUY', 'IBM', 1000, 45.00), ...

يحول التابع المصفوفة إلى قائمة عادية تتضمن نفس العناصر. البنية العامة ‎array.tolist() القيمة المعادة يعيد التابع قائمة تتضمن عناصر المصفوفة. أمثلة يبين المثال التالي آلية عمل التابع: >>> import array >>> a1 = array.array('u', 'Hello World') >>> a1.tolist() ['H', 'e', 'l', 'l', 'o', ' ', 'W', 'o', 'r', 'l', 'd'] انظر أيضًا التابع array.tobytes()‎: يحول التابع المصفوفة إلى مصفوفة من قيم الجهاز. التابع array.tofile()‎: يكتب التابع جميع العناصر (كقيم جهاز) في كائن الملف المعطى. التابع array.tounicode()‎: يحول التابع المصفوفة إلى سلسلة نصية بترميز ...

يعيد التابع التاريخ الموافق لسلسلة التاريخ النصية والمنسّقة بالصيغة التي تنشأ من استخدام التابع date.isoformat()‎. البنية العامة ‎date.fromisoformat(date_string) المعاملات date_string سلسلة نصية تتضمّن التاريخ المطلوب تحويله إلى كائن date، وتتبع السلسلة النصية الصيغة YYYY-MM-DD. القيمة المعادة كائن date يكون التاريخ فيه موافقًا للتاريخ المعطى في السلسلة النصية date_string. تنبيه: لا يفسّر هذا التابع جميع سلاسل المعيار ISO 8601، بل الهدف منه هو أداء الوظيفة المعاكسة للتابع date.isoformat()‎. ملاحظة: هذا التابع جديد في الإصدار 3.7 من اللغة. أمثلة يبين المثال التالي ...

يمكن استدعاء هذا التابع من خيط آخر لتجاهل أي استعلامات قد تكون قيد التنفيذ عبر الاتصال الحالي. سيتم تجاهل الاستعلام وسيتلقى صاحب الاستعلام استثناءً. البنية العامة interrupt() مصادر صفحة DB-API 2.0 interface for SQLite databases في توثيق بايثون الرسمي.

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

يتيح التابع الوصول إلى عضو في الأرشيف ككائن ثنائي شبيه بالملفات. البنية العامة ZipFile.open(name, mode='r', pwd=None, *, force_zip64=False) المعاملات ‎name اسم الملف المراد الوصول إليه ضمن الأرشيف أو كائن ZipInfo. mode إن توفّرت قيمة لهذا المعامل فيجب أن تكون 'r' (القيمة الافتراضية) أو 'w'. عند استخدام الوضع 'r' يكون الكائن الشبيه بالملفات (ZipExtFile) للقراءة فقط ويقدّم التوابع التالية: ‎read(), readline(), readlines(), seek(), tell(), __iter__(), __next__()‎. يمكن لهذه الكائنات أن تعمل بمعزل عن ZipFile. إن أخذ المعامل mode القيمة 'w' فإنّ ...

يعيد التابع البايتات التابعة للملف المعطى في الأرشيف. البنية العامة ZipFile.read(name, pwd=None) ‎المعاملات ‎name اسم الملف في الأرشيف، أو كائن ZipInfo. يجب أن يكون الأرشيف مفتوحًا للقراءة أو للإلحاق. pwd كلمة المرور المستخدمة للملفات المعماة، وإن جرى تعيين قيمة لهذا المعامل فإنّها ستعيد تعريف override كلمة المرور الافتراضية المعيّنة بواسطة التابع setpassword()‎. القيمة المعادة يعيد التابع البايتات التابعة للملف المعطى في الأرشيف. يؤدي استدعاء التابع read()‎ على كائن ZipFile يستخدم طريقة ضغط غير الطريقة ZIP_STORED أو ZIP_DEFLATED أو ZIP_BZIP2 أو ...

يعيد هذا التابع الساكن جدول تحويل يمكن استخدامه بواسطة التابع str.translate()‎. البنية العامة x.maketrans() المعاملات في حال تمرير معامل واحد فإنّه يجب أن يكون قاموسًا يربط أرقام الحروف في الترميز الموحد (Unicode ordinals) وهي أعداد صحيحة أو الحروف (سلاسل نصية ذات حرف واحد) بأرقام الحروف في الترميز الموحد أو سلاسل نصية (ذات عدد غير محدد من الحروف) أو None. بعد ذلك يجري تحويل مفاتيح الحروف إلى أرقام الحروف في الترميز الموحد Unicode. في حال استخدام معاملين فيجب حينئذ أن يكونا ...

يعيد التابع مجموعة فرعية واحدة أو أكثر من المجموعات الموجودة في كائن التطابق. البنية العامة match.group([group1, ...]) المعاملات group1 يأخذ هذا التابع معاملًا واحدًا أو أكثر، وهو عبارة عن عدد صحيح يمثّل رقم المجموعة المراد معرفة قيمتها. القيمة المعادة يعيد التابع مجموعة فرعية واحدة أو أكثر من مجموعات التطابق. إن أخذ التابع معاملًا واحدًا، فإنّ النتيجة تكون سلسلة نصية مفردة، وإن كان هناك عدد من المعاملات، فإنّ النتيجة تكون صفًّا يحتوي على عناصر بعدد المعاملات الممررة. أما إن لم يُمرّر ...

يمثّل كائن timedelta المدّة الزمنية التي تفصل بين تاريخين أو وقتين معيّنين. البنية العامة ‎datetime.timedelta(days=0, seconds=0, microseconds=0, milliseconds=0, minutes=0, hours=0, weeks=0) المعاملات جميع المعاملات في عبارة إنشاء الصنف timedelta اختيارية، وقيمتها الافتراضية تساوي 0، ويمكن أن تكون أعدادًا صحيحة أو ذات فاصلة عائمة، ويمكن كذلك أن تكون موجبة أو سالبة. تُخزّن قيم المعاملات days و seconds و microseconds داخليًا، أما بقية المعاملات فتُحوّل إلى الوحدات التالية: تحوّل المللي ثانية إلى 1000 مايكرو ثانية. تحوّل الدقيقة إلى 60 ثانية. تحوّل الساعة ...

يعيد التابع قيمة المفتاح المحدد في المعاملات إن كان موجودًا. أما إن كان المفتاح غير موجود في القاموس فإنّ التابع يضيف المفتاح مع القيمة المحدّدة له إلى القاموس. البنية العامة dict.setdefault(key[, default]) المعاملات key المفتاح الذي سيبحث عنه التابع في القاموس. default القيمة التي ستسند إلى المفتاح الذي سيضاف إلى القاموس، في حال عدم عثور التابع على المفتاح key. القيمة المعادة يعيد التابع قيمة المفتاح المحدد في المعاملات إن كان موجودًا، وتعيد القيمة None إن كان المفتاح المحدد غير موجود ...

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

يتحقق هذا التابع من وجود سلسلة نصية فرعية في نهاية السلسلة النصية الأصلية. البنية العامة x.endswith() المعاملات suffix السلسلة الفرعية التي يختبر التابع وجودها في نهاية السلسلة الأصلية. start الموقع الذي يبدأ منه التابع عملية الاختبار ضمن السلسلة الأصلية. end الموقع الذي ينهي فيه التابع عملية المقارنة ضمن السلسلة الأصلية. القيمة المعادة يعيد التابع endswith()‎ القيمة True إن كانت السلسلة النصية تنتهي بالقيمة الممرّرة إلى المعامل suffix، ويعيد القيمة False فيما عدا ذلك، ويمكن للمعامل suffix أن يكون صفًّا tuple ...

يمدّد الجانب الأيسر من كائن deque بإضافة العناصر المعطاة. البنية العامة d.extendleft(iterable) المعاملات iterable كائن مكرِّر تضاف عناصره إلى كائن deque. القيمة المعادة يعيد التابع كائن deque جديد يمثّل نسخة سطحية عن كائن dequeالأصلي. أمثلة يبين المثال التالي آلية عمل التابع. >>> from collections import deque >>> d = deque('ghi') >>> d.extendleft('def') >>> d deque(['f', 'e', 'd', 'g', 'h', 'i']) انظر أيضًا التابع extend()‎:  :يمدّد الجانب الأيمن من كائن deque بإضافة العناصر المعطاة. التابع append()‎:  :يضيف التابع العنصر المعطى إلى الجانب الأيمن من كائن ...

يعيد التابع نسخة من عنوان URL الأصلي بعد إعادة دمجها. البنية العامة urllib.parse.SplitResult.geturl()‎ القيمة المعادة يعيد التابع نسخة من عنوان URL الأصلي بعد إعادة دمجها. قد تختلف النسخة المعادة عن النسخة الأصلية حيث يمكن أن تحوّل حروف نظام العنونة إلى حروف صغيرة وأن يتخلص التابع من المكوّنات الفارغة. يحذف التابع -على وجه التحديد- المعاملات وسلاسل الاستعلام ومحدّدات القطع الفارغة، أما النتائج المعادة من التابع urldefrag()‎ فتُحذف منها محدّدات القطع الفارغة فقط، وتُجرى جميع التعديلات الملحوظة على عنوان URL المعاد من ...

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

يتحقّق هذا التابع من أنّ السلسلة النصية تبدأ بالقيمة التي يحدّدها المستخدم. البنية العامة x.startswith() المعاملات prefix السلسل النصية التي سيبحث عنها التابع. يمكن لهذا المعامل أن يكون صفًّا من السلاسل النصية. start الموقع الذي يبدأ منه التابع عملية الاختبار ضمن السلسلة الأصلية. end الموقع الذي ينهي فيه التابع عملية المقارنة ضمن السلسلة الأصلية. القيمة المعادة يعيد التابع startswith()‎ القيمة True إن كانت السلسلة النصية تبدأ بالقيمة الممرّرة إلى المعامل prefix، ويعيد القيمة False فيما عدا ذلك. أمثلة أمثلة نموذجية ...

يعيد التابع encode()‎ نسخة مرمّزة من السلسلة النصية على هيئة بايتات. البنية العامة x.encode() المعاملات encoding يحدّد هذا المعامل الترميز الذي سيستخدمه التابع في عمله، ويأخذ القيمة الافتراضية 'utf-8'. وللاطلاع على قائمة بالترميزات المتاحة راجع قسم الترميزات القياسية. errors يحدّد المعامل error الطريقة المطلوبة للتعامل مع الأخطاء. يأخذ هذا المعامل القيمة الافتراضية 'strict' والتي تعني أنّه في حال حدوث أخطاء أثناء عملية الترميز فستطلق الدالة الخطأ UnicodeError. يمكن أن يأخذ هذا المعامل قيمًا أخرى هي ‎'ignore'، 'replace'، 'xmlcharrefreplace'، 'backslashreplace'‎ وأي ...

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

يعالج التابع استجابات HTTP التي تتضمن أخطاءً. البنية العامة HTTPErrorProcessor.http_response(request, response) القيمة المعادة يعاد كائن الاستجابة مباشرة في الأخطاء ذات الرمز 200. أما في حال ظهور الأخطاء الأخرى فإنّ العمل ينتقل إلى توابع المعالجة protocol_error_code()‎ بواسطة التابع OpenerDirector.error()‎. ويُطلق الصنف المعالج HTTPDefaultErrorHandler استثناء من نوع HTTPError في حال عدم معالجة الخطأ من قبل أيّ صنفٍ معالج. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

يعيد التابع الوقت والتاريخ حسب التوقيت المحلّي، مع إعطاء المعامل tzinfo القيمة None. البنية العامة datetime.today() القيمة المعادة يعيد التابع الوقت والتاريخ حسب التوقيت المحلّي، مع إعطاء المعامل tzinfo القيمة None. هذا التابع يكافئ في عمله عمل التابع datetime.fromtimestamp(time.time())‎. أمثلة يبين المثال التالي القيمة المعادة من استخدام التابع: >>> from datetime import datetime >>> today = datetime.today() >>> print(today) 2018-07-05 17:45:50.451453 انظر أيضًا التابع datetime.fromtimestamp()‎ : يعيد هذا التابع التاريخ المحلي المرتبط بالختم الزمني ذي الصيغة POSIX. التابع datetime.fromordinal()‎: يعيد هذا التابع التاريخ والوقت بحسب ...

يعيد التابع الوقت التاريخ الحاليين حسب الإعدادات المحليّة. البنية العامة ‎datetime.now(tz=None) المعاملات tz إن أخذ المعامل الاختياري tz القيمة None أو لم تحدّد له أيّة قيمة، فإنّ التابع يصبح مشابهًا للتابع today()‎، ولكن إن كان متوفّرًا فإنّه يقدّم دقّة تفوق تلك التي يمكن الحصول عليها باستخدام الختم الزمني الذي ينشئه التابع time.time()‎ (على سبيل المثال، يمكن ذلك في المنصّات التي تدعم الدالة gettimeofday()‎ في لغة C). إن لم يأخذ المعامل tz القيمة None، فإنّه يجب أن يكون نسخة من صنف ...

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

واجهة قابلة للتعديل لفتح عناوين URL مجهولة النوع. البنية العامة URLopener.open_unknown(fullurl, data=None) ‎المعاملات ‎data يحمل المعامل data المعنى نفسه لنظيره في الدالة urlopen()‎. القيمة المعادة يعيد التابع كائن urllib.response.addinfourl. انظر أيضًا الدالة URLopener.open()‎: يفتح التابع عنوان URL الكامل المعطى باستخدام البروتوكول المناسب. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

يعيد التابع مقدار التعديل لنظام التوقيت الصيفي (DST). البنية العامة ‎tzinfo.dst(dt) القيمة المعادة يعيد التابع مقدار التعديل لنظام التوقيت الصيفي (DST). يعيد التابع كائن timedelta يمثّل مقدار التعديل لنظام التوقيت الصيفي (DST)، ويعيد القيمة None إن لم تكن معلومات التوقيت الصيفي معروفة، ويعيد timedelta(0)‎ إن لم يكن التوقيت الصيفي مفعّلًا. أما لو كان التوقيت الصيفي مفعّلًا، فإنّ التابع يعيد كائن timedelta (راجع التابع utcoffset()‎ للمزيد من التفاصيل). يجب الانتباه إلى أنّ مقدار إزاحة التوقيت الصيفي - إن كان مطبّقًا - ...

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

يحذف هذا التابع البايتات المحدّدة من قبل المستخدم من نهاية وبداية التسلسل. البنية العامة bytes.strip([chars]) المعاملات chars تسلسل ثنائي يحدّد مجموعة البايتات التي سيحذفها التابع من التسلسل الثنائي الأصلي. في حال عدم تمرير هذا المعامل أو أخذه للقيمة None يحذف التابع المسافات البيضاء فقط. يحذف التابع أي مزيج من الحروف الموجودة في المعامل chars. القيمة المعادة يعيد التابع نسخة من التسلسل الثنائي بعد حذف البايتات المحدّدة من بدايته ونهايته. أمثلة يبين المثال التالي القيم المعادة من تطبيق التابع على تسلسلات ...

يضيف التابع قسمًا يحمل الاسم المعطى إلى نسخة الصنف RawConfigParser. البنية العامة add_section(section) المعاملات ‎section اسم القسم المراد إضافته إلى ملف الإعدادات. القيمة المعادة إن كان هناك صنف يحمل الاسم ذاته فإنّ التابع يطلق الاستثناء DuplicateSectionError. وإن كان الاسم المعطى هو اسم قسم الإعدادات الافتراضية فإنّ التابع يطلق الاستثناء ValueError. لا يجري التحقّق من نوع القسم الأمر الذي يسمح للمستخدم بإنشاء أسماء أقسام غير نصية، وهذا السلوك غير مدعوم وقد يتسبب في حدوث أخطاء داخلية. أمثلة يبين المثال التالي طريقة ...

يعيد التابع قائمة بجميع القيم المندرجة ضمن الترويسة المعطاة. البنية العامة get_all(name) ‎المعاملات ‎name اسم الترويسة التي سيعيد التابع قائمة القيم المندرجة ضمنها. القيمة المعادة تكون القيم في القائمة المعادة مرتّبة بنفس ترتيب ظهور الترويسات في قائمة الترويسات الأصلية، أو ترتيب إضافتها إلى نسخة الصنف، وقد تتضمن قيمًا مكرّرة. يؤدي حذف الحقول وإعادة إضافتها إلى إدراجها في نهاية القائمة. يعيد التابع قائمة فارغة إن لم يعثر على أي حقل يحمل الاسم المطلوب. مصادر قسم WSGI environment utilities في صفحة WSGI ...

يعيد التابع قائمة بأسماء الأعمدة. البنية العامة keys() القيمة المعادة يعيد التابع قائمة بأسماء الأعمدة، وتكون هذه القائمة العنصر الأول في كلّ صفّ tuple في قيمة الخاصية Cursor.description بعد إجراء الاستعلام مباشرة. ملاحظة: أضيف دعم عملية التقطيع في الإصدار 3.5 من اللغة. أمثلة لنفترض أنّنا هيّأنا جدولًا على النحو التالي: conn = sqlite3.connect(":memory:") c = conn.cursor() c.execute('''create table stocks (date text, trans text, symbol text, qty real, price real)''') c.execute("""insert into stocks values ('2006-01-05','BUY','RHAT',100,35.14)""") conn.commit() c.close() يمكننا ...

يحوّل هذا التابع أوائل الكلمات في السلسلة النصية إلى أحرف كبيرة (Title Case). البنية العامة s.title() القيمة المعادة يعيد التابع نسخة من السلسلة النصية تكون فيها أوائل الكلمات ذات أحرف كبيرة. أمثلة يوضح المثال التالي النتيجة المعادة من تطبيق هذا التابع على سلسلة نصية: >>> 'Hello world'.title() 'Hello World' توضيح تستخدم الدالة خوارزمية بسيطة لا تعتمد على أي لغة (language-independent)، حيث تعرّف الكلمة على أنّها مجموعة من الحروف المتتابعة. هذا التعريف صالح في معظم السياقات، ولكن في هذا التعريف تشكّل الفاصلة ...

يحذف هذا التابع البايتات المحدّدة من قبل المستخدم من نهاية وبداية التسلسل. البنية العامة bytes.strip([chars]) المعاملات chars تسلسل ثنائي يحدّد مجموعة البايتات التي سيحذفها التابع من التسلسل الثنائي الأصلي. في حال عدم تمرير هذا المعامل أو أخذه للقيمة None يحذف التابع المسافات البيضاء فقط. يحذف التابع أي مزيج من الحروف الموجودة في المعامل chars. القيمة المعادة يعيد التابع نسخة من التسلسل الثنائي بعد حذف البايتات المحدّدة من بدايته ونهايته. أمثلة يبين المثال التالي القيم المعادة من تطبيق التابع على تسلسلات ...

يعيد التابع العناصر المشتركة (التقاطع) بين المجموعة الأصلية وجميع عناصر المجموعة أو المجموعات الأخرى الممررة إلى التابع. يؤدي العامل (&) الوظيفة نفسها عند استخدامه مع المجموعات. البنية العامة intersection(*others) المعاملات ‎*others المجموعة التي سيبحث التابع فيها عن العناصر المشتركة مع المجموعة الأصلية. القيمة المعادة يعيد التابع مجموعة جديدة تضم العناصر المشتركة بين عناصر المجموعة الأصلية وعناصر المجموعة أو المجموعات الممرّرة إلى التابع. يعيد التابع مجموعة فارغة في حال عدم وجود عناصر مشتركة بين المجموعات. أمثلة يبين المثال التالي النتائج المعادة ...

يستورد التابع الوحدة المعطاة إذا اقتضت الحاجة ويعيد الكائن الذي يحمل الاسم المحدّد. تجدر الإشارة إلى أنّه وعلى خلاف ما يشير إليه اسم هذا التابع، فبالإمكان استخدام find_class()‎ للعثور على الدوال. يمكن للأصناف الفرعية أن تعيد تعريف override هذا التابع للتحكم بأنواع الكائنات المستوردة وطريقة تحميلها، وقد يساهم هذا في تقليل الأخطار الأمنية. راجع قسم تقييد المتغيرات العامة للمزيد من التفاصيل. البنية العامة find_class(module, name) ‎المعاملات module سلسلة نصية تتضمن اسم الوحدة التي يستوردها التابع. name سلسلة نصية تتضمن اسم ...

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

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

يعيد التابع موقع العنصر المعطى في كائن deque. البنية العامة d.‎index(x[, start[, stop]]) المعاملات x العنصر المراد إيجاد موقعه في كائن deque. === start و stop يمكن البحث عن موقع العنصر x بدءًا من الموقع start وانتهاءً بالموقع stop. القيمة المعادة يعيد التابع موقع العنصر المعطى في كائن deque. ويطلق التابع الخطأ ValueError في حال عدم العثور على العنصر المطلوب. أمثلة يبين المثال التالي آلية عمل التابع. >>> from collections import deque >>> d = deque('abcdefgh') >>> d deque(['a', 'b', 'c', 'd', 'e', ...

يعيد التابع العناصر غير المشتركة بين المجموعة الأصلية وجميع عناصر المجموعة أو المجموعات الأخرى الممررة إلى التابع. يؤدي العامل (-) الوظيفة نفسها عند استخدامه مع المجموعات. البنية العامة difference(*others) المعاملات ‎*others المجموعات التي ستبحث الدالة فيها عن العناصر غير المشتركة مع المجموعة الأصلية. القيمة المعادة يعيد التابع مجموعة جديدة تضم العناصر غير المشتركة بين عناصر المجموعة الأصلية وعناصر المجموعة أو المجموعات الممرّرة إلى التابع. يعيد التابع مجموعة فارغة في حال عدم وجود عناصر غير مشتركة بين المجموعات. أمثلة يبين المثال ...

يعيد التابع إرسال الطلب مع معلومات الاستيثاق، إن كانت متوفّرة. البنية العامة HTTPDigestAuthHandler.http_error_401(req, fp, code, msg, hdrs) مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

يحذف التابع العنصر الأول من المجموعة. البنية العامة pop() القيمة المعادة يعيد التابع العنصر المحذوف من المجموعة، ويطلق الخطأ KeyError إن كانت المجموعة فارغة. أمثلة أمثلة نموذجية عن استخدام هذا التابع: >>> s = {1, 2, 3, 4, 5} >>> s.pop() 1 >>> s.pop() 2 انظر أيضًا المجموعات في بايثون. التابع set.add()‎: إضافة عنصر واحد إلى المجموعة. التابع set.remove()‎: حذف عنصر واحد من المجموعة. التابع set.discard()‎: حذف عنصر واحد من المجموعة إن كان موجودًا فيها. التابع set.clear()‎: حذف جميع عناصر المجموعة. مصادر قسم pop ...

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

يجلب التابع الخيار المحدّد من القسم المعطى. البنية العامة get(section, option, *, raw=False, vars=None[, fallback]) ‎المعاملات ‎section اسم القسم الذي سيجلب التابع الخيار منه. option قيمة الخيار المراد جلبه. يبحث التابع عن قيمة المعامل option في vars (إن كان متوفّرًا) ثم في section ثم في DEFAULTSECT. raw يوسّع التابع جميع عمليات الاستيفاء التي تستخدم الرمز '%' في القيمة المعادة إلا إذا كان إذا أخذ المعامل raw القيمة True. vars معامل اختياري، يجب أن تكون قيمته قاموسًا. fallback في حال عدم ...

يؤدي استدعاء هذا التابع إلى استخدام الصفّ (user, passwd) علامات استيثاق رمزية authentication tokens عند إعطاء الاستيثاق للحقل المعطى و المعرفات الفوقية super-URI للمعرّفات المعطاة. البنية العامة HTTPPasswordMgr.add_password(realm, uri, user, passwd) المعاملات uri يمكن أن يكون معرّف URI مفرد، أو تسلسلًا من معرّفات URI. realm, user, passwd يجب أن تكون قيم هذه المعاملات سلاسل نصية. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

يحدّث التابع قيمة الراية is_authenticated لعنوان URI المعطى أو قائمة عناوين URI المعطاة. البنية العامة HTTPPasswordMgrWithPriorAuth.update_authenticated(self, uri, is_authenticated=False) مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

يعيد التابع قائمة بأسماء الأعضاء في ملف الأرشيف. البنية العامة ZipFile.namelist() القيمة المعادة يعيد التابع قائمة بأسماء الأعضاء في ملف الأرشيف. أمثلة يبين المثال التالي آلية عمل التابع: >>> import zipfile >>> zip = zipfile.ZipFile('files.zip') >>> zip.namelist() ['file1.txt', 'file2.html', 'file3.py'] انظر أيضًا التابع ZipFile.getinfo()‎: يعيد التابع كائن ZipFile مع معلومات حول عضو الأرشيف المعطى. التابع ZipFile.infolist()‎: يعيد التابع قائمة تتضمّن كائن ZipFile لكل عضو من أعضاء الأرشيف. مصادر صفحة Work with ZIP archives في توثيق بايثون الرسمي.

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

يطبع التابع جدولًا بمحتويات ملف الأرشيف إلى مخرجات النظام sys.stdout. البنية العامة ZipFile.printdir() ‎ القيمة المعادة يطبع التابع جدولًا بمحتويات ملف الأرشيف إلى مخرجات النظام sys.stdout. أمثلة يبين المثال التالي آلية عمل التابع: >>> import zipfile >>> zip = zipfile.ZipFile('files.zip') >>> zip.printdir() File Name ...

يطلق هذا التابع الاستثناء URLError. البنية العامة UnknownHandler.unknown_open() مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

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

يتحقّق التابع ممّا إذا كانت جميع الحروف في السلسلة النصية حروفًا كبيرة. البنية العامة x.isupper() القيمة المعادة يعيد التابع القيمة True إذا كانت جميع الحروف في السلسلة النصية حروفًا كبيرة، ويعيد القيمة False فيما عدا ذلك. أمثلة يبين المثال التالي القيم المعادة من تطبيق التابع على سلاسل نصية مختلفة: >>> s = "HSOUB" >>> s.isupper() True >>> s = "Hsoub" >>> s.isupper() False انظر أيضًا السلاسل النصية في بايثون. التابع str.capitalize()‎: إعادة نسخة من السلسلة النصية مع تحويل الحرف الأول إلى حرف كبير، والأحرف الباقية ...

يجلب التابع اسم المستخدم وكلمة المرور للحقل realm أو عنوان URI المعطيين. البنية العامة HTTPPasswordMgr.find_user_password(realm, authuri) المعاملات realm الحقل المطلوب. authuri عنوان URI المطلوب. القيمة المعادة يعيد التابع صفًّا يتضمّن اسم المستخدم وكلمة المرور المطابقة، ويعيد الصفّ (None, None) إن لم يعثر على اسم المستخدم أو كلمة المرور. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

يعيد التابع إرسال الطلب مع معلومات الاستيثاق، إن كانت متوفّرة. البنية العامة ProxyDigestAuthHandler.http_error_407(req, fp, code, msg, hdrs) مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

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

يضغط التابع البيانات المعطاة (كائن bytes) ويعيد كائن bytes يتضمّن البيانات المضغوطة لجزء من المدخلات على الأقل. البنية العامة compress(data) ‎المعاملات data البيانات المراد ضغطها. القيمة المعادة يمكن لبعض البيانات أن تُخزّن داخليًا buffered internally لاستخدامها في الاستدعاءات اللاحقة للدالة compress()‎ والتابع flush()‎. يجب أن تكون البيانات المعادة مترابطة مع المخرجات الناتجة عن الاستدعاءات السابقة للدالة compress()‎. مصادر صفحة Compression using the LZMA algorithm في توثيق بايثون الرسمي.

يتحقّق التابع ممّا إذا كانت أوائل الكلمات في السلسلة النصية حروفًا كبيرة (titlecased). البنية العامة x.istitle() القيمة المعادة يعيد التابع القيمة True إذا كانت أوائل الكلمات في السلسلة النصية حروفًا كبيرة، ويعيد القيمة False فيما عدا ذلك. أمثلة يبين المثال التالي النتائج المعادة من تطبيق التابع على سلاسل نصية مختلفة: >>> s = "Hsoub Academy" >>> s.istitle() True >>> s = "Hsoub academy" >>> s.istitle() False >>> s = "Python Programming Language" >>> s.istitle() True انظر أيضًا السلاسل النصية في بايثون. التابع str.capitalize()‎: إعادة نسخة من السلسلة النصية ...

يعالج التابع طلب الاستيثاق عن طريق الحصول على زوج اسم المستخدم/كلمة المرور، وإعادة الطلب مرة أخرى. البنية العامة AbstractDigestAuthHandler.http_error_auth_reqed(authreq, host, req, headers) المعاملات authreq يجب أن يكون اسم الترويسة حيث تكون المعلومات المتعلّقة بالحقل مضمّنة في الطلب. host يحدّد عنوان URL والمسار الذي ستُجرى فيه عملية الاستيثاق. req يجب أن يكون كائن Request (الذي فشل في عملية الاستيثاق). headers يجب أن يكون ترويسات الأخطاء. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

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

يفكّ التابع الضغط عن البيانات المعطاة، ويعيد كائن bytes يتضمّن البيانات مفكوكة الضغط والمرتبطة على الأقل بجزء من البيانات في السلسلة النصية string. البنية العامة Decompress.decompress(data, max_length=0) المعاملات data البيانات المراد فك الضغط عنها. max_length معامل اختياري. إن أخذ هذا المعامل قيمة غير صفرية فإنّ القيمة المعادة من التابع لن تتجاوز في طولها العدد المحدّد. وهذا يعني أنّه يمكن عدم معالجة جميع المدخلات المضغوطة، وستُحفظ البيانات غير المستهلكة في الخاصية unconsumed_tail. يجب تمرير سلسلة البايتات هذه إلى استدعاء لاحق للتابع ...

يعيد التابع الصنف time.struct_time كما تعيده الدالة time.localtime()‎. البنية العامة ‎datetime.timetuple() القيمة المعادة يعيد التابع الصنف time.struct_time. وهو عبارة عن كائن يتضمّن صفًّا مسمّىً named tuple. ويمكن الوصول إلى القيم عبر الفهرس index أو عبر اسم الخاصية، وكما هو موضح في الجدول التالي: الفهرس اسم الخاصية الوصف 0 tm_year السنة 1 tm_mon الشهر 2 tm_mday اليوم 3 tm_hour الساعة 4 tm_min الدقيقة 5 tm_sec الثانية 6 tm_wday عدد اليوم في الأسبوع 7 tm_yday عدد اليوم في السنة 8 tm_isdst التوقيت ...

يعيّن التابع كلمة المرور المعطاة ككلمة مرور الافتراضية لاستخراج الملفات المعمّاة من الأرشيف. البنية العامة ZipFile.setpassword(pwd) ‎المعاملات ‎pwd كائن bytes يحتوي كلمة المرور. القيمة المعادة يعيد التابع القيمة None. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import zipfile >>> zip = zipfile.ZipFile('files.zip') >>> zip.setpassword(b'1234') None مصادر صفحة Work with ZIP archives في توثيق بايثون الرسمي.

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

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

يطبع التابع جدولًا بمحتويات كائن TarFile إلى مخرجات النظام sys.stdout. البنية العامة TarFile.list(verbose=True, *, members=None) ‎المعاملات ‎verbose إن أخذ المعامل verbose القيمة False، فسيطبع التابع أسماء أعضاء الأرشيف فقط. أما إن أخذ القيمة True (وهي القيمة الافتراضية)، فستكون المخرجات الناتجة مشابهة للمخرجات الناتجة من الأمر ls -l في الصدفة. members معامل اختياري، يجب أن يكون -في حال إعطائه قيمة معينة- مجموعة متفرعة subset من القائمة المعادة من التابع getmembers()‎. ملاحظة: أضيف المعامل members في الإصدار 3.5 من بايثون. القيمة المعادة ...

يضيف التابع قسمًا يحمل الاسم المعطى إلى نسخة الصنف ConfigParser. البنية العامة add_section(section) ‎المعاملات section سلسلة نصية تتضمن اسم القسم المراد إضافته إلى نسخة الصنف ConfigParser. القيمة المعادة إن كان هناك قسم يحمل الاسم ذاته فإنّ التابع يطلق الاستثناء DuplicateSectionError. وإن كان الاسم المعطى مطابقًا لاسم قسم الإعدادات الافتراضية فإنّ التابع يطلق الاستثناء ValueError. يجب أن يكون الاسم المعطى سلسلة نصية وإلّا فإنّ التابع يطلق الاستثناء TypeError. ملاحظة: يطلق التابع الاستثناء TypeError عند استخدام الأسماء غير النصية في الإصدار 3.2 ...

يفتح التابع العنوان المعطى (والذي يمكن أن يكون كائن Request أو سلسلة نصية) ويمكن أن يمرّر البيانات المعطاة. البنية العامة OpenerDirector.open(url, data=None[, timeout]) ‎المعاملات معاملات هذا التابع والقيمة المعادة والاستثناءات التي يُطلقها مشابهة لتلك الموجودة في الدالة urlopen()‎ (والتي تستدعي التابع open()‎ على الصنف العام OpenerDirector المثبّت حاليًا). timeout يحدّد هذا المعامل الاختياري المهلة الزمنية لإيقاف العمليات مثل محاولة الاتصال (إن لم تحدّد قيمة لهذا المعامل فإنّ التابع سيستخدم القيمة الافتراضية العامّة). يمكن استخدام هذا المعامل مع الاتصالات من نوع ...

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

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

يقرأ التابع العدد المعطى من العناصر (كقيم جهاز machine values) من كائن الملف المعطى ويلحقها بنهاية المصفوفة. البنية العامة ‎array.fromfile(f, n) المعاملات f كائن الملف الذي يقرأ التابع عناصره ويضيفها إلى المصفوفة. يجب أن يكون f كائن ملف داخلي حقيقي، ولا يجدي نفعًا استخدام شيء آخر يمتلك التابع read()‎. n عدد العناصر المقروءة من كائن الملف. إن كان عدد العناصر المتوفّرة أقلّ من n، تطلق اللغة الخطأ EOFError، ومع ذلك تدرج القيم المتوفّرة في نهاية المصفوفة. القيمة المعادة يعيد التابع ...

يكتب التابع تمثيلًا مُسلسَلًا للكائن المُعطى في كائن الملف المفتوح والمحدّد في الدالة البانية للصنف. البنية العامة dump(obj) ‎المعاملات obj الكائن المراد كتابة تمثيله المسَلسَل في الملف المفتوح. أمثلة يبين المثال التالي طريقة استخدام التابع: >>> import pickle >>> data = [1, 2.0, 4, 4+2j] >>> f = open('file1.dat', 'wb') >>> mypickler = pickle.Pickler(f, pickle.HIGHEST_PROTOCOL) >>> mypickler.dump(data) مصادر صفحة DB-API 2.0 interface for SQLite databases في توثيق بايثون الرسمي.

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

ينشئ التابع كائن TarInfo من نتيجة استدعاء الدالة os.stat()‎ أو ما يكافئها على ملف موجود فعلًا. البنية العامة TarFile.gettarinfo(name=None, arcname=None, fileobj=None) المعاملات ‎name يمكن تسمية الملف عن طريق تمرير الاسم في المعامل name أو باستخدام كائن fileobj مع واصف للملف. ويمكن للمعامل name أن يكون كائنًا شبيهًا بالمسارات. arcname معامل اختياري يعيّن اسمًا بديلًا للملف في الأرشيف، وفي حال عدم تحديد قيمة لهذا المعامل يأخذ الملف اسمه من خاصية name في كائن الملف fileobj، أو من المعامل name. يجدر التنبيه ...

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

تحلل الدالة سلسلة الاستعلام النصية المعطاة كسلسلة معاملات نصية string argument (بيانات من نوع application/x-www-form-urlencoded). تعاد البيانات على هيئة قائمة أزواج اسم، قيمة. البنية العامة urllib.parse.parse_qsl(qs, keep_blank_values=False, strict_parsing=False, encoding='utf-8', errors='replace', max_num_fields=None) ‎المعاملات keep_blank_values راية تحدد إذا ما كان المطلوب معاملة القيم الفارغة في سلاسل الاستعلام المرمّزة بالنسبة المئوية percent-encoded queries على أنّها سلاسل نصية فارغة. تشير القيمة الصحيحة لهذا المعامل إلى أنّ الفراغات ستبقى سلاسل نصية فارغة، أما القيمة الخاطئة (وهي القيمة الافتراضية) فتشير إلى أن القيم الفارغة ستُتجاهل من ...

يصنع هذا التابع نسخة سطحية عن القائمة. هذا التابع مكافئٌ للتعبير ‎a[:]‎. البنية العامة l.copy() القيمة المعادة يعيد عذا التابع نسخة سطحية عن القائمة الأصلية. أمثلة يبين المثال التالي كيفية استخدام هذا التابع لإنشاء نسخة من قائمة: >>> list = [1, 4, 8, 9] >>> new_list = list.copy() >>> new_list.append(10) >>> list [1, 4, 8, 9] >>> new_list [1, 4, 8, 9, 10] انظر أيضًا القوائم في بايثون. التابع list.sort()‎: فرز القائمة في مكانها وذلك بإجراء مقارنة بين عناصر القائمة بواسطة العامل ‎<‎ فقط. التابع list.append()‎: إضافة ...

يعيد التابع إرسال الطلب مع معلومات الاستيثاق إن كانت متوفّرة. البنية العامة HTTPBasicAuthHandler.http_error_401(req, fp, code, msg, hdrs) مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

يعرض التابع قيم المفاتيح الخاصة بالقاموس. البنية العامة dict.values() القيمة المعادة يعيد التابع كائن عرض قاموس (dictionary view object) للقيم التابعة للمفاتيح في القاموس. أمثلة يوضّح المثال التالي النتائج المعادة من تطبيق التابع على القواميس: >>> id_users = {1: 'Mohammed', 2: 'Ahmed', 3: 'Jawad', 4: 'Salim'} >>> id_users.values() dict_values(['Mohammed', 'Ahmed', 'Jawad', 'Salim']) انظر أيضًا القواميس في بايثون. التابع dict.items()‎: يعيد التابع عرضًا جديدًا لعناصر القاموس بهيئة (مفتاح، قيمة). التابع dict.keys()‎: يعيد التابع عرضًا جديدًا يتضمّن جميع مفاتيح القاموس. مصادر قسم values في ...

يعيد التابع كائن timedelta يمثّل مقدار إزاحة التوقيت المحلي عن التوقيت العالمي المنسّق UTC. البنية العامة ‎tzinfo.utcoffset(dt) المعاملات القيمة المعادة يعيد التابع كائن timedelta يمثّل مقدار إزاحة التوقيت المحلي عن التوقيت العالمي المنسّق UTC. إن كان التوقيت المحلّي في الجانب الشرقي من التوقيت العالمي المنسّق فإنّ النتيجة تحمل إشارة موجبة، وإن كان في الجانب الغربي فإنّ النتيجة تحمل إشارة سالبة. يجب الانتباه إلى أنّ المقصود هنا هو مقدار الإزاحة الكلية عن التوقيت العالمي المنسّق؛ فعلى سبيل المثال إن كان كائن ...

يوسع التابع المصفوفة بإضافة البيانات من السلسلة النصية المرمّزة بترميز Unicode. البنية العامة ‎array.fromunicode(s) المعاملات s سلسلة نصية بترميز Unicode. يجب أن تكون المصفوفة من النوع 'u'، وإلا فستطلق اللغة الخطأ ValueError. لإلحاق بيانات مرمّزة بترميز Unicode إلى مصفوفة ذات نوع مختلف يمكن استخدام array.frombytes(unicodestring.encode(enc))‎. القيمة المعادة يعيد التابع القيمة None. أمثلة يبين المثال التالي آلية عمل التابع: >>> import array >>> str1 = "Hello World" >>> a1 = array.array('u') >>> a1.fromunicode(str1) >>> a1 array('u', 'Hello World') انظر أيضًا التابع array.frombytes()‎: يلحق التابع عناصر السلسلة ...

يعيد التابع كائن time يتضمّن نفس الساعة والدقيقة والثانية وأجزاء الثانية وfold وtzinfo في كائن datetime. البنية العامة datetime.timetz() القيمة المعادة يعيد التابع كائن time يتضمّن نفس الساعة والدقيقة والثانية وأجزاء الثانية وحالة التوقيت المحلي (fold) ومعلومات المنطقة الزمنيّة (tzinfo) في كائن datetime. أمثلة يُبيّن المثال التالي آلية عمل التابع: >>> from datetime import datetime >>> dt = datetime(2018, 6, 7, 22, 45, 6, 1, None) >>> dt.timetz() datetime.time(22, 45, 6, 1) >>> type(dt.timetz().tztinfo) <class 'NoneType'> انظر أيضًا التابع datetime.date()‎‎:يعيد التابع كائن date يتضمّن نفس ...

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

يعمل هذا التابع على فرز القائمة في مكانها وذلك بإجراء مقارنة بين عناصر القائمة بواسطة العامل ‎<‎ فقط. البنية العامة sort(*, key=None, reverse=False) المعاملات يأخذ هذا التابع معاملين اثنين ويمكن تمريرهما بواسطة الكلمة المفتاحية (معاملات مفتاحية فقط): key يحدد هذا المعامل دالة ذات وسيط واحد يجري تطبيقها على كل عنصر في القائمة قبل عقد المقارنة فيما بينها (مثل: key=str.lower). يأخذ هذا المعامل القيمة الافتراضية None والتي تعني أن عناصر القائمة ستُفرز على نحو مباشر دون حساب قيمة خاصة بالمفتاح. ملاحظة: ...

تبني الدالة عنوان URL من صفّ يشبه الصفّ المعاد من الدالة urlparse()‎. البنية العامة urllib.parse.urlunparse(parts) ‎المعاملات parts يمكن لهذا المعامل أن يكون أي كائن قابل للتكرار iterable يتكوّن من ستة عناصر. قد يؤدي هذا إلى الحصول على عنوان URL مختلف قليلًا ولكنّه مكافئ للعنوان الأصلي إذا كان الأخير يتضمّن فواصل غير ضرورية (مثل علامة ? مع استعلام فارغ، ينصّ معيار RFC على أنّ العنوانين متكافئان). أمثلة يبين المثال التالي طريقة عمل الدالة: >>> from urllib.parse import urlparse, urlunparse >>> url = ...

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

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

تعرّف هذه الوحدة واجهة معيارية لتقسيم سلاسل محدّد موقع الموارد المحدّد Uniform Resource Locator (‏URL اختصارًا) إلى مكوّنات (نظام العنونة addressing scheme، موقع الشبكة network location، المسار path ... الخ)، ولدمج هذه المكونات مرّة أخرى في سلسلة URL، ولتحويل "URL نسبي" إلى URL مطلق بالاعتماد على "URL أساسي". صمّمت هذه الوحدة لتطابق معايير RFC للإنترنت الخاصّة بالمحدّدات النسبية لمواقع الموارد المحدّدة Relative Uniform Resource Locators. وتدعم الوحدة الأنواع التالية من مخطّطات URL: file, ftp, gopher, hdl, http, https, imap, mailto, ...

يتحقّق التابع ممّا إذا كانت السلسلة النصية مكوّنة من حروف مسافات بيضاء فقط وأنّ في السلسلة حرفًا واحدًا على الأقل. البنية العامة str.isspace() يعيد التابع القيمة True إذا كانت السلسلة النصية تضمّ حروف مسافات بيضاء فقط وكان هناك على الأقل حرف واحد في السلسلة، ويعيد القيمة False فيما عدا ذلك. يقصد بحروف المسافات البيضاء تلك التي تعرّف في قاعدة بيانات حروف الترميز الموحد بالمسمّى "Other" أو "Separator" مثل المسافات (spaces) وعلامات الجدولة (tabs) والسطر الجديد (newline) والحروف التي تمتلك خاصية ثنائي ...

ينسّق التابع التاريخ باستخدام سلسلة التنسيق النصية المعطاة. البنية العامة ‎date.strftime(format) المعاملات format سلسلة التنسيق النصية التي يستخدمها التابع لتنسيق السلسلة النصية المعادة. راجع قسم (التابعان strftime()‎ و strptime()‎ ). القيمة المعادة يعيد التابع سلسلة نصية تمثّل الوقت، ويمكن التحكّم بطريقة التمثيل هذه باستخدام سلسلة تنسيق نصية. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import date >>> d = date(2018, 6, 27) >>> d.strftime("%d/%m/%y") '27/06/18' >>> d.strftime("%A %d. %B %Y") 'Wednesday 27. June 2018' انظر أيضًا التابعان strftime()‎ و strptime()‎ . التابع ...

يدرج التابع عنصرًا جديدًا يحمل القيمة المعطاة في المصفوفة قبل الموقع المحدد. البنية العامة ‎array.insert(i, x) المعاملات i موقع إدراج العنصر الجديد ضمن المصفوفة، ويبدأ احتساب الموقع من بداية المصفوفة، ويمكن احتساب موقع إضافة العنصر الجديد من نهاية المصفوفة وذلك بتقديم قيم سالبة. x العنصر المراد إدراجه في المصفوفة. القيمة المعادة أمثلة يبين المثال التالي آلية عمل التابع: >>> import array >>> a1 = array.array('l', [1, 3, 4, 6]) >>> a1.insert(1, 2) >>> a1 array('l', [1, 2, 3, 4, 6]) >>> a1.insert(-1, 5) >>> a1 array('l', [1, ...

يعيد التابع كائن datetime الذي يتضمن التاريخ والوقت الموافقين للعدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد 1 موافقًا للتاريخ 1 كانون الثاني (يناير) سنة 1 ميلادية. البنية العامة datetime.fromordinal(ordinal) المعاملات ordinal العدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد 1 موافقًا للتاريخ 1 كانون الثاني (يناير) سنة 1 ميلادية. القيمة المعادة يعيد التابع التاريخ والوقت الموافقين للعدد الترتيبي في التقويم التنبؤي الكريكوري. ن كانت قيمة المعامل ordinal المعطاة تقع خارج النطاق ‎1 <= ordinal <= date.max.toordinal()‎ فإنّ ...

يعيد التابع الصنف time.struct_time كما تعيده الدالة time.localtime()‎. تكون الساعات والدقائق والثواني أصفارًا، وتأخذ الراية DST القيمة ‎-1. هذا التابع مكافئ للصنف ‎time.struct_time((d.year, d.month,d.day, 0, 0, 0, d.weekday(), yday, -1))‎ حيث ‎yday = d.toordinal() - date(d.year,1, 1).toordinal() + 1‎ وهو عدد اليوم في السنة الحالية بدءًا من اليوم الأول فيها. البنية العامة date.timetuple() القيمة المعادة يعيد التابع الصنف time.struct_time. وهو عبارة عن كائن يتضمّن صفًّا مسمّىً named tuple. ويمكن الوصول إلى القيم عبر الفهرس index أو عبر اسم الخاصية، وكما ...

يتحقّق هذا التابع ممّا إذا كانت السلسلة النصية مكوّنة من الحروف فقط، وأنّ فيها حرفًا واحدًا على الأقل. البنية العامة x.isalpha() القيمة المعادة يعيد التابع isalpha()‎ القيمة True إذا كانت السلسلة النصية مكوّنة من الحروف فقط وكان فيها حرف واحد على الأقل، ويعيد القيمة False فيما عدا ذلك. الحروف الهجائية هي تلك الحروف المعرّفة في قاعدة بيانات حروف الترميز الموحد Unicode بالمسمّى "Letters"، أي أنّها الحروف التي تمتلك إحدى خواص التصنيف العامة "Lm"، أو "Lt"، أو "Lu"، أو "Ll"، أو ...

يقسم التابع التسلسل الثنائي إلى قائمة من الأسطر. البنية العامة bytes.splitlines(keepends=False) المعاملات keepends قيمة منطقية (Boolean). تُدرج فواصل الأسطر في القائمة المعادة عندما يأخذ هذا المعامل القيمة True. القيمة المعادة قائمة من الأسطر الناتجة عن تقسيم التسلسل الثنائي عند حدود الأسطر في ترميز ASCII. يستخدم هذا التابع أسلوب الأسطر الجديدة العامة universal newlines لتقسيم الأسطر. أمثلة يوضّح المثال التالي طريقة تطبيق التابع على السلاسل النصية: >>> b'ab c\n\nde fg\rkl\r\n'.splitlines() [b'ab c', b'', b'de fg', b'kl'] >>> b'ab c\n\nde fg\rkl\r\n'.splitlines(keepends=True) [b'ab c\n', b'\n', b'de ...

يفك التابع ترميز البايتات الممرّرة إليه إلى سلسلة نصية. البنية العامة bytes.decode(encoding="utf-8", errors="strict") المعاملات encoding يحدّد هذا المعامل الترميز الذي سيستخدمه التابع في عمله، ويأخذ القيمة الافتراضية 'utf-8'. وللاطلاع على قائمة بالترميزات المتاحة راجع قسم الترميزات القياسية. ملاحظة: يسمح تمرير المعامل encoding إلى السلسلة النصية بفك ترميز أي كائن شبيه بالبايت bytes-like object على نحو مباشر، دون الحاجة إلى إنشاء كائن بايتات أو كائن مصفوفة بايتات مؤقت. errors يحدّد المعامل error الطريقة المطلوبة للتعامل مع الأخطاء. يأخذ هذا المعامل القيمة ...

يغلق التابع المؤشر فورًا (عوضًا عن إغلاقه عند استدعاء التابع ‎__del__‎)، وبعدها لن يكون بالإمكان استخدام المؤشر، وستطلق اللغة الاستثناء ProgrammingError عند تنفيذ أي عملية باستخدام المؤشر. البنية العامة close() أمثلة يبين المثال التالي طريقة استخدام التابع: >>> import sqlite3 >>> conn = sqlite3.connect('example.db') >>> c = conn.cursor() >>> c.execute('''CREATE TABLE stocks ... (date text, trans text, symbol text, qty real, price real)''') <sqlite3.Cursor object at 0x7f0ea62989d0> >>> c.execute("INSERT INTO stocks VALUES ('2006-01-05','BUY','RHAT',100,35.14)") <sqlite3.Cursor ...