نتائج البحث

تقدّم هذه الوحدة عددًا من الدوال المساعدة لإنشاء أنواع بيانات جديدة بصورة ديناميكية، إضافة إلى أنّها تعرّف أسماءً لبعض أنواع الكائنات التي يستخدمها مفسّر بايثون المعياري، ولكنّها ليست كائنات داخلية مثل int أو str، إلى جانب أنّ هذه الوحدة تقدم بعض الأصناف والدوال المساعدة الخاصة ببعض الأنواع، والتي لا تعدّ أساسية بما يكفي لتصبح أصنافًا ودوالّ داخلية. إنشاء الأنواع ديناميكيًا تقدّم هذه الوحدة ثلاث دوالّ تساعد في إنشاء أنواع البيانات ديناميكيًا: الدالة types.new_class()‎‎ تنشئ هذه الدالة ديناميكيًا كائن صنف باستخدام ...

تعيد الدّالة type()‎ نوع الكائن المُعطى إن مُرّر مُعامل واحد لها. وتعيد كائن نوعٍ (type object) جديد إن مُرّرت لها ثلاثة مُعاملات. البنية العامة type(object) type(name, bases, dict) المعاملات تقبل الدّالة type()‎ إمّا مُعاملًا واحدًا فقط، أو ثلاثة مُعاملات كما هو واضح في البنية العامّة أعلاه. عند استدعائها بمُعامل واحد فقط، ستُعيد الدّالة نوع الكائن المُمرّر. أمّا عند الاستدعاء بثلاثة مُعاملات، فسيُعاد كائن نوعٍ جديد. وهو طريقة ديناميكيّة لإنشاء الأصناف كبديل للجملة class. object عند استدعائها بمُعامل واحد فقط، يُمثّل هذا ...

الصنف الزائف ‎:first-of-type في CSS (أي pseudo-class) يُمثِّل أوّل عنصر من نوعه في مجموعة من العناصر الأخوة. p:first-of-type { color: red; } ملاحظة: عندما عُرِّف هذا الصنف كان من الضروري أن يملك العنصر أبًا، لكن بدءًا من مواصفة Selectors Level 4 لم يعد ذلك ضروريًا. الشكل العام لهذا المحدد: :first-of-type أمثلة لاحظ كيف ستُنسَّق أوّل فقرة <p> من بين العناصر الأخوة: <h2>الترويسة</h2> <p>النص 1</p> <p>النص 2</p> شيفرة CSS: p:first-of-type { color: red; font-style: italic; } لاحظ كيف يمكن استخدام هذا المُحدِّد على العناصر المتشعبة، ...

الصنف الزائف ‎:nth-of-type()‎ في CSS (أي pseudo-class) يُطابِق عنصرًا أو أكثر من نوعٍ معيّن بناءً على موقعه ضمن مجموعة من العناصر الأخوة (siblings). هذا المُحدِّد يُحدِّد جميع عناصر <p> التي ترتيبها هو الرابع ضمن أي مجموعة من الأخوة: p:nth-of-type(4n) { color: lime; } يقبل هذا الصنف الزائف وسيطًا واحدًا يمُثِّل نمط مُطابقة العناصر: الكلمة المحجوزة odd تُمثِّل العناصر التي يكون ترتيبها بين إخوتها فرديًا، أي 1 و 3 و 5 ...إلخ. ويبدأ العد من البداية إلى النهاية. الكلمة المحجوزة even تُمثِّل ...

الصنف الزائف ‎:last-of-type في CSS (أي pseudo-class) يُمثِّل آخر عنصر من نوعه في مجموعة من العناصر الأخوة. p:last-of-type { color: lime; } ملاحظة: عندما عُرِّف هذا الصنف كان من الضروري أن يملك العنصر أبًا، لكن بدءًا من مواصفة Selectors Level 4 لم يعد ذلك ضروريًا. الشكل العام لهذا المحدد: :last-of-type أمثلة لاحظ كيف ستُنسَّق آخر فقرة <p> من بين العناصر الأخوة: <h2>الترويسة</h2> <p>النص 1</p> <p>النص 2</p> شيفرة CSS: p:last-of-type { color: red; font-style: italic; } لاحظ كيف يمكن استخدام هذا المُحدِّد على العناصر المتشعبة، ...

الصنف الزائف ‎:nth-last-of-type()‎ في CSS (أي pseudo-class) يُطابِق عنصرًا أو أكثر من نوعٍ معيّن بناءً على موقعه ضمن مجموعة من العناصر الأخوة (siblings). بدءًا من النهاية إلى البداية. هذا المُحدِّد يُحدِّد جميع عناصر <p> التي ترتيبها هو الرابع ضمن أي مجموعة من الأخوة، والعد يبدأ من النهاية: p:nth-last-of-type(4n) { color: lime; } ملاحظة: هذا الصنف الزائف يماثل الصنف ‎:nth-of-type إلا أنه يبدأ عدّ العناصر من النهاية إلى البداية، عكس الصنف ‎:nth-of-type الذي يبدأ العد من البداية إلى النهاية. رجع صفحة الصنف ...

الخاصية list-style-type في CSS تُحدِّد شكل الإشارة إلى عناصر القائمة. بطاقة الخاصية القيمة الابتدائية disc تُطبَّق على عناصر القوائم. قابلة للوراثة نعم قابلة للتحريك لا القيمة المحسوبة كما حُدِّدَت. /* قائمة مختصرة بأنواع الأشكال */ list-style-type: disc; list-style-type: circle; list-style-type: square; list-style-type: decimal; list-style-type: arabic-indic; /* <string> */ list-style-type: '-'; /* @counter-style rule */ list-style-type: custom-counter-style; list-style-type: none; /* القيم العامة */ list-style-type: inherit; list-style-type: initial; list-style-type: unset; ملاحظة: هذه الخاصية ستُطبَّق على عناصر القوائم، أي العناصر التي تكون قيمة الخاصية display فيها تساوي list-item، وهذا يتضمن العنصر <li> افتراضيًا؛ لكن لاحظ أنَّ قيمة ...

نوع البيانات الوصف angle نوع البيانات <angle> في CSS يستعمل لتمثيل القيم الزاويّة بالدرجات (degrees) أو بالغراد (grad) أو بالراديان (radians) أو بالدورات (turns)، ويمكن استخدام هذا النوع في التدرجات اللونية <gradient> وبعض دوالtransform. blend-mode نوع البيانات <blend-mode> في CSS يستعمل لوصف كيف يجب أن تمتزج الألوان عند تداخل طبقات الخلفات مع بعضها بعضًا. فلكل بكسل من بكسلات الطبقة التي طُبِّق عليها نمط الامتزاج، فسيأخذ اللون من الخلفية ومن الأمامية، وستُجرى عملية حسابية عليه، ويُعاد لونٌ جديدٌ سيستخدم مكان تداخل الطبقات. color value نوع البيانات <color> في CSS ...

المحدد ()‎:nth-of-type الوصف يختار هذا المحدِّد عناصر ذات موقع محدد ضمن مجموعة من العناصر الأخوة (أي جميعها أبناء لعناصر أخرى) التي لها اسم العنصر ذاته. jQuery( ":nth-of-type(index/even/odd/equation)" )‎ أُضيف مع الإصدار: 1.9. index فهرس العنصر الابن المراد مطابقته، ويبدأ العد من القيمة 1 بدءًا من بداية المجموعة (أي فهرس أول عنصر في المجموعة هو 1). ويمكن استعمال الكلمة المحجوزة even التي تُمثِّل العناصر التي يكون ترتيبها بين إخوتها فرديًا، أو الكلمة المحجوزة odd التي تُمثِّل العناصر التي يكون ترتيبها بين ...

المحدد ()‎:nth-last-of-type الوصف يختار هذا المحدِّد عناصر ذات موقع محدَّد ضمن مجموعة من العناصر الأخوة (أي جميعها أبناء لعناصر أخرى) التي لها اسم العنصر ذاته وذلك بدءًا من نهاية المجموعة وحتى بدايتها. jQuery( ":nth-last-of-type(index/even/odd/equation)" )‎ أُضيف مع الإصدار: 1.9. index فهرس العنصر الابن المراد مطابقته، ويبدأ العد من القيمة 1 بدءًا من نهاية المجموعة (أي فهرس آخر عنصر في المجموعة هو 1). ويمكن استعمال الكلمة المحجوزة even التي تُمثِّل العناصر التي يكون ترتيبها بين إخوتها فرديًا، أو الكلمة المحجوزة odd ...

إن كلَّ عنصرٍ في Kotlin يعد كائنًا إذ يمكن استدعاء الدوال (member functions) والخاصّيّات (properties) عبر أي متغيِّر (variable)، ولبعض الأنواع تمثيلها الداخلي الخاص بها؛ فعلى سبيل المثال تُمثَّل الأعداد والمحارف والقيم المنطقية (boolean) كقيمٍ أساسيّةٍ أثناء التشغيل (runtime) ولكنها بالنسبة للمستخدم مجرّد أصنافٍ عادية، وتناقش هذه الصفحة الأنواع الرئيسيّة للبيانات في Kotlin وهي: الأعداد، والمحارف، والقيم المنطقية (boolean)، والمصفوفات، والسلاسل النصيّة. الأعداد (Numbers) تتعامل لغة Kotlin مع البيانات العدديّة بطريقةٍ مماثلةٍ للغة Java ولكن بفوارق بسيطة، فلا تدعم مثلًا ...

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

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

تعيد الدّالة super()‎ كائنًا وسيطًا يُفوّض استدعاءات التّوابع إلى صنف أبٍ أو صنف شقيق للصّنف الذي استُدعيَت منه الدّالة. هذا مُفيد للوصول إلى التّوابع الموروثة التي أعيدت كتابتها في صنف مُعيّن. ترتيب البحث يكون هو نفسه التّرتيب المُستخدم من طرف الدّالة getattr()‎ لكنّ النّوع type‎ المُعطى يُتجاهَل. البنية العامة super([type[, object-or-type]]) المعاملات type النّوع الذي ستقوم الدّالة super()‎ بتفويض استدعاءات التّوابع إلى صنف أبٍ أو صنف شقيق له. تعرض الخاصيّة __mro__ الخاصّة بالصّنف type ترتيب البحث عن التوابع (method resolution ...

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

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

تنشئ هذه الدالة ديناميكيًا كائن صنف باستخدام صنف ميتا (metaclass) المناسب. ملاحظة: هذه الدالة جديدة في الإصدار 3.3 من اللغة. البنية العامة ‎types.new_class(name, bases=(), kwds=None, exec_body=None) المعاملات name اسم الصنف المراد إنشاؤه. bases الأصناف الأساسية التي سيرث منها الصنف الجديد (حسب الترتيب). kwds المعاملات المفتاحية (مثل صنف ميتا). exec_body استدعاء خلفي callback يُستخدم لإضافة نطاق الأسماء الخاصّ بالصنف المنشئ حديثًا. يجب أن يأخذ نطاق الأسماء الخاصّ بالصنف كمعامل وحيد وأن يحدّث نطاق الأسماء مباشرة بمحتويات الصنف. في حال عدم تقديم ...

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

تحسب هذه الدالة صنف ميتا المناسب وتنشئ نطاق الأسماء. البنية العامة types.prepare_class(name, bases=(), kwds=None) المعاملات name اسم الصنف المراد إنشاؤه. bases الأصناف الأساسية التي سيرث منها الصنف الجديد (حسب الترتيب). kwds المعاملات المفتاحية (مثل صنف ميتا). القيمة المعادة تعيد الدالة صفًّا يحمل ثلاث قيم هي: metaclass, namespace, kwds. metaclass هي صنف ميتا المناسب، و namespace هي نطاق الأسماء المحضّر للصنف، وkwds هي نسخة محدّثة من قيمة المعامل kwds بعد حذف أي مدخل من مدخلات 'metaclass'. وإن لم يمرّر المعامل kwds ...

تعيد الدالة كائن 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) ...

تدعم لغة Kotlin ميّزة التسمية البديلة للأنواع الموجودة للبيانات، وخاصّة إن كان اسم النوع طويلًا فيُستعاض عنه باسمٍ أقصرٍ ويُستخدَم الاسم الجديد في كتابة الشيفرات؛ فمن المفيد مثلًا تسمية الأنواع المُعمّمة (generics) بأسماء أقصرٍ، مثل الشيفرة الآتية المُستخدَمة لتسمية أنواع المجموعات (collections): typealias NodeSet = Set<Network.Node> typealias FileTable<K> = MutableMap<K, MutableList<File>> وبالإمكان أيضًا تسمية الأنواع المختلفة للدوال، مثل: typealias MyHandler = (Int, String, Any) -> Unit typealias Predicate<T> = (T) -> Boolean وكذلك الأمر بالنسبة للأصناف الداخليّة (inner classes) والمتداخلة (nested classes)، مثل: class ...

تحلّل الدالة المدخلات من نوع multipart/form-data (للملفات المرفوعة). البنية العامة cgi.parse_multipart(fp, pdict, encoding="utf-8", errors="replace") المعاملات fp الملف المُدخل. pdict قاموس يحتوي على المعاملات في ترويسة Content-Type. encoding ترميز الطلب. ملاحظة: أضيف المعاملان encoding و errors في الإصدار 3.7 من بايثون. كذلك أصبحت القيمة المعادة للحقول التي لا تتضمن ملفّات قائمة من السلاسل النصية وليس من كائنات bytes. القيمة المعادة تعيد الدالة قاموسًا مشابهًا للقاموس الذي تعيده الدالة urllib.parse.parse_qs()‎. مفاتيح هذا القاموس هي أسماء الحقول في النموذج، وكلّ قيمة في القاموس ...

تسجّل الدالة كائنًا قابلًا للاستدعاء callable لتحويل سلسلة بايتات نصية من قاعدة البيانات إلى نوع خاص من أنواع بيانات بايثون. البنية العامة sqlite3.register_adapter(type, callable) المعاملات type نوع بيانات بايثون الذي ستحوّله الدالة إلى إحدى الأنواع التي تدعمها قواعد بيانات SQLite. callable كائن قابل للاستدعاء يأخذ معاملًا واحدًا هو نوع بيانات بايثون، ويجب أن يعيد إحدى الأنواع التالية: int أو float أو str أو bytes. انظر أيضًا الدالة register_converter()‎: تسجّل الدالة كائنًا قابلًا للاستدعاء callable لتحويل سلسلة بايتات نصية من قاعدة ...

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

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

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

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

يحذف التابع جميع عناصر القاموس. البنية العامة dict.clear() أمثلة يبين المثال التالي النتائج المعادة من تطبيق التابع: >>> sphere = {"x": 2, "y": 3, "z": 1} >>> sphere {'x': 2, 'y': 3, 'z': 1} >>> sphere.clear() >>> sphere {} انظر أيضًا القواميس في بايثون. التابع dict.pop()‎: حذف المفتاح المحدد في المعاملات من القاموس. التابع dict.popitem()‎: حذف زوج (مفتاح، قيمة) عشوائيًا من القاموس. مصادر قسم clear في صفحة Types في توثيق بايثون الرسمي.

يؤدي التابع عملية نسخ سطحية (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 في توثيق بايثون الرسمي.

ترمّز الدالة كائن bytes إلى سلسلة نصية تتضمن عددين ستّ عشريين مقابل كلّ بايت. البنية العامة hex() القيمة المعادة تعيد الدالة سلسلة نصية تتضمّن عددين ستّ عشريين مقابل كلّ بايت. أمثلة يبين المثال التالي النتائج المعادة من تطبيق الدالة: >>> bytes = b'\xf0\xf1\xf2' >>> bytes.hex() 'f0f1f2' انظر أيضًا الدالة bytes.fromhex()‎: فك ترميز سلسلة نصية تتضمن أعداد ست عشرية إلى كائن bytes. مصادر قسم hex في صفحة Types في توثيق بايثون الرسمي.

ترمّز الدالة كائن bytes إلى سلسلة نصية تتضمن عددين ستّ عشريين مقابل كلّ بايت. البنية العامة hex() القيمة المعادة تعيد الدالة سلسلة نصية تتضمّن عددين ستّ عشريين مقابل كلّ بايت. أمثلة يبين المثال التالي النتائج المعادة من تطبيق الدالة: >>> bytes = b'\xf0\xf1\xf2' >>> bytes.hex() 'f0f1f2' انظر أيضًا الدالة bytes.fromhex()‎: فك ترميز سلسلة نصية تتضمن أعداد ست عشرية إلى كائن bytes. مصادر قسم hex في صفحة Types في توثيق بايثون الرسمي.

يعيد التابع عرضًا جديدًا يتضمّن جميع مفاتيح القاموس. البنية العامة dict.keys() القيمة المعادة يعيد التابع عرضًا جديدًا يتضمّن جميع مفاتيح القاموس. أمثلة يبين المثال التالي نتيجة تطبيق التابع على قاموس: >>> employee = {'first-name': 'Ahmed', 'last-name': 'Jamil', 'age': 28} >>> employee.keys() dict_keys(['first-name', 'last-name', 'age']) انظر أيضًا القواميس في بايثون. كائنات العرض في بايثون. التابع dict.values()‎: عرض قيم المفاتيح الخاصة بالقاموس. مصادر قسم keys في صفحة Types في توثيق بايثون الرسمي.

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

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

يعيد التابع عرضًا جديدًا لعناصر القاموس بهيئة (مفتاح، قيمة). البنية العامة dict.items() القيمة المعادة يعيد التابع عرضًا جديدًا لعناصر القاموس بهيئة (مفتاح، قيمة). أمثلة يبين المثال التالي نتيجة تطبيق التابع على قاموس: >>> employee = {'first-name': 'Ahmed', 'last-name': 'Jamil', 'age': 28} >>> employee.items() dict_items([('first-name', 'Ahmed'), ('last-name', 'Jamil'), ('age', 28)]) انظر أيضًا القواميس في بايثون. كائنات العرض في بايثون. التابع dict.values()‎: عرض قيم المفاتيح الخاصة بالقاموس. مصادر قسم items في صفحة Types في توثيق بايثون الرسمي.

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

يحذف التابع عنصرًا واحدًا من المجموعة إن كان موجودًا فيها. البنية العامة 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 في صفحة ...

يعيد التابع تاريخ اليوم الحالي ضمن الإعدادات المحلية. البنية العامة ‎date.today() القيمة المعادة يعيد التابع تاريخ اليوم الحالي ضمن الإعدادات المحلية. أمثلة يبين المثال التالي القيمة المعادة من استخدام التابع: >>> from datetime import date >>> today = date.today() >>> print(today) 2018-06-25 انظر أيضًا التابع date.fromtimestamp()‎ : يعيد هذا التابع التاريخ المحلي المرتبط بالختم الزمني ذي الصيغة POSIX. التابع date.fromordinal()‎: يعيد هذا التابع التاريخ بحسب العدد الترتيبي المعطى والتابع للتقويم الكريكوري التنبؤي. مصادر قسم date Objects في صفحة Basic date and time types في توثيق ...

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

هذه الدالة مهملة في هذه الوحدة، وهي موجودة لغرض التوافق مع الإصدارات السابقة من بايثون. استخدم الدالة urllib.parse.parse_qs()‎ عوضًا عنها.  البنية العامة cgi.parse_qs(qs, keep_blank_values=False, strict_parsing=False) انظر أيضًا الدالة cgi.parse()‎: تحلّل الدالة الاستعلام الموجود في بيئة معينة أو في ملف معيّن. الدالة cgi.parse_qsl()‎: هذه الدالة مهملة في هذه الوحدة، وهي موجودة لغرض التوافق مع الإصدارات السابقة من بايثون. استخدم الدالة urllib.parse.parse_qsl()‎‎ عوضًا عنها. الدالة cgi.parse_multipart()‎: تحلّل الدالة المدخلات من نوع multipart/form-data (للملفات المرفوعة). الدالة cgi.parse_header()‎: تحلّل الدالة ترويسة MIME (مثل Content-Type) إلى قيمة ...

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

تحلّل الدالة ترويسة MIME (مثل Content-Type) إلى قيمة رئيسة وقاموسٍ من المعاملات. البنية العامة cgi.parse_header(string) المعاملات string ترويسة MIME. انظر أيضًا الدالة cgi.parse()‎: تحلّل الدالة الاستعلام الموجود في بيئة معينة أو في ملف معيّن. الدالة cgi.parse_qs()‎: هذه الدالة مهملة في هذه الوحدة، وهي موجودة لغرض التوافق مع الإصدارات السابقة من بايثون. استخدم الدالة urllib.parse.parse_qs()‎ عوضًا عنها.  الدالة cgi.parse_qsl()‎: هذه الدالة مهملة في هذه الوحدة، وهي موجودة لغرض التوافق مع الإصدارات السابقة من بايثون. استخدم الدالة urllib.parse.parse_qsl()‎‎ عوضًا عنها. الدالة cgi.parse_multipart()‎: ...

هذه الدالة مهملة في هذه الوحدة، وهي موجودة لغرض التوافق مع الإصدارات السابقة من بايثون. استخدم الدالة urllib.parse.parse_qsl()‎ عوضًا عنها.  البنية العامة cgi.parse_qsl(qs, keep_blank_values=False, strict_parsing=False) انظر أيضًا الدالة cgi.parse()‎: تحلّل الدالة الاستعلام الموجود في بيئة معينة أو في ملف معيّن. الدالة cgi.parse_qs()‎: هذه الدالة مهملة في هذه الوحدة، وهي موجودة لغرض التوافق مع الإصدارات السابقة من بايثون. استخدم الدالة urllib.parse.parse_qs()‎ عوضًا عنها. الدالة cgi.parse_multipart()‎: تحلّل الدالة المدخلات من نوع multipart/form-data (للملفات المرفوعة). الدالة cgi.parse_header()‎: تحلّل الدالة ترويسة MIME (مثل Content-Type) إلى قيمة ...

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

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

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

يحذف التابع عنصرًا واحدًا من المجموعة. البنية العامة remove(elem) المعاملات elem العنصر المراد حذفه من المجموعة. إن لم يكن هذا العنصر ضمن المجموعة يطلق التابع الخطأ KeyError. أمثلة أمثلة نموذجية عن استخدام هذا التابع: >>> s = {1, 2, 3, 4, 5} >>> s.remove(3) >>> s {1, 2, 4, 5} >>> s.remove(6) Traceback (most recent call last): File "<stdin>", line 1, in <module> KeyError: 6 انظر أيضًا المجموعات في بايثون. التابع set.add()‎: إضافة عنصر واحد إلى المجموعة. التابع set.discard()‎: حذف عنصر واحد من المجموعة إن ...

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

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

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

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

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

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

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

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

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

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

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

يعيد التابع كائن date يتضمّن نفس السنة والشهر واليوم في كائن datetime. البنية العامة ‎datetime.date() القيمة المعادة يعيد التابع كائن date يتضمّن نفس السنة والشهر واليوم في كائن datetime. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import datetime >>> dt = datetime(2018, 6, 7, 22, 45, 6) >>> dt.date() datetime.date(2018, 6, 7) انظر أيضًا التابع datetime.time()‎‎: يعيد كائن time يتضمّن نفس الساعة والدقيقة والثانية وأجزاء الثانية وfold في كائن datetime. التابع datetime.timetz()‎‎: يعيد كائن time يتضمّن نفس الساعة والدقيقة والثانية ...

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

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

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

تحلّل الدالة الاستعلام الموجود في بيئة معينة أو في ملف معيّن (القيمة الافتراضية للملف هي sys.stdin). البنية العامة cgi.parse(fp=None, environ=os.environ, keep_blank_values=False, strict_parsing=False) ‎المعاملات ‎يمرّر المعاملان keep_blank_values و strict_parsing إلى الدالة urllib.parse.parse_qs()‎ دون تغيير. انظر أيضًا الدالة cgi.parse_qs()‎: هذه الدالة مهملة في هذه الوحدة، وهي موجودة لغرض التوافق مع الإصدارات السابقة من بايثون. استخدم الدالة urllib.parse.parse_qs()‎ عوضًا عنها.  الدالة cgi.parse_qsl()‎: هذه الدالة مهملة في هذه الوحدة، وهي موجودة لغرض التوافق مع الإصدارات السابقة من بايثون. استخدم الدالة urllib.parse.parse_qsl()‎‎ عوضًا عنها. الدالة ...

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

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

ينسّق التابع الوقت باستخدام سلسلة التنسيق النصية المعطاة. البنية العامة ‎time.strftime(format) المعاملات format سلسلة التنسيق النصية التي يستخدمها التابع لتنسيق السلسلة النصية المعادة. راجع قسم (التابعان strftime()‎ و strptime()‎ ). القيمة المعادة يعيد التابع سلسلة نصية تمثّل الوقت، ويمكن التحكّم بطريقة التمثيل هذه باستخدام سلسلة تنسيق نصية. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import time >>> t = time(12, 10, 30) >>> t.strftime("%H:%M:%S") '12:10:30' انظر أيضًا التابعان strftime()‎ و strptime()‎ . التابع time.__format__()‎: يسمح هذا التابع بتعيين سلسلسة تنسيق ...

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

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

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

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

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

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

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

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

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

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

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

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

يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، بالاعتماد على تقويم 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). ...

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

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

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

يحدّث التابع المجموعة الأصلية وذلك بحذف العناصر الموجودة في المجموعة أو المجموعات الأخرى الممررة إلى التابع. يؤدي العامل (‎-=‎) الوظيفة نفسها عند استخدامه مع المجموعات. البنية العامة difference_update(*others) المعاملات ‎*others المجموعة التي سيبحث التابع فيها عن العناصر غير المشتركة مع المجموعة الأصلية. القيمة المعادة يحدّث التابع المجموعة الأصلية وذلك بحذف العناصر الموجودة في المجموعة أو المجموعات الأخرى الممررة إلى التابع. أمثلة يبين المثال التالي النتائج المعادة من تطبيق التابع على مجموعات متنوعة: >>> s = {1, 2, 3, 4, 5, ...

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

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

يحدّث التابع القاموسَ بزوج (مفتاح، قيمة) من قاموس أو كائن آخر قابل للتكرار. البنية العامة dict.update([other]) المعاملات other قاموس أو كائن قابل للتكرار يتضمّن أزواج (مفتاح، قيمة) مثل صف أو أي كائن آخر قابل للتكرار طوله (2). إن كان الزوج (مفتاح، قيمة) الممرّر في المعاملات موجودًا في القاموس الأصلي، فإنّ التابع يحذف الزوج الأصلي ويضيف الزوج الجديد محلّه. في حال تمرير معاملات مفتاحية ستحدّث الدالة تلك الأزواج فقط في القاموس الأصلي. القيمة المعادة يعيد التابع القيمة None. أمثلة >>> id_user ...

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

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

تعيد الدّالة range()‎ كائن مجال يحتوي على أعداد صحيحة من نقطة البداية إلى نقطة النّهاية مع فصلها بمسافة عدديّة. البنية العامة range(stop) range(start, stop[, step]) المعاملات start نقطة بداية المجال. stop نقطة نهاية المجال. step المسافة العدديّة التي ستكون بين عناصر المجال. القيمة المعادة كائن مجال يُعدّ نوعًا من أنواع التّسلسلات غير القابلة للتّغيير (immutable sequence type). أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> list(range(3)) # من صفر إلى ثلاثة [0, 1, 2] >>> list(range(1, 5)) # من 1 إلى 5 [1, ...

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

المُنشِئ الحافظ للنوع (Type-Safe Builder) يُتاح بناءُ المُنشِئ الستاتيكيّ الحافظ للنوع في لغة Kotlin باستخدام الدوال ذات التسمية المعبِّرة كمُنشِئ (builder) بالإضافة إلى قيم حرفية (literals) للدوال مع المستقبِل (receiver)، إذ يسمح المُنشِئ الحافظ للنوع ببناء لغات مُخصَّصة المجال (DSL) بالاعتماد على Kotlin بما يتناسب مع إنشاء بُنى البيانات الهرميّة المعقَّدة بطريقةٍ نصف تصريحية (semi-declarative)، وهذه بعض الأمثلة من حالات استخدامه: توليد ترميزٍ (markup) باستخدام شيفرة Kotlin مثل HTML أو XML تصميم أجزاء واجهات المستخدم (UI) برمجيًا مثل Anko ضبط ...

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

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

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

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

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

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

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

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

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