نتائج البحث

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

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

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

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

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

تدعم بايثون مجموعة من العمليات الخاصة بالتسلسلات (القوائم، والصفوف، وكائنات range، والسلاسل النصية، والبايتات ومصفوفات البايتات). العمليات التي تدعمها معظم أنواع التسلسلات يبين الجدول التالي مجموعة من العمليات المدعومة من قبل معظم أنواع التسلسلات بنوعيها القابل للتغيير (mutable) وغير القابل للتغيير (immutable). في هذا الجدول يقصد بالحرفين s و t تسلسلين لهما النوع ذاته، وتمثّل الحروف n, i, j, k أعدادًا صحيحة، وتمثل x أي كائن تنطبق عليه القيود التي تفرضها قيم أو أنواع التسلسل s. هذه العمليات مرتبة حسب ...

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

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

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

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

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

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

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

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

يضيف التابع عنصرًا إلى القائمة في الموقع الذي يحدّده المستخدم. البنية العامة l.insert() المعاملات i موقع العنصر في القائمة الأصلية والذي سيدرج التابع العنصر الجديد قبله. يدرج التعبير a.insert(0, x)‎ العنصر x في بداية القائمة، أما التعبير a.insert(len(a), x)‎ فيدرج العنصر الجديد في نهاية القائمة وبهذا يصبح عمل التابع في هذه الحالة مكافئًا لعمل التابع a.append(x)‎. x العنصر المراد إضافته إلى القائمة. القيمة المعادة يعيد هذا التابع القيمة None. أمثلة يبين المثال التالي كيفية استخدام هذا التابع لإضافة عناصر إلى ...

تعرّف هذه الوحدة واجهة معيارية لتقسيم سلاسل محدّد موقع الموارد المحدّد 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, ...

تقدّم هذه الوحدة صنفًا مفردًا هو RobotFileParser والذي يحدّد ما إذا كان بإمكان وكيل المستخدم user agent جلب عنوان URL من الموقع الإلكتروني الذي نشر ملف robots.txt. للاطلاع على المزيد من التفاصيل حول بنية ملفات robots.txt يمكن الرجوع إلى http://www.robotstxt.org/orig.html. الصنف urllib.robotparser.RobotFileParser‎ يقدّم هذا الصنف توابع لقراءة الأسئلة عن ملف robots.txt وتحليلها والإجابة عن الأسئلة المتعلّقة بها في عنوان URL المعطى. مصادر صفحة Parser for robots.txt في توثيق بايثون الرسمي.

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

يطرح التابع العناصر من الكائن المكرِّر أو من كائن mapping آخر (أو عداد آخر). البنية العامة c.subtract([iterable-or-mapping]) المعاملات iterable أو mapping الكائن المكرِّر أو كائن mapping آخر (أو عداد آخر) الذي ستُطرح منه العناصر. n إن لم يأخذ هذا المعامل أي قيمة أو أخذ القيمة None، فإنّ التابع يعيد جميع العناصر في العداد. وجدير بالذكر أنّه لا يوجد ترتيب معيّن للعناصر التي تمتلك تعدادًا متساويًا. القيمة المعادة يطرح التابع العناصر من الكائن المكرِّر أو من كائن mapping آخر (أو عداد ...

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

يعيد التابع التوجيه إلى عنوان Location:‎ أو URI:‎. يُستدعى هذا التابع بواسطة كائن OpenerDirector الأب عند الحصول على الاستجابة (moved permanently). البنية العامة HTTPRedirectHandler.http_error_301(req, fp, code, msg, hdrs) مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

تُنشئ هذه الدالة البانية معالج HTTP للطلب المعطى. لا حاجة لإنشاء نسخ من هذا الصنف بصورة مباشرة إذ أنّها تنشأ تلقائيًا حسب حاجة كائنات WSGIServer. ولكن يمكن إنشاء أصناف فرعية من هذا الصنف وتزويدها على هيئة أصناف معالجة handler_class إلى الدالة make_server()‎. البنية العامة wsgiref.simple_server.WSGIRequestHandler(request, client_address, server) ‎المعاملات request الطلب المراد إنشاء معالج HTTP له. client_address عنوان العميل، وهو عبارة عن صفّ بالصيغة (host, port). server نسخة من الصنف WSGIServer. توابع لإعادة تعريف القيم في الأصناف الفرعية get_environ()‎ يعيد التابع ...

لا يؤدي هذا التابع افتراضيًا أي وظيفة، والهدف من وجوده هو إمكانية إعادة تعريفه override بواسطة صنف فرعي. البنية العامة persistent_id(obj) إن أعاد هذا التابع القيمة None، فإنّ الكائن يُسلسَل كالمعتاد، أما القيم الأخرى فتسبّب في إطلاق المسلسل Pickler القيمة المعادة كمعرّف مستمر للكائن المعطى. يجب تحديد معنى هذه المعرّف المستمر بواسطة التابع Unpickler.persistent_load()‎. لاحظ أنّه لا يمكن للقيمة التي يعيدها التابع persistent_id()‎ أن تمتلك معرّفًا مستمرًا. راجع قسم "استمرارية الكائنات الخارجية" للاطلاع على المزيد من التفاصيل والأمثلة حول هذا ...

مصفوفات البايتات bytearray هي الكائنات القابلة للتغيير والتي تقابل كائنات البايتات bytes. يُعيد الصّنف bytearray()‎ (والذي يُعامَل مُعاملة الدّالة) مصفوفة بايتات جديدة، ويكون الصّنف تسلسُلًا قابلًا للتّغيير يحتوي على الأعداد الصّحيحة ضمن المدى ‎0 <= x < 256. ويملك مُعظم التّوابع التي تملكها التّسلسلات الأخرى (كالقوائم والصّفوف مثلًا)، والمشروحة في صفحة أنواع التسلسلات القابلة للتّغيير، إضافةً إلى امتلاك مُعظم التّوابع التي يملكها النّوع bytes. البنية العامة bytearray([source[, encoding[, errors]]]) المعاملات source مُعامل اختياريّ يُستعمل لتهيئة المصفوفة عبر عدّة طُرق مختلفة: ...

يضيف هذا التابع مجموعة من العناصر إلى نهاية القائمة. البنية العامة l.extend() المعاملات iterable كائن قابل للتكرار (قائمة، أو صف، أو مجموعة) تُضاف عناصره إلى نهاية القائمة. القيمة المعادة يعيد هذا التابع القيمة None. أمثلة يبين المثال التالي كيفية استخدام هذا التابع لإضافة عناصر إلى القائمة: >>> fruits = ['orange', 'apple', 'pear', 'banana', 'kiwi', 'apple', 'banana'] >>> summer_fruits = ['watermelon', 'honeymelon'] >>> winter_fruits = ('grapefruit', 'lemon', 'lime') >>> fruits.extend(summer_fruits) # إضافة عناصر قائمة أخرى إلى القائمة >>> fruits ['orange', 'apple', 'pear', 'banana', 'kiwi', ...

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

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

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

ينفّذ التابع أمر SQL على جميع تسلسلات المعاملات parameter sequences أو الروابط mappings الموجودة في تسلسل المعاملات المعطى. البنية العامة executemany(sql, seq_of_parameters) ‎المعاملات sql سلسلة نصية تتضمن جمل SQL المراد تنفيذها. seq_of_parameters ينفّذ التابع أمر SQL على جميع تسلسلات المعاملات parameter sequences أو الروابط mappings الموجودة في التسلسل seq_of_parameters. تسمح وحدة sqlite3 كذلك باستخدام مكرِّر ينتج معاملات بدلًا عن إنتاج تسلسل. أمثلة يبين المثال التالي طريقة استخدام التابع: import sqlite3 class IterChars: def __init__(self): ...

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

يحفظ التابع التعديلات التي أجريت على قاعدة البيانات. البنية العامة commit() ‎في حال عدم استدعاء هذا التابع ستكون جميع التعديلات التي أجريت بعد آخر استدعاء للتابع commit()‎ غير مرئية بالنسبة إلى الاتصالات الأخرى المفتوحة مع قاعدة البيانات؛ لذا إن لم تتمكن من رؤية البيانات التي أضفتها إلى قاعدة البيانات، فتأكّد من أنّك لم تنس استدعاء هذا التابع. أمثلة يبين المثال التالي آلية عمل التابع: import sqlite3 conn = sqlite3.connect('example.db') c.execute('''CREATE TABLE stocks ...

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

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

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

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

يعيد التابع center()‎ أحرف السلسلة النصية مزاحة نحو الوسط ضمن سلسلة نصّية ذات طول محدّد. البنية العامة x.center() المعاملات width يحدّد هذا المعامل طول السلسلة المعادة. fillchar يحدّد هذا المعامل الحرف الذي ستستخدمه الدالة لإجراء عملية الإزاحة، ويأخذ هذا المعامل قيمة افتراضية هي المسافة البيضاء في ترميز ASCII.  القيمة المعادة تعيد الدالة أحرف السلسلة النصية مزاحة نحو الوسط ضمن سلسلة نصّية ذات عرض محدّد، وتزاح الحروف باستخدام حرف يحدّده المستخدم. إذا كانت القيمة المحدّدة للمعامل width أقل من أو تساوي القيمة ...

يقلب التابع‎ حالة الحروف في السلسلة النصية. البنية العامة x.swapcase() القيمة المعادة يعيد التابع سلسلة نصية بعد قلب حالة الحروف فيها، أي تصبح الحروف الكبيرة صغيرة، وتصبح الحروف الصغيرة كبيرة. ملاحظة: ليس بالضرورة أن يعيد التعبير s.swapcase()‎.swapcase()‎ سلسلة نصية مطابقة للسلسلة النصية الأصلية. أمثلة يبيّن المثال التالي النتائج المعادة من تطبيق هذا التابع على السلاسل النصية: >>> str = "Python Programming Language" >>> str.swapcase() 'pYTHON pROGRAMMING lANGUAGE' انظر أيضًا السلاسل النصية في بايثون. التابع str.capitalize()‎: إعادة نسخة من السلسلة النصية مع تحويل ...

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

هذا التابع مشابه للتابع dict.update()‎ ولكنّه يضيف التعدادات بدلًا من استبدالها. البنية العامة c.update([iterable-or-mapping]) المعاملات iterable أو mapping الكائن المكرِّر أو كائن mapping آخر (أو عداد آخر) الذي ستُضاف منه العناصر. n إن لم يأخذ هذا المعامل أي قيمة أو أخذ القيمة None، فإنّ التابع يعيد جميع العناصر في العداد. وجدير بالذكر أنّه لا يوجد ترتيب معيّن للعناصر التي تمتلك تعدادًا متساويًا. القيمة المعادة عند استخدام هذا التابع يجري حساب العناصر من كائن مكرِّر أو تضاف من كائن ربط آخر ...

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

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

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

يمكن الوصول إلى البيانات المرسلة إلى المخدّم عن طريق الصنف FieldStorage، وإن كان النموذج يتضمّن حروفًا بترميز غير ترميز ASCII فيمكن استخدام المعامل المفتاحي encoding لتعيين قيمة الترميز المستخدم في الملف الحاوي على النموذج، ويمكن الوصول إلى الترميز المستخدم عادة في الوسم META في قسم HEAD من ملف HTML أو عن طريق الترويسة Content-Type). يقرأ الصنف محتويات النموذج من المدخلات القياسية أو من البيئة (بالاعتماد على قيمة عدد من متغيرات البيئة والمعيّنة حسب معايير CGI). قد يستهلك الصنف المدخلات القياسية؛ ...

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

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

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

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

يحدّد التابع ما إذا كان الكائن المعطى يتطلب تمثيلًا تعاوديًا recursive. البنية العامة PrettyPrinter.format(object, context, maxlevels, level) المعاملات object الكائن المراد تمثيله. context قاموس يحتوي على معرّف id()‎ الكائنات التي تمثّل جزءًا من سياق التمثيل الحالي (حاويات مباشرة أو غير مباشرة للكائن المعطى والتي تؤثّر على عملية التمثيل) كمفاتيح في القاموس. إن احتاج كائن معيّن إلى التنسيق وهو ممثّل ضمن السياق، فإنّ القيمة االثالثة المعادة من هذا التابع تكون True. يجب أن تضيف الاستدعاءات التعاودية للتابع format()‎ عناصر الحاويات الإضافية ...

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

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

توفر هذه الوحدة آلية محمولة لاستخدام الوظائف والأدوات التي تعتمد على نوع نظام التشغيل. ‎‎>>> import os >>> os.getcwd() '/home/username' ملاحظات تستخدم وظائِف جميع الوحدات المبنيّة في بايثون، والمعتمدة على نوع نظام التشغيل، في جميع الأنظمة المتوافرة فيها نفس الواجهة (interface). فعلى سبيل المثال، تُعيد الدالة os.stat(path)‎‎ معلومات حول المسار المُدخَل بنفس التنسيق على جميع الأنظمة التي تتوافر فيها الدالة (الواجهة المُستخدمة هنا مماثلة لتلك المُستخدمة في واجهة POSIX). تتوفر أيضًا إمكانيّة إضافة إضافات خاصة لنظام تشغيل مُعين عبر الوحدة os، ولكن ...

يعيد التابع الختم الزمني (بصيغة POSIX) الموافق لنسخة الصنف datetime. البنية العامة ‎datetime.timestamp() القيمة المعادة يعيد التابع الختم الزمني (بصيغة POSIX) الموافق لنسخة الصنف datetime. تكون النتيجة المعادة عددًا ذا فاصلة عائمة يشبه ذلك المعاد من التابع time.time()‎. يُفترض بكائنات datetime البسيطة أن تمثّل الوقت حسب التوقيت المحلّي، ويعتمد هذا التابع على دالة mktime()‎ في لغة C لإجراء عملية التحويل. ولمّا كان كائن datetime يدعم نطاقًا أوسع من القيم مقارنة بالدالة maktime()‎ في عدد من المنصّات، فإنّ هذا التابع يطلق ...

يرسل التابع طلب HTTP، والذي يمكن أن يكون من نوع GET أو POST، بالاعتماد على التابع req.has_data()‎. البنية العامة HTTPHandler.http_open(req) المعاملات req طلب HTTP المراد إرساله. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

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

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

يعيد التابع صفًّا يحتوي على جميع المجموعات الفرعية الموجودة في كائن التطابق. البنية العامة match.groups(default=None) المعاملات default يستخدم هذا المعامل لتعيين قيمة افتراضية للمجموعات غير الموجودة في حالة التطابق، ويأخذ القيمة الافتراضية None. القيمة المعادة يعيد التابع صفًّا يحتوي على جميع المجموعات الفرعية الموجودة في كائن التطابق، بدءًا من المجموعة رقم 1 وانتهاءً بعدد المجموعات الفرعية الموجودة في التعبير النمطي. أمثلة يبين المثال التالي النتائج المعادة من هذا التابع: >>> m = re.match(r"(\d+)\.(\d+)", "24.1632") >>> m.groups() ('24', '1632') إن جعلنا النقطة العشرية ...

يعيد التابع نسخة من صنف Cursor أو أحد أصنافه الفرعية. البنية العامة cursor(factory=Cursor) ‎المعاملات factory يأخذ هذا التابع معاملًا اختياريًا واحدًا، وعند تعيينه يجب أن يكون كائنًا قابلًا للاستدعاء callable يعيد نسخة من صنف Cursor أو أحد أصنافه الفرعية. القيمة المعادة يعيد التابع نسخة من صنف Cursor أو أحد أصنافه الفرعية. أمثلة يبين المثال التالي آلية عمل التابع: import sqlite3 conn = sqlite3.connect('example.db') c = conn.cursor() مصادر صفحة DB-API 2.0 interface for SQLite databases في توثيق بايثون الرسمي.

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

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

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

وظيفة هذا الصنف هي قراءة ملفات الأرشيف من نوع tar والكتابة فيها. لا تستخدم هذا الصنف مباشرة، بل استخدم الدالة tarfile.open()‎ عوضًا عنه. يقدّم كائن TarFile واجهة لملفات الأرشيف من نوع tar. يتكوّن أرشيف tar من تسلسل من الكتل، ويتكوّن عضو الأرشيف (الملفّ المخزّن) من كتلة الترويسة header block متبوعة بكتل البيانات. يمكن تخزين ملف معيّن في أرشيف tar عدّة مرات، ويُمثّل كل عضو في الأرشيف بواسطة كائن TarInfo (راجع قسم كائنات TarInfo للمزيد من التفاصيل). يمكن استخدام كائن TarFile ...

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

المجموعة (set) هي مجموعة من الكائنات غير المرتّبة وغير المكرّرة وغير القابلة للتعديل (immutable). تستخدم المجموعات عادة لاختبار وجود العناصر وللتخلص من المدخلات المكرّرة. تدعم كائنات المجموعات العمليات الرياضية مثل الاتحاد (union)، التقاطع (intersection)، الاختلاف (difference)، والاختلاف المتناظر (symmetric difference) (راجع عمليات المجموعات في بايثون). إنشاء مجموعة جديدة تستخدم الأقواس المعقوفة {} أو الدالة set()‎ لإنشاء مجموعة جديدة: >>> basket = {'apple', 'orange', 'apple', 'pear', 'orange', 'banana'} >>> print(basket)                      # تحذف ...

يعيد التابع العدد الترتيبي للتاريخ الذي يمثّله كائن datetime حسب التقويم التنبّؤي الكريكوري. البنية العامة ‎datetime.toordinal() القيمة المعادة يعيد التابع العدد الترتيبي للتاريخ الذي يمثّله كائن datetime حسب التقويم التنبّؤي الكريكوري، حيث يحمل تاريخ الأول من كانون الثاني سنة 1 ميلادية العدد 1. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import datetime >>> dt = datetime(2018, 6, 26, 11, 42, 10) >>> dt.toordinal() 736871 انظر أيضًا التابع Python/datetime/datetime/fromordinal‎: يعيد التابع كائن datetime الذي يتضمن التاريخ والوقت الموافقين للعدد الترتيبي في ...

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

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

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

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

يؤدي هذا التابع عملية نسخ سطحية (shallow copy) للمجموعة. البنية العامة copy() القيمة المعادة يعيد التابع مجموعة جديدة وهي عبارة عن نسخة سطحية عن المجموعة الأصلية. أمثلة يبين المثال التالي النتائج المعادة من تطبيق التابع: >>> x = {1, 2, 3, 4, 5} >>> y = x.copy() >>> y {1, 2, 3, 4, 5} انظر أيضًا المجموعات في بايثون. مصادر قسم copy في صفحة Types في توثيق بايثون الرسمي.

يعيد التابع نسخة من صنف Cursor أو أحد أصنافه الفرعية. البنية العامة cursor(factory=Cursor) ‎المعاملات factory يأخذ هذا التابع معاملًا اختياريًا واحدًا، وعند تعيينه يجب أن يكون كائنًا قابلًا للاستدعاء callable يعيد نسخة من صنف Cursor أو أحد أصنافه الفرعية. القيمة المعادة يعيد التابع نسخة من صنف Cursor أو أحد أصنافه الفرعية. أمثلة يبين المثال التالي آلية عمل التابع: import sqlite3 conn = sqlite3.connect('example.db') c = conn.cursor() مصادر صفحة DB-API 2.0 interface for SQLite databases في توثيق بايثون الرسمي.

يعيد التابع البيانات الخاصة بالسنة المعطاة، وتكون البيانات جاهزة للتنسيق، وتكون العناصر في قوائم الأسابيع عبارة عن صفوف تتضمّن أعداد الأيام. البنية العامة yeardayscalendar(year, width=3) المعاملات year السنة المطلوبة. width يحدّد الحد الأقصى للشهور في كل صفّ، ويأخذ القيمة 3 كقيمة افتراضية. القيمة المعادة يعيد التابع البيانات الخاصة بالسنة المعطاة، وتكون البيانات جاهزة للتنسيق (كما هو الحال مع التابع yeardatescalendar()‎). العناصر في قوائم الأسابيع عبارة عن صفوف تتضمّن أعداد الأيام. وتأخذ الأيام التي تكون خارج نطاق هذا الشهر القيمة 0. ...

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

يحوّل التابع اسم الخيار المعطى وكما هو موجود في ملف الإعدادات أو كما هو ممرّر إلى التابع عن طريق الشيفرة التي يكتبها المستخدم إلى الصيغة التي يجب استخدامها في البنية الداخلية لملفات الإعدادات. البنية العامة optionxform(option) ‎المعاملات option المعامل الذي سيحوّله التابع إلى صيغة ملفات الإعدادات. القيمة المعادة تعيد طريقة التنفيذ الافتراضية لهذا التابع اسم الخيار بعد تحويل جميع الحروف إلى أحرف صغيرة، ويمكن إعادة تعريف هذا التابع باستخدام أصناف فرعية ويمكن للمبرمج أن يعين خاصية لهذا الاسم في نسخ ...

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

التابع linecache.lazycache يحصل هذا التابع على المعلومات الكافية عن وحدة غير معتمدة على الملف" non-file-based" بحيث تكون جاهزة لقراءة أسطرها لاحقًا باستخدام التابع getline حتى لو كان المعامل module_globals غير مُسند ضمن معاملات getline، مما يسمح بتجنب عمليات الكتابة والقراءة إلى حين وجود حاجة حقيقية دون الحاجة إلى الاحتفاظ بالمعامل module_globals ضمن الشيفرة البرمجية. البنية العامة linecache.lazycache(filename, module_globals) المعاملات المعامل filename اسم الملف المُراد وضعه بالكاش بطريقة كسولة. المعامل module_globals قاموس (dict) يحتوي على مفتاحين __name__ و __loader__ يُستخدمان ضمن ...

هذا التابع خاص بالقواميس المرتّبة ويحذف ويعيد زوج (مفتاح، قيمة) من القاموس المرتب. البنية العامة od.‎popitem(last=True) المعاملات last قيمة منطقية، ويأخذ هذا المعامل القيمة الافتراضية True. إن أخذ المعامل قيمة True، فإنّ الأزواج تعاد بالترتيب (آخر الداخلين هو أول الخارجين last-in, first-out يعرف اختصارًا بـ LIFO)، وإن أخذ القيمة False، فإنّ الأزواج تعاد بالترتيب (أول الداخلين هو أول الخارجين first-in, first-out يعرف اختصارًا بـ FIFO). القيمة المعادة يعيد التابع زوج (مفتاح، قيمة) المحذوف من القاموس المرتب. أمثلة يبين المثال التالي ...

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

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

يعيد التابع تقويم السنة المعطاة على هيئة جدول HTML. البنية العامة formatyear(theyear, width=3) المعاملات theyear السنة المطلوبة. width يحدّد المعامل (والذي يأخذ القيمة الافتراضية 3) عدد الأشهر في كل صفّ من صفوف الجدول المعاد. القيمة المعادة سلسلة نصية تتضمّن تقويم السنة المطلوبة بهيئة جدول HTML. أمثلة يبين المثال التالي آلية عمل التابع: >>> from calendar import HTMLCalendar >>> cal = HTMLCalendar() >>> cal.formatyear(2018) '<table border="0" cellpadding="0" cellspacing="0" class="year">\n<tr><th colspan="3" class="year">2018</th></tr><tr><td><table border="0" cellpadding="0" cellspacing="0" class="month">\n<tr><th colspan="7" class="month">January</th></tr>\n<tr><th class="mon">Mon</th><th class="tue">Tue</th><th class="wed">Wed</th><th class="thu">Thu</th><th class="fri">Fri</th><th class="sat">Sat</th><th class="sun">Sun</th></tr>\n<tr><td ...

يبدّل هذا التابع العبارة التي يختارها المستخدم - مهما تكرّرت في تسلسل البيانات الثنائية - إلى القيمة الجديدة التي يحدّدها. البنية العامة str.replace(old, new[, count]) المعاملات old كائن شبيه بالبايتات يمثّل التسلسل الفرعي الفرعية المراد استبداله. new كائن شبيه بالبايتات يمثّل التسلسل الفرعي الذي سيحلّ محلّ التسلسل القديم. count معامل اختياري، وفي حال تمريره تجري الدالة عمليات استبدال بالعدد المحدّد في هذا المعامل فقط. القيمة المعادة يعيد التابع نسخة من التسلسل الأصلي بعد استبدال التسلسل الفرعي الذي يحدّده المستخدم - ...

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

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

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

يؤدي استدعاء هذا التابع إلى معالجة جميع المدخلات المعلّقة، ويعيد كائن bytes يتضمّن ما تبقّى من مخرجات غير مضغوطة. البنية العامة Decompress.flush([length]) المعاملات length معامل اختياري يحدّد الحجم الابتدائي لذاكرة المخرجات output buffer. لا يمكن استدعاء التابع decompress()‎ مرة أخرى بعد استدعاء التابع flush()‎، وما يمكن فعله في هذه الحالة هو حذف الكائن فقط. القيمة المعادة يعيد التابع كائن bytes يتضمّن ما تبقّى من مخرجات غير مضغوطة. انظر أيضًا التابع Compress.flush()‎: يؤدي استدعاء هذا التابع إلى معالجة جميع المدخلات المعلّقة، ...

يضيف التابع الملف المعطى إلى ملف الأرشيف. البنية العامة ZipFile.write(filename, arcname=None, compress_type=None, compresslevel=None) ‎المعاملات ‎filename اسم الملف المراد إضافته إلى الأرشيف. arcname الاسم الذي يعطيه التابع للملف المضاف إلى الأرشيف. القيمة الافتراضية لهذا المعامل هي نفس قيمة المعامل filename ولكن مع حذف اسم محرّك الأقراص والفواصل الموجودة في بداية المسار compress_type معامل اختياري تعيد قيمته تعريف القيمة المحدّدة للمعامل compression في الدالة البانية لكائنات ZipFile. compresslevel معامل اختياري تعيد قيمته تعريف القيمة المقابلة لها في الدالة البانية. ملاحظات: يجب فتح ...

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

يجري هذا التابع عملية تبادل بايتات byteswap لجميع عناصر المصفوفة. البنية العامة ‎array.byteswap() القيمة المعادة يعمل هذا التابع مع القيم التي تكون بحجم 1 أو 2 أو 4 أو 8 بايت، ويطلق الخطأ RuntimeError مع الأنواع الأخرى من القيم. تظهر فائدة هذا التابع عند قراءة بيانات من ملف كُتب على جهاز آخر ذي ترتيب بايتات مختلف. أمثلة يبين المثال التالي آلية عمل التابع: >>> import array >>> a1 = array.array('l', [1, 2, 3, 4, 5]) >>> a1 array('l', [1, 2, 3, 4, 5]) >>> ...

تابع مساعد وظيفته تحويل الخيار المعطى في القسم المحدّد إلى قيمة منطقية (بوليانية). البنية العامة getboolean(section, option, *, raw=False, vars=None[, fallback]) ‎المعاملات ‎راجع التابع get()‎ للمزيد من التفاصيل حول المعاملات raw و vars و fallback. القيمة المعادة يعيد التابع قيمة الخيار الذي يجلبه بعد تحويله إلى قيمة منطقية (بوليانية). أمثلة يبين المثال التالي طريقة عمل التابع: >>> import configparser >>> config = configparser.ConfigParser() >>> config.read('config.cfg') ['config.cfg'] >>> config.getboolean('topsecret.server.com', 'ForwardX11') False >>> config.getboolean('topsecret.server.com', 'Compression') True انظر أيضًا التابع get()‎: يجلب التابع الخيار المحدّد من القسم المعطى. التابع getint()‎: ...

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

يحوّل هذا التابع الحروف في السلسلة النصية إلى حروف كبيرة. البنية العامة x.upper() القيمة المعادة يعيد التابع نسخة من السلسلة النصية تكون فيها جميع الحروف التي تمتلك أكثر من حالة حروفًا كبيرة. ملاحظة: قد يعيد التعبير str.upper().isupper()‎ القيمة False إذا تضمنّت السلسلة النصية حروفًا لا تمتلك أكثر من حالة، أو إذا لم تكن الحروف الناتجة ضمن فئة "Lu" في الترميز الموحد ولكن كانت ضمن فئة "Lt". أمثلة يبين المثال التالي النتائج المعادة من تطبيق هذا التابع على سلاسل نصية متنوّعة: ...

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

يدرج التابع القيمة المعطاة في الكائن deque في الموقع المحدّد. البنية العامة d.insert(i, x) المعاملات x العنصر المراد إدراجه في كائن deque. i الموقع الذي يدرج فيه التابع القيمة x في الكائن deque. القيمة المعادة إن أدّت عملية الإضافة إلى تجاوز الحد الأقصى للكائن deque والمقرّر عن طريق الخاصية maxlen، فإنّ التابع يطلق الخطأ IndexError. أمثلة يبين المثال التالي آلية عمل التابع. >>> from collections import deque >>> d = deque([1, 3, 4, 5, 6]) >>> d.insert(1, 2) >>> d deque([1, 2, 3, 4, ...

يعالج التابع طلب الاستيثاق عن طريق الحصول على زوج اسم المستخدم/كلمة المرور، وإعادة الطلب مرة أخرى. البنية العامة AbstractBasicAuthHandler.http_error_auth_reqed(authreq, host, req, headers) المعاملات authreq يجب أن يكون اسم الترويسة حيث تكون المعلومات المتعلّقة بالحقل مضمّنة في الطلب. host يحدّد عنوان URL والمسار الذي ستُجرى فيه عملية الاستيثاق. إما أن يكون سُلطة authority (مثل: "python.org") أو عنوان URL يتضمّن مكوّن سُلطة (مثل "http://python.org/‎"). في كلا الحالتين يجب أن تتضمّن السُّلطة مكوّن معلومات المستخدم userinfo (لذا لا بأس باستخدام "python.org" و "python.org:80" ...

يتحقّق التابع ممّا إذا كانت جميع الحروف في السلسلة النصية حروفًا عددية، وأنّ هناك حرفًا واحدًا على الأقل في تلك السلسلة. البنية العامة x.isnumeric() القيمة المعادة يعيد هذا التابع القيمة True إذا كانت جميع الحروف في السلسلة النصية حروفًا عددية، وكان هناك على الأقل حرف واحد في السلسلة، ويعيد القيمة False فيما عدا ذلك. يقصد بالحروف العددية الأعداد وجميع الحروف التي تمتلك خاصية قيمة عددية في الترميز الموحّد، مثل U+2155 والذي يرمز إلى الكسر VULGAR FRACTION ONE FIFTH.  وبصورة عامة، ...

تعدّ ملفات ZIP من ملفات الأرشفة والضغط الأكثر شيوعًا. تقدّم هذه الوحدة أدواة لإنشاء ملفات ZIP والقراءة منها والكتابة فيها وإلحاق الملفات بها وعرض محتوياتها. يتطلّب الاستخدام المتقدّم لهذه الوحدة فهمًا جيّدًا لصيغة الملفات ZIP والمعرّفة في دليل التطبيق PKZIP. لا تتعامل هذه الوحدة في الوقت الحاضر مع ملفات ZIP متعددة الأقراص، ولكن يمكنها التعامل مع ملفات ZIP التي تستخدم الإضافة ZIP64 (أي ملفات ZIP التي يتجاوز حجمها ‎4 GiB). يمكن استخدام الوحدة كذلك لفكّ التعمية عن الملفات المعمّاة encrypted ...

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

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

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

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

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