نتائج البحث

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

يعيد التابع كائن ZipFile مع معلومات حول عضو الأرشيف المعطى. البنية العامة ZipFile.getinfo(name) ‎المعاملات name اسم عضو الأرشيف المراد عرض معلومات عنه. القيمة المعادة يعيد التابع كائن ZipFile. أمثلة يبين المثال التالي طريقة استخدام التابع: >>> import zipfile >>> zip = zipfile.ZipFile('files.zip') >>> zip.getinfo('file1.txt') <ZipInfo filename='file1.txt' compress_type=deflate filemode='-rw-r--r--' file_size=10240 compress_size=127> انظر أيضًا التابع ZipFile.infolist()‎: يعيد التابع قائمة تتضمّن كائن ZipFile لكل عضو من أعضاء الأرشيف. التابع ZipFile.namelist()‎: يعيد التابع قائمة بأسماء الأعضاء في ملف الأرشيف. مصادر صفحة Work with ZIP archives في توثيق ...

يقلب التابع حالة الحروف بترميز ASCII في التسلسل الثنائي. البنية العامة bytes.swapcase() القيمة المعادة يعيد التابع التسلسل الثنائي بعد قلب حالة حروف ASCII فيها، أي تصبح الحروف الكبيرة صغيرة، وتصبح الحروف الصغيرة كبيرة. الحروف الصغيرة في ترميز ASCII هي قيم البايتات التي تقع ضمن التسلسل: ‎b'abcdefghijklmnopqrstuvwxyz'‎. أما الحروف الكبيرة في ترميز ASCII هي قيم البايتات التي تقع ضمن التسلسل: ‎b'ABCDEFGHIJKLMNOPQRSTUVWXYZ'‎. ملاحظة: على عكس التابع str.swapcase()‎ يعيد التعبير bin.swapcase()‎.swapcase()‎ تسلسلًا ثنائيًا مطابقًا للتسلسل الثنائي الأصلي. أمثلة يبيّن المثال التالي النتائج المعادة ...

يكتب التابع تمثيلًا للإعدادات في كائن الملف المعطى. البنية العامة write(fileobject, space_around_delimiters=True) ‎المعاملات ‎fileobject كائن الملف المراد كتابة الإعدادات فيه. ‎space_around_delimiters إن أخذ هذا المعامل القيمة True سيضيف التابع مسافات بيضاء حول الفواصل التي تفصل القيم عن المفاتيح. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import configparser >>> config = configparser.ConfigParser() >>> config['DEFAULT'] = {'ServerAliveInterval': '45', ... 'Compression': 'yes', ... ...

ثبّت الدالة نسخة من الصنف OpenerDirector كفاتح opener افتراضي عام. لن تحتاج إلى تثبيت الفاتح إلّا إن كنت ترغب في أن تستخدم الدالة urlopen ذلك الفاتح بالتحديد، وإلاّ فبالإمكان استدعاء التابع OpenerDirector.open()‎ عوضًا عن ()urlopen. لن تتحقّق الشيفرة من وجود صنف OpenerDirector حقيقي، ويمكن لأيّ صنفٍ يمتلك الواجهة الملائمة أن يؤدي العمل نفسه. البنية العامة urllib.request.install_opener(opener) مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

يتحقّق التابع ممّا إذا كان عضو الأرشيف مجلّدًا folder أم لا. البنية العامة ZipInfo.is_dir() ‎القيمة المعادة يعيد التابع القيمة True إن كان عضو الأرشيف مجلّدًا. يستخدم هذا التابع اسم العنصر، ويجب أن تنتهي أسماء المجلّدات بالخط المائل /. ملاحظة: هذا التابع جديد في الإصدار 3.6 من بايثون. أمثلة يبين المثال التالي آلية عمل التابع: >>> import zipfile >>> zip = zipfile.ZipFile('files.zip') >>> info = zip.getinfo('file1.txt') >>> info.is_dir() False مصادر صفحة Work with ZIP archives في توثيق بايثون الرسمي.

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

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

تعيّن الدالة اليوم الذي يبدأ به الأسبوع. البنية العامة ‎calendar.setfirstweekday(weekday) المعاملات weekday يمكن استخدام أعداد صحيحة (0 هو يوم الإثنين و 6 هو يوم الأحد). كذلك يمكن استخدام القيم MONDAY، TUESDAY، WEDNESDAY، THURSDAY، FRIDAY، SATURDAY، SUNDAY لتسهيل اختيار اليوم المطلوب. القيمة المعادة تعيد الدالة القيمة None. أمثلة يبين المثال التالي طريقة استخدام الدالة: import calendar calendar.setfirstweekday(calendar.SUNDAY) calendar.setfirstweekday(6) انظر أيضًا الدالة firstweekday()‎: تعيد الدالة الإعدادات الحالية الخاصة باليوم الذي يبدأ به الأسبوع. مصادر صفحة General calendar-related functions في توثيق بايثون الرسمي.

تعيد الدّالة filter()‎ مُكرّرًا (iterator) من عناصر الكائن القابل للتكرار المُعطى حسب شرطٍ تُحدّده الدّالة المُعطاة. وتُستخدم لترشيح عناصر الكائن القابل للتّكرار. البنية العامة filter(function, iterable) المعاملات function الدّالة المُرشّحةُ التي ستُحدّد ما إذا كان العنصر سينضم إلى المُكرّر النّاتج أو لا. ستستقبل الدّالة العنصر وتُعيد إمّا القيمة True أو القيمة False، إن أعادت الدّالة المُرشّحةُ القيمة True للعنصر المُعطى لها، فسينضمّ إلى المُكرّر النّاتج، ولن ينضمّ عكسَ ذلك. إن كانت قيمة هذا المُعاملِ القيمةَ None، فسيُعمل بقواعد التّحقّق من ...

تفكّ الدالة ترميز سلسلة نصية تتضمن أعداد ست عشرية إلى كائن bytes. البنية العامة bytes.fromhex() المعاملات string سلسلة نصية يجب أن تتضمّن عددين ستّ عشريين لكل بايت، وتتجاهل الدالة المسافات البيضاء في الترميز ASCII. القيمة المعادة تعيد الدالة كائن bytes الناتج من فك ترميز السلسلة النصية التي تتضمن أعدادًا ست عشرية. أمثلة يبين المثال التالي النتائج المعادة من تطبيق الدالة: >>> bytes.fromhex('2Ef0 F1f2 ') b'.\xf0\xf1\xf2' انظر أيضًا الدالة bytes.hex()‎: ترميز كائن bytes إلى سلسلة نصية تتضمن عددين ستّ عشريين مقابل كلّ بايت. ...

يمثّل كائن time الوقت (المحلّي) في يوم غير محدّد، وهو عرضة للتعديل بواسطة كائن tzinfo. البنية العامة class datetime.time(hour=0, minute=0, second=0, microsecond=0, tzinfo=None, *, fold=0) المعاملات جميع المعاملات في عبارة إنشاء الصنف time اختيارية، وتأخذ القيمة الافتراضية 0، ويأخذ المعامل tzinfo القيمة الافتراضية None. يمكن أن تكون قيم جميع المعاملات (باستثناء المعامل tzinfo) أعدادًا صحيحة وضمن المديات التالية: ‎0 <= hour < 24‎ ‎0 <= minute < 60‎ ‎0 <= second < 60‎ ‎0 <= microsecond < 1000000‎ ‎fold in ...

هذا الصنف هو بديل خاص للصنف CGIHandler، ويستخدم لنشر التطبيقات على مخدّم الويب IIS الخاص بمايكروسوفت دون الحاجة إلى ضبط الخيار allowPathInfo في الإعدادات (في الإصدار 7 وما بعده من IIS) أو في قاعدة البيانات الداخلية metabase في الخيار allowPathInfoForScriptMappings (في الإصدر 6 وما قبله من IIS). يعطي مخدّم IIS افتراضيًا متغير PATH_INFO يقوم بمضاعفة المتغير SCRIPT_NAME في الواجهة، الأمر الذي يتسبب في حدوث مشاكل بالنسبة لتطبيقات WSGI التي ترغب في استخدام التوجيه routing؛ لذا يتخلص هذا المعالج من أي ...

الصنف الوحيد الذي تقدمه الوحدة pprint وتقدّم نسخ هذا الصنف عددًا من التوابع التي يمكن الاستفادة منها في طباعة المخرجات بصورة منسّقة وجميلة. البنية العامة ‎pprint.PrettyPrinter(indent=1, width=80, depth=None, stream=None, *, compact=False) المعاملات indent يُحدّد مقدار الإزاحة المضافة لكل مستوى تعاودي عن طريق المعامل indent الذي يأخذ القيمة 1 كقيمة افتراضية. قد تظهر المخرجات بمظهر غريب أحيانًا عند استخدام قيم أخرى لهذا المعامل، ولكن يمكن بسهولة تمييز النتائج المتشعّبة. width تحدّد قيمة هذا المعامل مقدار العرض المسموح به للمخرجات، والقيمة الافتراضية ...

صنف فرعي خاصّ من الصنف ref يحاكي إشارة ضعيفة إلى تابع مرتبط bound method (أي تابع معرف في صنف وجرى البحث عنه في نسخة من ذلك الصنف). ملاحظة: هذا الصنف جديد في الإصدار 3.4. البنية العامة class weakref.WeakMethod(method) المعاملات dict التابع المراد إنشاء محاكاة لإشارة ضعيفة إليه. التوابع المرتبطة سريعة الزوال ما يمنع من تمسّك الإشارات الضعيفة العادية بها. يمتلك الصنف WeakMethod طريقة خاصة لإعادة إنشاء التابع المرتبط والإبقاء عليه إلى أن يموت الكائن أو الدالة الأصلية: >>> class C: ... ...

يعالج التابع استجابات HTTPS التي تتتضمّن أخطاءً، ويعمل بنفس طريقة عمل التابع http_resonse()‎. البنية العامة HTTPErrorProcessor.https_response(request, response) مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

يطبع التابع التمثيل المنسّق للكائن المعطى في المخرجات المعطاة، متبوعًا بسطر جديد. البنية العامة PrettyPrinter.pprint(object) المعاملات object الكائن المراد طباعته. القيمة المعادة يطبع التابع التمثيل المنسّق للكائن المعطى وفي المخرجات المحدّدة في الدالة البانية للصنف PrettyPrinter، متبوعًا بسطر جديد. أمثلة يبين المثال التالي آلية عمل التابع: >>> import pprint >>> stuff = ['spam', 'eggs', 'lumberjack', 'knights', 'ni'] >>> stuff.insert(0, stuff[:]) >>> pp = pprint.PrettyPrinter(indent=4) >>> pp.pprint(stuff) [ ['spam', 'eggs', 'lumberjack', 'knights', 'ni'], 'spam', 'eggs', ...

تعيد الدّالة tuple()‎ صفًّا يُولَّد من الكائن القابل للتّكرار المُعطى. البنية العامة tuple([iterable]) المعاملات iterable مُعامل اختياريّ، الكائن القابل للتّكرار (كالقوائم، والمجموعات، والسّلاسل النّصيّة وغيرها) المُراد تحويله إلى صفّ. القيمة المعادة صفّ جديد فارغ (إن لم تُمرّر للدّالة أيّة مُعاملات) أو صفّ تكون عناصره هي عناصر الكائن القابل للتّكرار iterable. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> tuple() # صفّ فارغ () >>> tuple('123') # صفّ من سلسلة نصيّة ('1', '2', '3') >>> tuple([1, 2, 3]) # صفّ من قائمة (1, 2, 3) >>> ...

يفتح التابع الملفّ محلّيًا، إن لم يحدد اسم المضيف، أو كان اسم المضيف هو 'localhost'. البنية العامة FileHandler.file_open(req) المعاملات req طلب HTTP المراد إرساله. ملاحظة: يمكن تطبيق هذا التابع على أسماء النطاقات المحلية فقط في الإصدار 3.2 من بايثون. يُطلق التابع الاستثناء URLError في حال إعطاء اسم مضيف بعيد. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

يعيد هذا الصنف كائن إنهاء finalizer قابل للاستدعاء، ويجري استدعاؤه عند استرجاع الكائن المعطى بواسطة مجموعة garbage. البنية العامة class weakref.finalize(obj, func, *args, **kwargs) المعاملات يعدّ كائن الإنهاء "حيًّا" إلى حين استدعائه (إما على نحو صريح أو في مجموعة garbage) وبعد ذلك يصبح "ميّتًا". تؤدي عملية استدعاء كائن إنهاء حيّ إلى إعادة نتيجة تنفيذ func(*arg, **kwarg)‎، في حين تعيد عملية استدعاء كائن إنهاء ميّت القيمة None. من الضروري التأكّد من أن func و args و kwargs لا تمتلك أيّ إشارات ...

يعيد التابع كائن datetime حسب التوقيت العالمي المنسّق والموافق لختم POSIX الزمني، مع إعطاء tzinfo القيمة None. البنية العامة datetime.utcfromtimestamp(timestamp) المعاملات timestamp سلسلة نصية تحتوي ختم POSIX الزمني والذي يستخدمه التابع لإنشاء كائن datetime. القيمة المعادة يعيد التابع كائن datetime حسب التوقيت العالمي المنسّق والموافق لختم POSIX الزمني، مع إعطاء tzinfo القيمة None. إن كان الختم الزمني خارج نطاق القيم التي تدعمها الدالة gmtime()‎ في منصّة C، فإنّ التابع يطلق الخطأ OverflowError، وإن حدث خطأ في تنفيذ الدالة gmtime()‎ فإنّ ...

قد تكون أخطاء الصيغة (Syntax errors) أو ما يعرف أيضًا بأخطاء الإعراب (Parsing errors) هي أكثر نوع من الأخطاء التي يواجهها المبتدئون عند تعلّم بايثون: >>> while True print('Hello world')   File "<stdin>", line 1     while True print('Hello world')                    ^ SyntaxError: invalid syntax يعيد المفسّر (parser) طباعة الجملة التي تحتوي على الخطأ مع سهم صغير يشير إلى مكان الخطأ ضمن السطر. ويكون الخطأ ناتجًا عن (أو اكتشف في) المكان الذي يسبق السهم. في المثال السابق ...

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

تعيد الدالة اللهجة المرتبطة بالاسم المعطى. البنية العامة csv.get_dialect(name) ‎المعاملات name اسم اللهجة المطلوبة. القيمة المعادة تعيد الدالة اللهجة المرتبطة بالاسم المعطى. تُطلق الدالة استثناء إن كان الاسم المعطى غير موجود في سجلّ اللهجات. تعيد الدالة كائن Dialect غير قابل للتعديل. أمثلة يعرض المثال التالي طريقة الاستفادة من هذه الدالة: >>> import csv >>> csv.register_dialect('unixpwd', delimiter=':', quoting=csv.QUOTE_NONE) >>> csv.get_dialect('unixpwd') <_csv.Dialect object at 0x7f29af0a6ae8> >>> csv.get_dialect('xpwd') Traceback (most recent call last): File "<stdin>", line 1, in <module> _csv.Error: unknown dialect انظر أيضًا الدالة csv.register_dialect()‎: تربط الدالة ...

يعدّ تابع الصنف هذا بمثابة دالة بانية لكائنات TarFile. والدالة tarfile.open()‎ هي في الواقع اختصار لتابع الصنف هذا. البنية العامة TarFile.open(...) المعاملات يمتلك هذا التابع نفس المعاملات الموجودة في الدالة البانية للصنف TarFile. القيمة المعادة يعيد التابع كائن TarFile. أمثلة لو فرضنا وجود ملفّ مضغوط بصيغة tar فيمكن الوصول إلى هذا الملف وإنشاء كائن TarFile بالطريقة التالية: >>> import tarfile >>> tar = tarfile.TarFile.open("file.tar.xz") يمثّل tar الآن كائن TarFile يمكن استخدامه لتنفيذ التوابع الخاصة بهذا الكائن. انظر أيضًا الدالة tarfile.open()‎: تعيد ...

تعيد الدّالة itertools.chain()‎ مُكرّرًا يُعيد عناصر الكائن القابل للتكرار الأول حتى تنتهيَ عناصره، ثمّ ينتقل إلى الكائن القابل للتّكرار التّالي إلى أن تنتهي قيّمه وهكذا… وتُستخدم لمُعالجة عدّة تسلسلات على أنّها تسلسل واحد مُستمرّ. البنية العامة itertools.chain(*iterables) المعاملات iterables الكائنات القابلة للتّكرار المرغوب تحويلها إلى تسلسل واحد مُستمر. القيمة المعادة مُكرّر يحتوي على جميع عناصر الكائنات القابلة للتّكرار المُعطاة حسب التّرتيب التي مُرّرت فيها. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> c = itertools.chain([1, 2, 3], 'abc') >>> c <itertools.chain ...

يقدّم كائن Calendar في وحدة calendar عددًا من التوابع التي يمكن استخدامها لتحضير بيانات التقويم لغرض التنسيق. وتجدر الإشارة هنا إلى أنّ هذا الصنف لا يؤدي أي عمليات تنسيق، وأنّ هذه العمليات تقع على عاتق الأصناف الفرعية. البنية العامة calendar.Calendar(firstweekday=0) تنشئ هذه الدالة البانية كائن Calendar جديد. المعاملات firstweekday المعامل firstweekday هو عدد صحيح يحدّد اليوم الأول في الأسبوع. يمثّل العدد 0 يوم الإثنين (وهو القيمة الافتراضية) والعدد 6 هو يوم الأحد. توابع الصنف Calendar تقدّم نسخ الصنف Calendar التوابع ...

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

يحذف هذا التابع الحروف المحدّدة من قبل المستخدم من نهاية وبداية السلسلة النصية. المعاملات chars سلسلة نصية تحدّد مجموعة الحروف التي سيحذفها التابع من السلسلة النصية. في حال عدم تمرير هذا المعامل أو أخذه للقيمة None يحذف التابع المسافات البيضاء فقط. يحذف هذا التابع أي مزيج من الحروف الموجودة في المعامل chars. ويحذف الحروف من بداية ونهاية السلسلة النصية الأبعد فالأبعد، وتستمر عملية الحذف من الجهتين إلى حين الوصول إلى أوّل حرف غير موجود في السلسلة النصية الممرّرة في المعامل ...

يؤدي استدعاء هذا التابع إلى معالجة جميع المدخلات المعلّقة، ويعيد التابع كائن 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()‎ مرة أخرى ...

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

تُعيد الدالة قائمة بالمُجلَّدات التي سيتُم البحث فيها عن الملفات التنفيذيّة عند تشغيل عملية ما. البنية العامة get_exec_path(env=None) المعاملات env قاموس متغيّرات البيئة الذي سيُبحَث فيه عن المتغيّر PATH. تُسنَد القيمة None للوسيط env، ويُستخدَم القاموس os.environ للحصول على متغيّر البيئة PATH افتراضيًا. القيمة المعادة تُعيد الدالة قائمة بالمُجلَّدات التي سيتم البحث فيها عن الملفات التنفيذيّة، كما يحدث في الصدفة (shell)، عند تشغيل عملية ما. أمثلة يعرض المقتطف أدناه مثال عن استخدام الدالة للحصول على مسارات التي سيُبحَث فيها عن ...

تعرّف وحدة urllib.response دوالَّ وأصنافًا تقدّم واجهة مصغّرة شبيهة بواجهة التعامل مع الملفات، وتتضمّن الدالتين read()‎ و readline()‎. كائن الاستجابة الاعتيادي هو نسخة من addinfourl والتي تعرف التابع info()‎ الذي يعيد الترويسات وتابع geturl()‎ الذي يعيد عنوان URL. تستخدم الدوال المعرّفة في هذه الوحدة بواسطة الوحدة urllib.request. انظر أيضًا الوحدة urllib.request: تقدّم الوحدة عددًا من الدوال والأصناف التي تساعد في فتح عناوين URL‏ (HTTP في الغالب) لاستخدامها في عمليات مختلفة مثل الاستيثاق البسيط وإعادة التوجيه والتعامل مع الكعكات cookies وغيرها. مصادر ...

الدّالة classmethod()‎ مُزخرفٌ يُحوّل تابعًا عاديًّا في صنف ما إلى تابع صنف (class method) ليُمكن الوصول إلى الصّنف الذي عُرّف فيه التّابع. يستقبل تابع الصّنفِ الصّنفَ كمُعاملٍ أول، تمامًا كما يستقبل التّابع العاديّ النّسخة (instance) كمُعامل أولٍ (أي الكائن الذي نُشير إليه عادةً بالاسم self). البنية العامة class C: @classmethod def f(cls, arg1, arg2, ...): ... المعاملات لا توجد مُعاملات. لكنّ الدّالة المُزخرَفَة f تستقبل المُعامل cls الذي يُشير إلى الصّنف الذي عُرّف عليه ...

تفكّ الدالة ترميز سلسلة نصية تتضمن أعداد ست عشرية إلى كائن bytes. البنية العامة bytes.fromhex() المعاملات string سلسلة نصية يجب أن تتضمّن عددين ستّ عشريين لكل بايت، وتتجاهل الدالة المسافات البيضاء في الترميز ASCII. القيمة المعادة تعيد الدالة كائن bytes الناتج من فك ترميز السلسلة النصية التي تتضمن أعدادًا ست عشرية. أمثلة يبين المثال التالي النتائج المعادة من تطبيق الدالة: >>> bytes.fromhex('2Ef0 F1f2 ') b'.\xf0\xf1\xf2' انظر أيضًا الدالة bytes.hex()‎: ترميز كائن bytes إلى سلسلة نصية تتضمن عددين ستّ عشريين مقابل كلّ بايت. ...

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

القيمتان المنطقيتان (البوليانيتان، Boolean) اللتان تدعمهما بايثون هما True و False وهما كائنان ثابتان (Constant objects) يعبران عن صحّة تعبير ما، فإمّا أن يكون صحيحًا True أو خطأً False. تعدّ القيم المنطقية نوعًا فرعيًا (subtype) من الأعداد الصحيحة، وتسلك القيمتان False و True سلوك القيمتين 0 و 1 على التوالي في معظم السياقات تقريبًا، ويستثنى من ذلك تحويل القيم المنطقية إلى سلاسل نصية، فتعاد حينئذ السلسلتان النصيتان "False" و "True" على التوالي. 1 >>> foo = True 2 >>> bar ...

تُعيد الدالة سلسلة نصيّة تحتوي على مُجلَّد العمل الحالي. البنية العامة getcwd() القيمة المعادة تُعيد الدالة سلسلة نصيّة تحتوي على مُجلَّد العمل الحالي. أمثلة يُظهِر المقتطف أدناه محاولتين لاستخدام الدالة ()os.chdir لتغيير مُجلَّد العمل الحالي، ومن ثمَّ طباعته باستخدام الدالة ()os.getcwd. >>> from os import chdir, getcwd >>> chdir("/") >>> getcwd() '/' >>> chdir("/home") >>> getcwd() '/home' انظر أيضًا الدالة ()os.chdir: تُغيّر مُجلَّد العمل الحالي إلى المُجلَّد المُمرَّر. مصادر قسم الوحدة os في توثيق بايثون الرسمي.

يقرأ التابع العدد المحدد من البيانات المضغوطة دون تقديم موقع الملف. البنية العامة peek(n) المعاملات ‎n عدد البيانات المضغوطة المراد قرائتها. يُجري التابع عند استدعائه قراءة واحدة على الأكثر على تدفق البيانات المضغوطة، ويمكن لعدد البايتات المعادة أن يكون أقل أو أكثر من المطلوب. ملاحظات: صحيح أن استدعاء التابع peek()‎ لا يؤدي إلى تغيير في موقع الملف في كائن GzipFile، ولكنّه قد يؤدي إلى إحداث تغيير في كائن الملف الداخلي (إذا كان كائن GzipFile قد بُني مع استخدام المعامل fileobj ...

ينشئ التابع سلسلة ذاكرة نصية من كائن TarInfo. البنية العامة TarInfo.tobuf(format=DEFAULT_FORMAT, encoding=ENCODING, errors='surrogateescape') ‎المعاملات ‎لمزيد من المعلومات حول معاملات هذا التابع راجع الدالة البانية للصنف TarFile. ملاحظة: في الإصدار 3.2 من بايثون تستخدم القيمة 'surrogateescape' كقيمة افتراضية للمعامل errors. مصادر صفحة Read and write tar archive files في توثيق بايثون الرسمي.

يستدعي هذا التابعُ التابعَ Cursor.execute()‎ مع تمرير المعاملات المعطاة. البنية العامة execute(sql[, parameters]) ‎ المعاملات sql سلسلة نصية تتضمن جملة SQL المراد تنفيذها. القيمة المعادة هذا التابع طريقة مختصرة لإنشاء كائن مؤشر عن طريق استدعاء التابع cursor()‎، حيث يستدعي التابع execute()‎ في كائن المؤشر مع تمرير المعاملات المعطاة، ثم يعيد كائن المؤشر. أمثلة يبين المثال التالي آلية عمل التابع: import sqlite3 conn = sqlite3.connect('example.db') c = conn.cursor() symbol = 'RHAT' c.execute("SELECT * FROM stocks WHERE symbol = '%s'" % symbol) انظر أيضًا التابع Connection.excutemany()‎: ...

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

هذا الصنف هو صنف أساسي مجرّد abstract base class، وهذا يعني أنّه لا يمكن إنشاء نسخة منه بصورة مباشرة، بل يجب اشتقاق صنف فرعي منه يتضمّن (على الأقل) توابع tzinfo القياسية التي ستُستخدم من طرف توابع الصنف datetime. تقدّم وحدة datetime الصنف timezone وهو صنف فرعي محدّد concrete بسيط من الصنف tzinfo، يمكن عن طريقه تمثيل المناطق الزمنية باستخدام مقدار إزاحة ثابت عن التوقيت العالمي المنسّق، مثل التوقيت العالمي المنسّق نفسه، أو توقيتي EST و EDT في أمريكا الشمالية. يمكن ...

هذا التابع هو تابع صنف (Class method) يعيد العدد العشري الذي يمكن تمثيله باستخدام السلسلة النصية التي تتضمن الصيغة الست عشرية. البنية العامة x.fromhex() المعاملات s وهو عبارة عن سلسلة نصية تتضمن القيمة الست عشرية المراد تمثيلها بصيغة العدد العشري، وتأخذ القيمة الست عشرية الصيغة التالية: [sign] ['0x'] integer ['.' fraction] ['p' exponent] الإشارة sign هنا اختيارية وتأخذ القيمتين + أو -، أما العدد الصحيح integer والكسر fraction فهما سلسلتان نصيتان تضمّان أعدادًا بالصيغة الست عشرية، والأس هو عدد عشري يمكن ...

يقسم التابع التسلسل الثنائي إلى قائمة من الأسطر. البنية العامة 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 ...

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

ينشئ التابع دالة تجميع aggregate function معرّفة من قبل المستخدم. البنية العامة create_aggregate(name, num_params, aggregate_class) المعاملات name اسم دالة التجميع المراد إنشاؤها. num_params عدد المعاملات التي تستقبلها الدالة (يمكن تعيين القيمة ‎-1 لهذا المعامل لتستقبل الدالة أي عدد من المعاملات). aggregate_class صنف تجميع يجب أن يتضمّن تابع step، والذي يأخذ المعامل num_params والذي يحدّد عدد المعاملات في الدالة التي ينشئها التابع (يمكن تعيين القيمة ‎-1 لهذا المعامل لتستقبل الدالة أي عدد من المعاملات)، وتابع finalize والذي سيعيد النتيجة النهائية من ...

يحذف التابع زوج (مفتاح، قيمة) عشوائيًا من القاموس ويعيد قيمته. البنية العامة dict.popitem() القيمة المعادة يعيد التابع زوج (مفتاح، قيمة) المحذوف من القاموس، ويطلق الخطأ KeyError إن كانت المجموعة فارغة. أمثلة يبين المثال التالي النتائج المعادة من تطبيق التابع: >>> employee = {'first-name': 'Ahmed', 'last-name': 'Jamil', 'age': 28} >>> employee.popitem() ('age', 28) >>> employee.popitem() ('last-name', 'Jamil') >>> employee.popitem() ('first-name', 'Ahmed') >> employee.popitem() Traceback (most recent call last): File "<stdin>", line 1, in <module> KeyError: 'popitem(): dictionary is empty' انظر أيضًا القواميس في بايثون. التابع dict.pop()‎: حذف المفتاح المحدد ...

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

تفتح الدالة قاعدة بيانات gdbm وتعيد كائن gdbm. البنية العامة dbm.gnu.open(filename[, flag[, mode]]) المعاملات filename حدّد المعامل filename اسم ملف قاعدة البيانات المراد فتحها. flag يأخذ المعامل الاختياري flag إحدى القيم التالية: القيمة الوصف 'r' فتح قاعدة البيانات للقراءة فقط (القيمة الافتراضية). 'w' فتح قاعدة البيانات للكتابة والقراءة. 'c' فتح قاعدة البيانات للكتابة والقراءة، وإنشائها في حال عدم وجودها. 'n' تنشئ الدالة قاعدة بيانات جديدة وفارغة، وتفتحها للكتابة والقراءة. يمكن كذلك إلحاق الحروف الإضافية التالية إلى المعامل flag للتحكم في ...

تقدّم وحدة dbm.dumb واجهة برمجية مستمرة persistent شبيهة بالقواميس مكتوبة بواسطة لغة بايثون بالكامل. وعلى عكس الوحدات الأخرى مثل dbm.gnu لا حاجة لاستخدام أي مكتبات خارجية، ولكن تخزّن المفاتيح والقيم كبايتات كما هو الحال مع كائنات الربط المستمرّة الأخرى. ملاحظة: أعدت وحدة dbm.dumb لتوفّر الدعم التراجعي الأخير لوحدة dbm عند عدم توفّر أي وحدة ذات أداء أقوى. لم تكتب وحدة dbm.dumb لتقدّم أداءً سريعًا ولا تستخدم بكثرة مقارنة بالوحدات الأخرى الخاصة بقواعد البيانات. الاستثناءات الاستثناء dbm.dumb.error يطلق هذا الاستثناء عند ...

ينسّق التابع كائن datetime الموافق لسلسلة التاريخ النصية المعطاة، باستخدام سلسلة التنسيق النصية المعطاة. البنية العامة datetime.strptime(date_string, format) المعاملات date_string سلسلة التاريخ النصية التي يستخدمها التابع لإنشاء كائن datetime الموافق. format سلسلة التنسيق النصية التي يستخدمها التابع لتنسيق الوقت والتاريخ في كائن datetime المعاد. راجع قسم (التابعان strftime()‎ و strptime()‎ ). تطلق اللغة الخطأ ValueError إن لم يكن التابع time.strptime()‎ قادرًا على تفسير سلسلة التاريخ النصية أو سلسلة التنسيق النصية، أو إن أعاد التابع قيمة ليست من نوع صفّ وقتي ...

الصنف الوحيد الذي تقدمه الوحدة pprint وتقدّم نسخ هذا الصنف عددًا من التوابع التي يمكن الاستفادة منها في طباعة المخرجات بصورة منسّقة وجميلة. البنية العامة ‎pprint.PrettyPrinter(indent=1, width=80, depth=None, stream=None, *, compact=False) المعاملات indent يُحدّد مقدار الإزاحة المضافة لكل مستوى تعاودي عن طريق المعامل indent الذي يأخذ القيمة 1 كقيمة افتراضية. قد تظهر المخرجات بمظهر غريب أحيانًا عند استخدام قيم أخرى لهذا المعامل، ولكن يمكن بسهولة تمييز النتائج المتشعّبة. width تحدّد قيمة هذا المعامل مقدار العرض المسموح به للمخرجات، والقيمة الافتراضية ...

أبسط صيغة لتعريف الأصناف في بايثون هي: class ClassName:     <statement-1>     .     .     .     <statement-N> تعريف الأصناف كما هو الحال مع عبارات تعريف الدوال (عبارات def) يجب تنفيذ عبارات تعريف الأصناف حتى يكون لها الأثر المطلوب. يمكن تعريف الأصناف في بايثون ضمن عبارات if أو حتى داخل الدوال. عادة ما تستخدم الدوال داخل تعريف الصنف، ولكن من الممكن استخدام أنواع أخرى من العبارات، وتمتلك الدوال داخل الأصناف مجموعة من الوسائط الخاصّة بعملية استدعاء التوابع في بايثون. ...

تُعيد الدالة سلسلة بايت (bytestring) تحتوي على مُجلَّد العمل الحالي. البنية العامة getcwdb() القيمة المعادة تُعيد الدالة سلسلة بايت تحتوي على مُجلَّد العمل الحالي. أمثلة يُظهِر المقتطف أدناه محاولتين لاستخدام الدالة ()os.chdir لتغيير مُجلَّد العمل الحالي، ومن ثمَّ طباعته باستخدام الدالة ()os.getcwdb. >>> from os import chdir, getcwd >>> chdir("/") >>> getcwd() b'/' >>> chdir("/home") >>> getcwd() b'/home' انظر أيضًا الدالة ()os.chdir: تُغيّر مُجلَّد العمل الحالي إلى المُجلَّد المُمرَّر. الدالة ()os.getcwd: تُعيد سلسلة نصيّة تحتوي على مُجلَّد العمل الحالي. مصادر قسم الوحدة os في توثيق بايثون ...

يحاول التابع قراءة وتفسير مكرِّر iterable من أسماء الملفات المعطاة. البنية العامة read(filenames, encoding=None) المعاملات ‎filenames سلسلة نصية أو كائن bytes أو كائن شبيه بالملفات، ويعامل كاسم ملف واحد. إن لم يتمكن التابع من فتح الملف المحدد في المعامل filenames فإن التابع سيتجاهل ذلك الملف. صُمّم هذا التابع بطريقة تتيح للمسختدم تحديد مكرّر يتضمن المواقع المحتملة لملفات الإعدادات (مثل: المجلد الحالي، المجلد الرئيسي للمستخدم، وبعض مجلدات النظام) وسيقرأ التابع كل ملفات الإعدادات التي يعثر عليها في هذه المواقع. ملاحظات: أضيف ...

ملاحظة: هذا الصنف مهمل في الإصدار 3.3 وما بعده من بايثون. هذا هو الصنف الأساسي لفتح وقراءة عناوين URL. إن لم تكن ترغب في دعم فتح الكائنات باستخدام مخطّطات http:‎ أو ftp:‎ أو file، فستحتاج على الأرجح إلى استخدام الصنف FancyURLopener. يرسل الصنف URLopener افتراضيًا ترويسة User-Agent من نوع urllib/VVV حيث تمثل VVV رقم إصدار urllib. يمكن للتطبيقات أن تعرّف ترويسة User-Agent الخاصّة بها عن طريق إنشاء أصناف فرعية من الصنف URLopener أو FancyURLopener وتعيين قيمة نصية ملائمة للخاصية version ...

يلغي التابع جميع التعديلات التي أجريت على قاعدة البيانات بعد آخر استدعاء للتابع commit()‎. البنية العامة rollback() مصادر صفحة DB-API 2.0 interface for SQLite databases في توثيق بايثون الرسمي.

يقلب التابع حالة الحروف بترميز ASCII في التسلسل الثنائي. البنية العامة bytes.swapcase() القيمة المعادة يعيد التابع التسلسل الثنائي بعد قلب حالة حروف ASCII فيها، أي تصبح الحروف الكبيرة صغيرة، وتصبح الحروف الصغيرة كبيرة. الحروف الصغيرة في ترميز ASCII هي قيم البايتات التي تقع ضمن التسلسل: ‎b'abcdefghijklmnopqrstuvwxyz'‎. أما الحروف الكبيرة في ترميز ASCII هي قيم البايتات التي تقع ضمن التسلسل: ‎b'ABCDEFGHIJKLMNOPQRSTUVWXYZ'‎. ملاحظة: على عكس التابع str.swapcase()‎ يعيد التعبير bin.swapcase()‎.swapcase()‎ تسلسلًا ثنائيًا مطابقًا للتسلسل الثنائي الأصلي. أمثلة يبيّن المثال التالي النتائج المعادة ...

تقدّم هذه الوحدة مجموعة من الأصناف والدوال المساعدة لإجراء عمليات ضغط البيانات وفك الضغط عنها باستخدام خوارزمية الضغط LZMA. وتتضمّن هذه الوحدة كذلك واجهة للتعامل مع الملفات ذات الامتداد ‎.xz و ‎.lzma المستخدمة بواسطة الأداة xz، إضافة إلى التعامل مع البيانات المضغوطة الخام. تقدّم هذه الوحدة واجهة مشابهة إلى حد كبير للواجهة المقدّمة في الوحدة bz2، ولكن يجب الانتباه إلى أنّ الصنف LZMAFile -وعلى عكس الصنف bz2.BZ2File- لا تتمتع بسلامة الخيوط not thread-safe؛ لذا إن احتجت إلى استخدام نسخة واحدة ...

تُحدّث الدّالة locals()‎ قاموسًا يُمثّل جدول الرموز المحليّ (local symbol table) وتُعيده. البنية العامة locals() المعاملات لا توجد مُعاملات. القيمة المعادة قاموس يُمثّل المتغيّرات المحليّة. ملاحظات تُعاد المُتغيّرات الحرّة (free variables) من طرف الدّالة عند استدعائها داخل الدّوال وليس داخل الأصناف. لا يجب تعديل مُحتويات القاموس المُعاد، إذ أنّ التّعديلات قد لا تُؤثّر على المتغيّرات المحليّة والحرّة المُستخدمة من طرف المُفسّر. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> y = 1 # هذا المتغيّر لن يكون محليّا نسبة ...

تستخدم "مواصفات التنسيق" ضمن حقول الاستبدال الموجودة في سلاسل التنسيق النصية لتحديد طريقة تمثيل القيم المفردة فيها. ويمكن تمرير هذه المعايير مباشرة إلى الدالة الداخلية format()‎. ويمكن لكل نوع من أنواع جداول التنسيق formattable أن يحدّد الطريقة التي ستُفسَّر بها معايير التنسيق هذه. صيغة التنسيق تعتمد معظم الأنواع الداخلية في بايثون الخيارات التالية كمواصفات للتنسيق، ولكن بعض الخيارات مدعومة بواسطة الأنواع العددية فقط. يؤدي استخدام سلسلة تنسيق نصية فارغة ("") في العادة إلى الحصول على نفس النتيجة المستحصلة من استدعاء ...

يعيد التابع الخيارات المنطوية تحت القسم المعطى. البنية العامة 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'‎ من الترميز ...

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

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

urllib هي حزمة تتضمّن مجموعة من الوحدات التي تتعامل مع عناوين URL: الوحدة urllib.request: تقدّم الوحدة عددًا من الدوال والأصناف التي تساعد في فتح عناوين URL‏ (HTTP في الغالب) لاستخدامها في عمليات مختلفة مثل الاستيثاق البسيط وإعادة التوجيه والتعامل مع الكعكات cookies وغيرها. الوحدة urllib.error: تعرّف الوحدة الأصناف الخاصة بالاستثناءات التي تُطلقها الوحدة urllib.request. الوحدة urllib.parse: تعرّف هذه الوحدة واجهة معيارية لتحليل عناوين URL. الوحدة urllib.robotparser: تقدّم الوحدة صنفًا واحدًا يساعد في تحليل ملفات robots.txt. مصادر صفحة URL handling modules ...

يضغط التابع البيانات المعطاة ويعيد كائن 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 من اللغة. أمثلة يبين المثال ...

تطبع الدالة التمثيل المنسّق للكائن المعطى في المخرجات المعطاة، متبوعًا بسطر جديد. البنية العامة pprint.pprint(object, stream=None, indent=1, width=80, depth=None, *, compact=False) المعاملات إن أخذ المعامل stream القيمة None فستستخدم الدالة sys.stdout. يمكن استخدام هذه الدالة في مفسر بايثون التفاعلي عوضًا عن الدالة print()‎ لتفحّص القيم (يمكن كذلك إعادة إسناد print = pprint.pprint لاستخدامها ضمن نطاق معين). تُمرّر المعاملات indent و width و depth و compact إلى الدالة البانية للصنف PrettyPrinter كمعاملات تنسيق. ملاحظة: أضيف المعامل compact في الإصدار 3.4 من ...

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

تشبه هذه الوحدة إلى حدٍّ كبير الوحدة dbm، ولكنّها تستخدم مكتبة غنو gdbm لتقديم بعض الوظائف الإضافية. ويجب الانتباه إلى أنّ صيغ الملفات التي تنشئها dbm.gnu و dbm.ndbm غير متوافقة مع بعضها البعض. تقدّم وحدة dbm.gnu واجهة للتعامل مع مكتبة GNU DBM. وتسلك كائنات dbm.gnu.gdbm سلوك كائنات الربط (القواميس) باستثناء أنّ المفاتيح والقيم تحوّل دائمًا إلى بايتات قبل تخزينها. لا تؤدي طباعة كائن gdbm إلى طباعة المفاتيح والقيم، ولا تدعم هذه الكائنات التابعين items()‎ و values()‎. الاستثناءات الاستثناء exception dbm.gnu.error ...

يحوّل التابع جميع الحروف بترميز 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' انظر ...

العدد الصحيح integer هو أي عدد موجب أو سالب لا يتضمن فاصلة عشرية، ويمكن تمثيله بالنظام العشري (decimal، الأساس 10) والست عشري (hexadecimal، الأساس 16) والثماني (octal، الأساس 8) والثنائي (binary، الأساس 2). يجب أن يكون العدد الصحيح مسبوقًا بالقيمة 0o لاستخدامه في النظام الثماني، وبالقيمة 0x لاستخدامه في النظام الست عشري، وبالقيمة 0b لاستخدامه في النظام الثنائي، وفيما يلي مجموعة من الأمثلة: >>> q = 3571 # عدد صحيح في النظام العشري >>> q ...

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

تضغط الدالة البايتات المعطاة، وتعيد كائن bytes يتضمّن البيانات المضغوطة. البنية العامة zlib.compress(data, level=-1) ‎المعاملات level المعامل level هو عدد صحيح ضمن النطاق 0 إلى 9 أو ‎-1 ووظيفته هي التحكم في مستوى عملية الضغط، فالقيمة 1 تقابل المستوى(Z_BEST_SPEED) وهو الأسرع ويعطي أقل مقدار من الضغط، والقيمة 9تقابل المستوى(Z_BEST_COMPRESSION) وهو الأبطأ وينتج أكبر مقدار من الضغط. أما القيمة 0 فتقابل المستوى (Z_NO_COMPRESSION) فتعني عدم ضغط البيانات. القيمة الافتراضية لهذا المعامل هي ‎-1 وتقابل ‎(Z_DEFAULT_COMPRESSION)‎ وتقدّم هذه القيمة حالة من التوازن ...

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

هذا الصنف متفرّع من الصنف TextCalendar. يمكن تمرير اسم المنطقة في المعامل locale إلى الدالة البانية وستعيد الدالة أسماء الأشهر وأيام الأسبوع حسب المنطقة المحدّدة. إن تضمّنت المنطقة ترميزًا خاصًّا فإنّ جميع السلاسل النصية التي تتضمّن أسماء الأشهر وأيام الأسبوع ستعاد بالترميز unicode. البنية العامة ‎calendar.LocaleTextCalendar(firstweekday=0, locale=None) المعاملات firstweekday المعامل firstweekday هو عدد صحيح يحدّد اليوم الأول في الأسبوع. يمثّل العدد 0 يوم الإثنين (وهو القيمة الافتراضية) والعدد 6 هو يوم الأحد. locale سلسلة نصية تتضمن اسم الإعدادات المحلية المطلوب ...

تضمّ وحدة string عددًا من الثوابت والأصناف المفيدة في معالجة السلاسل النصية. وتدعم السلاسل النصية في بايثون مجموعة التوابع الخاصّة بالنوع str إلى جانب التوابع الخاصّة بالوحدة string. تقدّم الوحدة string الصنفين التاليين: الصنف Formatter: يتيح هذا الصنف من خلال توابعه إنشاء عمليات تنسيق السلاسل النصية جديدة وتخصيصها حسب الرغبة وبنفس الأسلوب المتّبع في الدالة الداخلية format()‎. الصنف Template: يقدّم هذا الصنف طريقة أبسط لإجراء عمليات الاستبدال في السلاسل النصية والموصوفة في PEP 292. حيث يمكن إجراء عمليات الاستبدال باستخدام ...

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

تتطلب بعض التطبيقات استخدام البيانات المضغوطة، وتتيح الدوال المتوفّرة في هذه الوحدة إجراء عمليات الضغط وفك الضغط على البيانات باستخدام مكتبة zlib، ولهذه المكتبة موقع إلكتروني خاص. يجدر التنبيه إلى وجود بعض المشاكل في التوافقية بين وحدة بايثون والإصدارات 1.1.3 وما دونها من مكتبة zlib، إضافة إلى أنّ الإصدار 1.1.3 يعاني من مشاكل أمنية؛ لذا يُنصح باستخدام الإصدار 1.1.4 أو ما بعده من المكتبة. تقدّم دوال zlib الكثير من الخيارات وغالبًا ما يجب استخدام هذه الدوال في ترتيب معين. لا ...

تنشئ الدالة البانية لهذا الصنف كائنًا يعمل كقارئ عادي ولكنّه يربط المعلومات في كل سطر بقاموس مرتّب OrderedDict تحدّد مفاتيحه بواسطة المعامل الاختياري fieldnames. البنية العامة csv.DictReader(f, fieldnames=None, restkey=None, restval=None, dialect='excel', *args, **kwds) ‎المعاملات ‎f ملف csv المراد قرائته. fieldnames معامل اختياري، وهو عبارة عن تسلسل. إن لم يُستخدم هذا المعامل فإنّ القيم الموجودة في السطر الأول من الملف المفتوح ستُستخدم كأسماء للحقول. وبصرف النظر عن طريقة تحديد أسماء الحقول فإنّ القاموس المرتّب سيحافظ دائمًا على ترتيبها الأصلي. restkey إن ...

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

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

يؤدي التابع عملية نسخ سطحية (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' ويتضمّن التسلسل الثنائي التالي جميع قيم البايتات التي تمثل الأعداد العشرية ...

تعيد موقع الإدراج الذي يأتي بعد (إلى الجانب الأيمن) العناصر المماثلة للعنصر المضاف في المصفوفة المعطاة. البنية العامة bisect.bisect_right(a, x, lo=0, hi=len(a)) المعاملات يمكن استخدام المعاملين lo و hi لتحديد جزء من القائمة، ولكن السلوك الافتراضي لهذه الدالة هو التعامل مع القائمة بأكملها. إن كان العنصر x موجودًا من قبل في القائمة a، فإنّ موقع الإدراج سيكون بعد (إلى يمين) العناصر الموجودة أصلًا. يمكن استخدام القيمة المعادة كأول معامل في التابع list.insert()‎ على افتراض أنّ القائمة a مفروزة أصلًا. القيمة ...

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