نتائج البحث

تعيد الدالة associate()‎ خريطة (map) تحوي أزواجًا من "مفتاح/قيمة" ناتجة عن تمرير محارف سلسلة المحارف التي استُدعيت معها إلى الدالة الممررة إليها. إن كان لزوجين نفس المفتاح (key)، فالأخير هو الذي سيُضاف إلى الخريطة. تحافظ الخريطة المُعادة على نفس ترتيب التكرار الخاص بسلسلة المحارف الأصليَّة. البنية العامة inline fun <K, V> CharSequence.associate( transform: (Char) -> Pair<K, V> ): Map<K, V> وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions)). المعاملات transform دالةٌ ...

تعيد الدالة intern()‎ تمثيلًا معياريًّا (canonical representation) للسلسلة النصية التي استُدعيت معها. البنية العامة inline fun String.intern(): String بيئة التشغيل المطلوبة: JVM. القيم المعادة تعاد سلسلة نصية. أمثلة مثالٌ على استعمال الدالة ()intern: fun main(args: Array<String>) { var str = "hsoub" print(str.intern()) // hsoub } انظر أيضًا الدالة format()‎: تنسِّق سلسلة نصية وفقًا لقيمة المعاملات التي تمرر إليها. مصادر صفحة الدالة String.intern()‎ في التوثيق الرسمي للمكتبة القياسية في لغة Kotlin.

يغيِّر التابع force_encoding ترميز السلسلة النصية التي استدعي معها إلى ترميز مُحدد ثم يعيدها. البنية العامة force_encoding(encoding) → str المعاملات encoding يمثل الترميز الجديد للسلسلة النصية. القيمة المعادة تُعاد السلسلة النصية المعطاة بعد تغيير ترميزها إلى الترميز encoding. انظر أيضًا التابع ascii_only?‎: يتحقق إذا كانت السلسلة النصية مؤلفة من محارف مرمزة بالترميز ASCII فقط. التابع encoding: يُعيد ترميز السلسلة النصية التي استُدعيت معه. مصادر قسم التابع ‎force_encoding في الصنف String في توثيق روبي الرسمي.

الدالة String.prototype.split()‎ تقسم كائن String إلى مصفوفة من السلاسل النصية بفصلها إلى سلاسل نصية فرعية، وذلك باستخدام محرف فصل مُعيّن لمعرفة أين سيكون كل قسم. البنية العامة str.split([separator[, limit]]) separator السلسلة النصية التي تُشير إلى مكان فصل السلسلة النصية، ويمكن أن يكون الفاصل separator سلسلةً نصيةً أو تعبيرًا نمطيًا. وإذا استخدمنا سلسلةً نصيةً عاديةً تحتوي على أكثر من حرف فيجب العثور على السلسلة النصية كلها في مكان الفصل؛ أما لم تُحدَّد قيمة الوسيط separator أو لم يكن موجودًا ضمن السلسلة ...

تضيف الدالة addcslashes()‎‎ الخطوط المائلة العكسية (backslashes) كما في لغة C. الوصف string addcslashes ( string $str , string $charlist ) تُعيد الدالة سلسلةً نصيةً تسبقها خطوط مائلة عكسية (backslashes) قبل المحارف الموجودة في المعامل charlist. المعاملات str تحتوي السلسلة النصية المُرَاد إضافة الخطوط المائلة العكسية لها. charlist تحتوي المحارف التي ستُضاف الخطوط المائلة العكسية عندها. فإذا احتوى المعامل charlist على أحرف على شكل n\ أو ‎\r وما إلى ذلك من القيم فستتعامل هذه الدالة معها بنمط لغة C، أما العناصر الأخرى غير الأبجدية أو الرقمية والتي لها ...

يبدل التابع sub!‎ قيمة محدَّدة مكان أول تطابق للنمط معطى في السلسلة النصية التي استدعي معها. هذا التابع مماثل تمامًا للتابع sub ولكن يعدل على السلسلة المعطاة نفسها. البنية العامة sub!(pattern, replacement) → str or nil sub!(pattern) {|match| block } → str or nil المعاملات pattern يكون عادةً تعبيرًا نمطيًّا. إن كان سلسلة نصية، فستُفسَّر أية محارف خاصة بالتعبيرات النمطية الموجودة فيها حرفيًّا؛ أي '‎\\d' سيطابق خط مائل عكسي يتبعه الحرف 'd' مباشرةً بدلًا من عددٍ. replacement إن كان سلسلة نصية، فسيحل مكان النص المتطابق. قد يحوي ...

(PHP 4, PHP 5, PHP 7) تَجلُب الدالة fgetss()‎ سطرًا واحدًا من ملف معيَّن وتزيل وسوم HTML من النصِّ الذي تقرؤه. الوصف string fgetss ( resource $handle [, int $length [, string$allowable_tags ]] ) تشبه هذه الدالة تمامًا الدالة fgets()‎ باستثناء أنَّها تحاول إزالة بايتات العدم (NULL)، ووسوم HTML، ووسوم PHP التي تعثر عليها أثناء قراءتها للنص. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎ أو الدالة fsockopen()‎ ولم ...

يشبه التابع next!‎ التابع next تمامًا باستثناء أنه يعدل على السلسلة النصية التي تُستدعَى معه. البنية العامة next! → str القيمة المعادة تعاد السلسلة النصية المعطاة نفسها بعد زيادتها عبر حساب السلسلة النصية اللاحقة لها. انظر أيضًا التابع chop!‎: يحذف المحرف الأخير من السلسلة النصية المعطاة. التابع next: يعيد السلسلة النصية اللاحقة للسلسلة النصية التي استدعي معها. التابع reverse!‎: يعدل على السلسلة النصية التي استدعي معها بعكس ترتيب المحارف فيها. مصادر قسم التابع next!‎‎ في الصنف String في توثيق روبي ...

تعيد الدالة associateBy()‎ خريطةً (map) مكونة من الأزواج "مفتاح/قيمة"، إذ يكون المفتاح (key) هو الناتج الذي تعيده الدالة keySelector الممررة إليها وتكون القيمة (value) المقابلة لذلك المفتاح هي إمَّا محارف سلسلة المحارف المعطاة أو الناتج الذي تعيده الدالة valueTransform الممررة. إن كان لزوجين نفس المفتاح (key)، فالأخير هو الذي سيُضاف إلى الخريطة. تحافظ الخريطة المُعادة على نفس ترتيب التكرار الخاص بسلسلة المحارف الأصليَّة. البنية العامة inline fun <K> CharSequence.associateBy( keySelector: (Char) -> K ): Map<K, Char> inline fun <K, V> CharSequence.associateBy( ...

الدالة String.prototype.repeat()‎ تُنشِئ سلسلةً نصيةً جديدةً تحتوي على العدد المُحدَّد من النسخ من السلسلة النصية التي استدعيت عليها، وراء بعضها بعضًا. البنية العامة str.repeat(count); count عدد صحيح بين 0 و زائد لانهاية، يُشير إلى عدد المرات التي يجب تكرار السلسلة النصية فيها لإنشاء السلسلة النصية الجديدة. القيمة المعادة سلسلة نصية التي تتألف من تكرار للسلسلة النصية المعطية لعدد مُحدَّد من المرات. الاستثناءات سيرمى الاستثناء RangeError إذا كان الوسيط المُمرَّر عددًا سالبًا. ويجب أن يكون الوسيط أقل من اللانهاية (Infinity) ولا ...

يعدل التابع reverse!‎ على السلسلة النصية التي استدعي معها بعكس ترتيب المحارف فيها. البنية العامة reverse! → str القيمة المعادة تُعاد السلسلة النصية المعطاة نفسها بعد عكس ترتيب المحارف فيها. أمثلة أمثلة على استعمال التابع !reverse: a="hello" a.reverse #=> "olleh" a #=> "olleh" انظر أيضًا التابع chop!‎: يحذف المحرف الأخير من السلسلة النصية المعطاة. التابع downcase!‎: يعدل على السلسلة النصية المعطاة وذلك باستبدال الحروف الكبيرة فيها بنظائرها الصغيرة. التابع reverse: يعكس ترتيب محارف السلسلة ...

يعيد تابع النسخة disasm سلسلة التعليمات المعطاة على هيئة سلسلة نصية قابلة للقراءة. البنية العامة disasm → str القيمة المعادة تعاد سلسلة نصية تحوي سلسلة التعليمات بشكل قابل للقراءة. أمثلة مثال على استخدام التابع disasm‎: puts RubyVM::InstructionSequence.compile('1 + 2').disasm الناتج سيكون: == disasm: <RubyVM::InstructionSequence:<compiled>@<compiled>>========== 0000 trace 1 ...

يعيد تابع النسخة disassemble سلسلة التعليمات المعطاة على هيئة سلسلة نصية قابلة للقراءة. البنية العامة disassemble → str القيمة المعادة تعاد سلسلة نصية تحوي سلسلة التعليمات بشكل قابل للقراءة. أمثلة مثال على استخدام التابع disassemble‎: puts RubyVM::InstructionSequence.compile('1 + 2').disasm الناتج سيكون: == disasm: <RubyVM::InstructionSequence:<compiled>@<compiled>>========== 0000 trace 1 ...

تُعيد الدالة مُعرِّف المجموعة للعملية ذات المُعرِّف المُمرَّر. البنية العامة getpgid(pid) حيث الوسيط pid هو مُعرِّف العملية المُراد الحصول على مُعرِّف المجموعة الخاص بها. الدالة متوافرة في أنظمة يونكس. القيمة المعادة تُعيد الدالة نوع عددي صحيح يُمثِّل مُعرِّف المجموعة للعملية ذات المُعرِّف المُمرَّر للوسيط pid. سيُعاد مُعرِّف المجموعة للعملية الحالية في حال مُرِّرَت القيمة 0 للوسيط pid. أمثلة يُوضِّح المقتطف أدناه مثالين لاستخدام الدالة ()os.getpgid للحصول على مُعرِّف مجموعة العملية الحالية: في المثال الأوَّل عبر تمرير القيمة 0 للوسيط pid، بينما ...

يضيف التابع كائن TarInfo المعطى إلى ملف الأرشيف. البنية العامة TarFile.addfile(tarinfo, fileobj=None) ‎المعاملات ‎fileobj معامل اختياري يجب أن تكون قيمته ملفًّا ثنائيًا، وتُقرأ عدد البايتات في tarinfo.size من هذا الملف وتضاف إلى الأرشيف. يمكن إنشاء كائنات TarInfo مباشرة، أو باستخدام التابع gettarinfo()‎. القيمة المعادة يعيد التابع القيمة None. أمثلة يبين المثال التالي آلية عمل التابع: >>> import tarfile >>> tar = tarfile.open('files.tar', 'w') >>> tar_info = tar.gettarinfo('file5.js') >>> tar.addfile(tar_info) انظر أيضًا التابع TarFile.add()‎: يضيف التابع الملف المعطى إلى ملف الأرشيف. التابع TarFile.gettarinfo()‎: ينشئ ...

يعيد التابع قائمة بأسماء الأعضاء في الأرشيف. البنية العامة TarFile.getnames() القيمة المعادة يعيد التابع قائمة بأسماء الأعضاء في الأرشيف، وتأخذ القائمة المعادة نفس ترتيب القائمة المعادة من التابع getmembers()‎. أمثلة يبين المثال التالي آلية عمل التابع: >>> import tarfile >>> tar = tarfile.open('files.tar') >>> tar.getnames() ['file1.txt', 'file2.html', 'file3.py'] انظر أيضًا التابع TarFile.getmember()‎: يعيد التابع كائن TarInfo لعضو ملف الأرشيف المعطى. التابع TarFile.getmembers()‎: يعيد التابع أعضاء الأرشيف على هيئة قائمة من كائنات TarInfo. مصادر صفحة Read and write tar archive files في توثيق بايثون ...

يتحقق هذا التابع ممّا إذا كانت جميع البايتات في التسلسل الثنائي هي بايتات المسافة البيضاء في ترميز ASCII، ومن أنّ التسلسل ليس فارغًا. البنية العامة bytes.isspace() القيمة المعادة يعيد التابع القيمة True إذا كانت جميع البايتات في التسلسل الثنائي هي بايتات المسافة البيضاء في ترميز ASCII، وإذا كان التسلسل غير فارغٍ. بايتات المسافة البيضاء في ترميز ASCII هي البايتات التي تقع ضمن التسلسل: ‎b' \t\n\r\x0b\f'‎، والموضح في الجدول التالي: قيمة البايت الوصف b' '‎ مسافة (space). ‎b'\t'‎ علامة جدولة (tab). ...

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

تعيد الدّالة isinstance()‎ قيمة منطقيّةً تُشير إلى ما إذا كان الكائن المُعطى نسخة (instance) من الصّنف المُعطى أم لا. البنية العامة isinstance(object, classinfo) المعاملات object الكائن المرغوب التّحقّق من كونه نسخةً من الصّنف (أو النّوع) المُعطى. classinfo الصّنف أو النّوع المرغوب التّحقق من أنّ الكائن نسخة منه. يُمكن كذلك أن يقبل صفًّا (أو عدّة صفوف) من الأصناف أو الأنواع للتحقّق من أنّ الكائن نُسخة من أحدها. القيمة المعادة القيمة True إن كان الكائن نُسخة من الصّنف أو نسخة من أحد ...

تقدّم بايثون مجموعة من العمليات الخاصة بالمجموعات والمجموعات الجامدة. العمليات المشتركة بين المجموعات والمجموعات الجامدة تدعم المجموعات والمجموعات الجامدة في بايثون العمليات الموضّحة في الجدول التالي: العملية الوصف ملاحظات len(s)‎ تعيد الدالة عدد العناصر الموجودة في المجموعة، أو ما يعرف في الرياضيات بالمصطلح cardinality. x in s يتحقق هذا العامل من أن العنصر x ينتمي إلى المجموعة s. x not in s يتحقق هذا العامل من أن العنصر x لا ينتمي إلى المجموعة s. set <= other يتحقّق هذا العامل ...

ينشئ التابع نسخة سطحية من كائن deque. البنية العامة d.‎copy() القيمة المعادة يعيد التابع كائن deque جديد يمثّل نسخة سطحية عن كائن dequeالأصلي. أمثلة يبين المثال التالي آلية عمل التابع. يلاحظ أنّ كائني deque أدناه يمتلكان معرّفين مختلفين، ولكنّ عناصرهما تمتلك المعرّفات نفسها: >>> import collections >>> t1 = (1, 2, 3, 4, 5) >>> d1 = collections.deque(t1) >>> d2 = d1.copy() >>> print (d1) deque([1, 2, 3, 4, 5]) >>> print(d2) deque([1, 2, 3, 4, 5]) >>> print(id(d1)) 140310509291624 >>> print(id(d2)) 140310509291520 >>> print(id(d1[0])) 140310800147520 >>> print(id(d2[0])) 140310800147520 انظر أيضًا التابع clear()‎:  :يحذف جميع ...

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

تعيد الدّالة next()‎ القيمة التّالية من المُكرّر المٌعطى عبر استدعاء تابعه الخاصّ ‎_‎_‎next‎_‎_‎()‎. البنية العامة next(iterator[, default]) المعاملات iterator المُكرّر المرُاد الحصول على قيمته التّالية. default مُعامل اختياريّ. تُعاد قيمته عندما تنتهي قيم المُكرّر، وإن لم يُمرّر، فسيُطلَق استثناء StopIteration. القيمة المعادة القيمة التّاليّة للمُكرّر أو القيمة الافتراضيّة المُعطاة للمُعامل default عندما تنتهي قيم المُكرّر. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> name = 'Yousuf' >>> iterator = iter(name) >>> iterator <str_iterator object at 0x7f314d904fd0> >>> next(iterator) 'Y' >>> next(iterator) 'o' >>> next(iterator) 'u' >>> next(iterator) 's' >>> next(iterator) 'u' >>> next(iterator) 'f' >>> ...

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

تعيد الدّالة itertools.chain.from_iterable()‎ مُكرّرًا يُعيد عناصر الكائن القابل للتكرار الأول حتى تنتهيَ عناصره، ثمّ ينتقل إلى الكائن القابل للتّكرار التّالي إلى أن تنتهي قيّمه وهكذا… وتُستخدم لمُعالجة عدّة تسلسلات على أنّها تسلسل واحد مُستمرّ. وتُعدّ الدّالة طريقة بديلة للدّالة itertools.chain()‎، إذ تستقبل هذه الأخيرة عدّة مُعاملات عوضًا عن مُعامل واحد فقط. البنية العامة itertools.chain.from_iterable(iterable) المعاملات iterable الكائن القابل للتّكرار المرغوب تحويل الكائنات التي بداخله إلى تسلسل واحد مُستمر. القيمة المعادة مُكرّر يحتوي على جميع عناصر الكائنات القابلة للتّكرار المتواجدة في ...

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

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

تُزيل الدالة مُتغيّر البيئة المُمرَّر. البنية العامة unsetenv(key) الدالة متوافرة في معظم الأنظمة الشبيهة بيونكس وفي أنظمة ويندوز. المعاملات key مُتغيّر البيئة المُراد إزالته. القيمة المعادة لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None). التغييرات التي تجريها الدالة على البيئة تؤثِّر على العمليات الفرعيّة المُنشأة من الدوال ()os.system و ()os.popen و ()os.fork و ()os.execv. حذف عنصر من القائمة os.environ، إذا ما كانت الدالة ()os.unsetenv مدعومة على المنصة، سيتحوَّل تلقائيًّا إلى استدعاء مماثل للدالة ()os.unsetenv. لاحظ أنَّ استدعاء الدالة ()os.unsetenv ...

يفتح التابع ملف FTP المحدّد في الطلب المعطى. يجري تسجيل الدخول دائمًا باستخدام حقلي اسم المستخدم وكلمة المرور فارغين. البنية العامة FTPHandler.ftp_open(req) المعاملات req طلب HTTP المراد إرساله. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

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

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

تحول الدالة متغيرات CGI من os.environ إلى سلاسل (bytes in unicode) النصية ضمن المعيار PEP 3333، وتعيد قاموسًا جديدًا. يستخدم المعالجان CGIHandler و IISCGIHandler هذه الدالة عوضًا عن استخدام os.environ مباشرة، والذي يمكن أن لا يكون متوافقًا مع معايير WSGI في جميع المنصات ومخدّمات الويب التي تستخدم الإصدار 3 من بايثون، وعلى وجه الخصوص الأنظمة التي تكون Unicode فيها هي البيئة الفعلية (مثل نظام ويندوز) أو الأنظمة التي تكون البيئة فيها هي البايتات ولكن بايثون لا تستخدم الترميز ISO-8859-1 لفكّ ...

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

لا تدعم بايثون متغيرات الأصناف الخاصة (Private) والتي لا يمكن الوصول إليها من خارج الكائن، ولكن يتفق معظم المبرمجين على أنّ الاسم المسبوق بشرطة سفلية (مثل: ‎_spam) يجب أن يُعامل كجزء غير عام من الواجهة البرمجية (سواء كان ذلك الجزء دالة أم تابعًا أم خاصية).  هناك حالة واحدة تستدعي استخدام عناصر الأصناف الخاصة وهي تجنب حدوث تضارب بين الأسماء الموجودة في الصنف والأسماء المعرّفة في الأصناف الفرعية، ونظرًا لذلك تقدم اللغة دعمًا محدودًا لمثل هذه الحالة، وتدعى بتشويه الأسماء name ...

يتمّ التابع عملية الضغط، ويعيد البيانات المضغوطة المتبقية في ذاكرة التخزين الداخلية internal buffer. البنية العامة flush() لا يمكن استخدام كائن compressor بعد استدعاء هذا التابع. مصادر صفحة Support for bzip2 compression في توثيق بايثون الرسمي.

هذا التابع غير معرّف في الصنف BaseHandler، ولكن يجب على الأصناف المتفرّعة منه أن تعرّف هذا التابع إن كان المطلوب التقاط جميع عناوين URL دون تحديد أيّ معالج مسجّل لفتح هذه العناوين. يُستدعى هذا التابع، في حال استخدامه، من قبل كائن OpenerDirector الأب. يُستدعى هذا التابع قبل أي تابع open خاصّ بالبروتوكول. البنية العامة BaseHandler.unknown_open(req) القيمة المعادة يجب أن تكون القيم المعادة مشابهة للقيم المعادة من التابع default_open()‎. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

تعيد الدّالة itertools.dropwhile()‎ مُكرّرًا يُزيل العناصرَ من الكائن القابل للتّكرار المعطى ما دامت العبارة المنطقيّة المُعطاة (التي تكون دالّة تستقبل العنصر وتُعيد قيمة منطقيّة) تُساوي القيمة المنطقيّة True؛ بعد أن تُخالف العبارة المنطقيّة قيمةً منطقيّة صحيحة، يستمرّ المُكرّر بإعادة العناصر المتبقيّة كلّها. لاحظ أنّ المُكرّر لا يُنتج أي مُخرجات حتى تُساوي العبارة المنطقيّة القيمةَ False، ما يعني أنّه قد يحتاج إلى وقت طويل للبدء في إعادة القيم. البنية العامة itertools.dropwhile(predicate, iterable) المعاملات predicate العبارة المنطقيّة التي ستُحدّد ما إذا كان ...

يعيد التابع كائن 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 يتضمّن نفس ...

تعيد الدالة قائمة بكل الإشارات الضعيفة وكائنات الوسيط المرتبطة بالكائن المعطى. البنية العامة weakref.getweakrefcount(object) المعاملات object الكائن المراد معرفة الإشارات الضعيفة والوسائط المرتبطة به. القيمة المعادة تعيد الدالة قائمة بكل الإشارات الضعيفة وكائنات الوسيط المرتبطة بالكائن المعطى. مصادر صفحة Weak references في توثيق بايثون الرسمي.

تضبط الدالة مُعرِّف مُستخدِم العملية الحالية. البنية العامة setuid(uid) الدالة متوافرة في أنظمة يونكس. المعاملات uid المُعرِّف المُراد إسناده لمُستخدِم العملية الحالية. القيمة المعادة لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None). لاحظ أنَّ الدالة يجب أن تُنفَّذ من مُستخدِم يملك صلاحيات الجذر. أمثلة يوضَّح المقتطف أدناه مثالًا عن استخدام الدالة ()os.setuid لتغيير مُعرِّف مُستخدِم العملية الحالية والحصول عليه بالدالة ()os.getuid. >>> from os import getuid, setuid >>> getuid() 0 >>> setuid(1) 1 انظر أيضًا الدالة ()os.getuid: تُعيد المُعرِّف الحقيقي لمُستخدِم العملية الحالية. ...

يؤدّي استدعاء هذه الدالة إلى تولّي وحدة cgitb مسؤولية معالجة الاستثناءات عوضًا عن أداة المعالجة الافتراضية في مفسّر بايثون وذلك بتعيين قيمة للدالة sys.excepthook()‎. البنية العامة cgitb.enable(display=1, logdir=None, context=5, format="html") ‎المعاملات ‎display معامل اختياري، يأخذ القيمة الافتراضية 1، ويمكن أن يأخذ القيمة 0 وبذلك تُمنع الدالة من إرسال رسالة الخطأ إلى متصفّح الويب. logdir إن كان المعامل logdir موجودًا، فإنّ رسالة الخطأ ستُكتب إلى ملف، وقيمة هذا المعامل هو المجلّد الذي سيحتوي على هذه الملفات. context معامل اختياري، يحدّد عدد ...

يستبدل التابع القيم المعطاة في المعاملات بالقيم الأصلية في كائن datetime. البنية العامة datetime.replace(year=self.year, month=self.month, day=self.day, hour=self.hour, minute=self.minute, second=self.second, microsecond=self.microsecond, tzinfo=self.tzinfo, * fold=0) المعاملات يأخذ التابع مجموعة من المعاملات المفتاحية هي year و month و day و hour و minute و second و microsecond (السنة والشهر واليوم والساعة والدقيقة والثانية وأجزاء الثانية). إضافة إلى المعاملين tzinfo و fold. تحلّ القيمة المحدّدة لأيّ من هذه المعاملات محلّ القيمة المقابلة في كائن datetime. تأخذ هذه المعاملات قيمًا افتراضية تساوي القيم المحدّدة في ...

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

تخبر الدالة ما إذا كانت السنة المعطاة كبيسة أم لا. البنية العامة calendar.isleap(year) المعاملات year السنة المراد معرفة ما إذا كانت كبيسة أم لا. القيمة المعادة تعيد الدالة القيمة المنطقية True إن كانت السنة المعطاة كبيسة، وإلا تعيد القيمة False. أمثلة يبين المثال التالي طريقة استخدام الدالة: >>> import calendar >>> calendar.isleap(2018) False >>> calendar.isleap(2016) True انظر أيضًا الدالة calendar.leapdays()‎: تعيد الدالة عدد السنوات الكبيسة ضمن نطاق السنوات المحدّد. مصادر صفحة General calendar-related functions في توثيق بايثون الرسمي.

يحذف هذا التابع العنصر في الموقع المحدّد من قبل المستخدم. البنية العامة l.pop() المعاملات i معامل اختياري، يحدّد موقع العنصر المراد حذفه من القائمة. في حال عدم تعيين قيمة لهذا المعامل فسيحذف التابع العنصر الأخير في القائمة. القيمة المعادة يعيد هذا التابع العنصر المحذوف من القائمة. أمثلة يبين المثال التالي كيفية استخدام هذا التابع لحذف العناصر من القائمة: >>> fruits = ['orange', 'apple', 'pear', 'banana', 'kiwi', 'apple', 'banana'] >>> fruits.pop(2) 'pear' >>> fruits.pop() 'banana' >>> انظر أيضًا القوائم في بايثون. التابع list.sort()‎: فرز القائمة في ...

يطبع التابع التقويم لسنة كاملة بالاعتماد على ما يعيده التابع formatyear()‎. البنية العامة pryear(theyear, w=2, l=1, c=6, m=3) المعاملات theyear السنة المطلوبة. w معامل اختياري يحدّد عرض عمود التاريخ، ويأخذ القيمة الافتراضية 2. l معامل اختياري يحدّد عدد الأسطر لكل أسبوع، ويأخذ القيمة الافتراضية 1. c معامل اختياري يحدّد عدد الفراغات بين أعمدة الشهر. m معامل اختياري يحدّد عدد أعمدة التقويم، ويأخذ القيمة الافتراضية 3. القيمة المعادة يطبع التابع التقويم لسنة كاملة بالاعتماد على ما يعيده التابع formatyear()‎. أمثلة يبين ...

تدرج العنصر المحدّد في المصفوفة المعطاة بعد العناصر المماثلة للعنصر المعطى والموجودة أصلًا في المصفوفة. البنية العامة bisect.insort(a, x, lo=0, hi=len(a)) المعاملات يمكن استخدام المعاملين lo و hi لتحديد جزء من القائمة، ولكن السلوك الافتراضي لهذه الدالة هو التعامل مع القائمة بأكملها. هذه الدالة مشابهة في عملها للدالة insort_left()‎ ولكنّها تدرج العنصر x في المصفوفة a بعد العناصر المماثلة للعنصر x والموجودة أصلًا في المصفوفة. أمثلة يبين المثال التالي آلية عمل التابع: >>> import bisect >>> l = [1, 3, 4, ...

يعيد التابع العضو التالي في الأرشيف على هيئة كائن TarInfo وذلك عند فتح كائن TarFile للقراءة. البنية العامة TarFile.next() القيمة المعادة يعيد التابع العضو التالي في الأرشيف على هيئة كائن TarInfo وذلك عند فتح كائن TarFile للقراءة. ويعيد التابع القيمة None إن لم يتوفّر المزيد من الأعضاء. أمثلة يبين المثال التالي آلية عمل التابع: >>> import tarfile >>> tar = tarfile.open('files.tar', 'r') >>> tar.next() <TarInfo 'file1.txt' at 0x7f486610b110> >>> tar.next() <TarInfo 'file2.html' at 0x7f486610b2a0> >>> tar.next() <TarInfo 'file3.py' at 0x7f486610b048> >>> tar.next() >>> print(tar.next()) None انظر أيضًا التابع TarFile.getmember()‎: يعيد ...

تعيد الدالة قائمة باللهجات المسجّلة. البنية العامة csv.list_dialects()‎ ‎ القيمة المعادة تعيد الدالة قائمة باللهجات المسجّلة. أمثلة يبين المثال التالي آلية عمل الدالة: >>> import csv >>> csv.list_dialects() ['excel', 'excel-tab', 'unix'] انظر أيضًا الدالة csv.register_dialect()‎: تربط الدالة اللهجة المعطاة بالاسم المحدّد.. الدالة csv.unregister_dialect()‎: تحذف الدالة اللهجة المرتبطة بالاسم المعطى من سجلّ اللهجات. الدالة csv.get_dialect()‎: تعيد الدالة اللهجة المرتبطة بالاسم المعطى. الصنف Dialect. مصادر صفحة CSV File Reading and Writing في توثيق بايثون الرسمي.

يلحق التابع عناصر القائمة المعطاة بالمصفوفة. يؤدي هذا التابع نفس عمل التعبير for x in list: a.append(x)‎ باستثناء أنّه في حال وجود خطأ في النوع فإنّ المصفوفة لن تتغير. البنية العامة ‎array.fromlist(list) المعاملات list القائمة المراد إلحاقها بنهاية المصفوفة. القيمة المعادة يعيد التابع القيمة None. أمثلة يبين المثال التالي آلية عمل التابع: >>> import array >>> l1 = [1, 2, 3, 4, 5] >>> a1 = array.array('l') >>> a1.fromlist(l1) >>> a1 array('l', [1, 2, 3, 4, 5]) انظر أيضًا التابع array.frombytes()‎: يلحق التابع عناصر السلسلة ...

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

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

يحدّد التابع ما إذا كان التمثيل المنسّق للكائن المعطى "قابلًا للقراءة" أو يمكن استخدامه لإعادة بناء القيمة باستخدام الدالة eval()‎. البنية العامة PrettyPrinter.isreadable(object) المعاملات object الكائن المراد معرفة ما إذا كان قابلًا للقراءة أو يمكن استخدامه لإعادة بناء القيمة باستخدام الدالة eval()‎. القيمة المعادة يعيد التابع القيمة False دائمًا مع الكائنات التعاودية. إن عُيّنت قيمة للمعامل depth في كائن PrettyPrinter وكان الكائن أعمق ممّا هو مسموح به، فسيعيد التابع القيمة False. أمثلة يبين المثال التالي آلية عمل الدالة: >>> import ...

تفتح الدالة عنوان URL المعطى. البنية العامة urllib.request.urlopen(url, data=None, [timeout, ]*, cafile=None, capath=None, cadefault=False, context=None) ‎المعاملات ‎url سلسلة نصية أو كائن Request، ويتضمّن عنوان URL الذي ستفتحه الدالة. data يجب أن تكون قيمة هذا المعامل كائنًا يحدّد البيانات الإضافية التي ستُرسل إلى المخدّم، أو يأخذ المعامل القيمة None إن لم تكن هناك حاجة لمثل هذه البيانات. (راجع كائنات Request للمزيد من التفاصيل). تستخدم وحدة urllib.request البروتوكول HTTP/1.1 وتُدرج الترويسة Connection:close في طلبات HTTP الخاصّة بها. timeout معامل اختياري يحدّد الفترة ...

صنف متفرّع من الصنف Sh4elf ويقدّم التوابع first()‎ و next()‎ و previous()‎ و last()‎ و set_location()‎ وهي متوفّرة في الوحدة bsddb من pybsddb ولكن ليس في وحدات قواعد البيانات الأخرى. البنية العامة class shelve.BsdDbShelf(dict, protocol=None, writeback=False, keyencoding='utf-8') المعاملات dict يجب أن يدعم كائن dict الممرّر في الدالة البانية هذه التوابع، ويتحقّق ذلك -عامّةً- باستدعاء أحد التوابع bsddbp.hashopen()‎ أو bsddb.btopen()‎ أو bsddb.rnopen()‎. تحمل المعاملات الاختيارية protocol و writeback و keyencoding المعاني نفسها التي تحملها في الصنف Shelf. انظر أيضًا الصنف shelve.Shelf: ...

تعيد الدالة ترويسة تتضمن أسماء أيام الأسبوع بصيغة مختصرة. البنية العامة calendar.weekheader(n) المعاملات n معامل إلزامي، يحدّد عرض الترويسة بالحروف لأسبوع واحد فقط. القيمة المعادة سلسلة نصية تتضمن الصيغة المختصرة لأسماء أيام الأسبوع. أمثلة يبين المثال التالي طريقة استخدام الدالة: >>> import calendar >>> calendar.weekheader(1) 'T W T F S S M' >>> calendar.weekheader(2) 'Tu We Th Fr Sa Su Mo' >>> calendar.weekheader(3) 'Tue Wed Thu Fri Sat Sun Mon' >>> calendar.weekheader(4) 'Tue Wed Thu Fri Sat Sun Mon ' >>> calendar.weekheader(8) ' ...

تُعيد الدالة المُعرِّف الفعلي لمجموعة العملية الحالية. البنية العامة getegid() الدالة متوافرة في أنظمة يونكس. القيمة المعادة تُعيد الدالة نوع عددي صحيح يُمثِّل المُعرِّف الفعلي لمجموعة العملية الحالية. القيمة المُعادة من الدالة مماثلة لقيمة البت "set id" المرتبطة بالملف الجاري فتحه في العملية الحالية. أمثلة في المقتطف أدناه مثال عن استخدام الدالة للحصول على قيمة المُعرِّف الفعلي لمجموعة العملية الحالية. >>> from os import getegid >>> getegid() 1000 مصادر قسم الصفحة os في توثيق بايثون الرسمي.

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

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

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

تُجمّع الدّالة compile()‎ شيفرة بايثون مصدريّةً إلى شيفرة أو كائن AST. يُمكن تنفيذ هذه الكائنات عبر استخدام الدّالة exec()‎ أو الدّالة eval()‎. البنية العامة compile(source, filename, mode, flags=0, dont_inherit=False, optimize=-1) المعاملات source الشيفرة المصدريّة المرغوب تجميعها، يُمكن أن تكون قيمة المُعامل سلسلةً نصيّة، أو سلسلة بايتات نصيّة (byte string) أو كانًا من النّوع AST. انظر توثيق الوحدة ast للمزيد من المعلومات حول كائنات AST. filename اسم الملفّ الذي قُرِئَت منه الشيفرة. مرّر قيمةً مفهومةً إن لم تكن الشّيفرة قد قرئَت ...

تعيد الدّالة itertools.combinations()‎ تسلسلات فرعيّة (subsequences) تُعدّ تجميعاتٍ ذات طولٍ مُحدّد لعناصر الكائن القابل للتّكرار المُعطى. تُنتَج التّجميعات حسب الترتيب المُعجميّ (lexicographic). ما يعني بأنّ الصّفوف النّاتجة ستكون مُرتّبةً إن كان الكائن القابل للتّكرار المُعطى مُرتّبًا. تُعامَل العناصر على أنّها فريدة حسب موقعها، وليس حسب قيمها. لذا إن كانت عناصر الكائن القابل للتّكرار المُدخَل فريدةً فلن تُكرّر أيّة قيم في كلّ تجميعة. البنية العامة itertools.combinations(iterable, r) المعاملات iterable الكائن القابل للتّكرار. r طول الصّفوف النّاتجة. القيمة المعادة صفوف بالطول المُعطى ...

ينسّق التابع التاريخ والوقت باستخدام سلسلة التنسيق النصية المعطاة. البنية العامة ‎datetime.strftime(format) المعاملات format سلسلة التنسيق النصية التي يستخدمها التابع لتنسيق السلسلة النصية المعادة. راجع قسم (التابعان strftime()‎ و strptime()‎ ). القيمة المعادة يعيد التابع سلسلة نصية تمثّل الوقت والتاريخ، ويمكن التحكّم بطريقة التمثيل هذه باستخدام سلسلة تنسيق نصية. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import date >>> dt = datetime(2018, 7, 8, 23, 9, 19) >>> dt.strftime("%d/%m/%y") '08/07/18' >>> dt.strftime("%d %b, %Y") '08 Jul, 2018' >>> dt.strftime("%d %b, %Y - %H:%M:%S") '08 ...

صنف ربط ينشئ إشارات ضعيفة إلى القيم. يجري تجاهل عناصر القاموس عند عدم وجود إشارات قوية إلى القيم. البنية العامة weakref.WeakKeyDictionary([dict]) المعاملات dict القاموس الذي سينشئ هذا الصنف إشارات ضعيفة إلى قيمه. تنبيه: لما كان WeakValueDictionary مبنيًا على قواميس بايثون، فيجب أن لا يتغير حجمه عند المرور على عناصره، وهذا الأمر قد يصبح صعبًا مع WeakValueDictionary لأنّ الأحداث التي تُنفّذ بواسطة البرنامج أثناء عملية المرور على العناصر قد تتسبّب في اختفاء العناصر من القاموس (كتأثير جانبي لمجموعة garbage). التابع valuerefs()‎ ...

يعيد التابع كائن Request أو القيمة None استجابةً لعملية إعادة توجيه. البنية العامة HTTPRedirectHandler.redirect_request(req, fp, code, msg, hdrs, newurl) يُستدعى التابع عند استخدام التوابع http_error_30*()‎ بالطريقة الافتراضية عند استقبال عملية إعادة توجيه من المخدّم. إن أجريت عملية إعادة التوجيه، فإنّ التابع سيعيد كائن Request جديدًا وذلك للسماح لتوابع http_error_30*()‎ بإعادة التوجيه إلى العنوان الجديد newurl. إن لم يحدث ما سبق فحاول إطلاق الاستثناء HTTPError إن لم يُعالج هذا العنوان من قبل أيّ معالج آخر، أو أعد القيمة None إن لم تتمكن ...

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

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

تعيد الدّالة divmod()‎ زوجًا من الأعداد تُمثّل ناتج وباقي قسمة العددين عند استعمال قسمة الأعداد الصّحيحة. البنية العامة divmod(a, b) المعاملات a قيمة عددية تمثل المقسوم. b قيمة عددية تمثل المقسوم عليه. القيمة المعادة عند استعمال أنواع operand المختلطة (mixed operand types)، فستُطبّق قواعد عاملات حسابات الأنواع الثّنائيّة (binary arithmetic operators). للأعداد الصّحيحة، ستكون النّتيجة، مُساويّة للزّوج ‎(‎‎a ‎‎/‎/‎ ‎b‎, ‎a ‎% ‎b‎)‎. أمّا للأعداد العشريّة فستكون النّتيجة هي ‎(q‎, ‎a ‎% ‎b‎)‎ بحيث q يكون عادةً نتيجة العمليّة ...

يبحث التابع عن الملفات ذات الامتداد ‎*.py ويضيف الملف المقابل إلى الأرشيف. إن لم تتوفر قيمة للمعامل optimize في الدالة البانية للصنف PyZipFile أو أعطيت القيمة ‎-1، فإنّ الملف المقابل يكون من الامتداد ‎*.pyc ويجري تصريفه إن دعت الحاجة إلى ذلك. أما إن أعطيت إحدى القيم 0 أو 1 أو 2 فستضاف الملفات التي تمتلك مستويات التحسين هذه فقط (راجع الدالة compile()‎) إلى الأرشيف، وستُصرّف إن دعت الحاجة إلى ذلك. البنية العامة writepy(pathname, basename='', filterfunc=None) ‎المعاملات ‎pathname إن كانت قيمة ...

ينسّق التابع الوقت باستخدام سلسلة التنسيق النصية المعطاة. البنية العامة ‎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__()‎: يسمح هذا التابع بتعيين سلسلسة تنسيق ...

تستدعي الدالة نداء النظام ()getsid الذي يُعيد مُعرِّف جلسة العملية ذات المُعرِّف المُمرَّر. البنية العامة getsid(pid) الدالة متوافرة في أنظمة يونكس. المعاملات pid مُعرِّف العملية المراد الحصول على مُعرِّف جلستها. سيُعيد نداء النظام ()getsid مُعرِّف جلسة العملية المُستدعية له إذا مُرِّرَت القيمة 0 للمعامل pid. القيمة المُعادة تُعيد الدالة نوع عددي صحيح يُمثِّل مُعرِّف جلسة العملية ذات المُعرِّف المُمرَّر للمعامل pid. طالِع صفحة الدليل لنداء النظام ()getsid للمزيد من التفاصيل. أمثلة يُبيّن المثال التالي آلية عمل الدالة. >>> from os import ...

تدعم كائنات Headers العمليات الخاصة بالقواميس مثل ‎__getitem__()‎ و get()‎ و ‎__setitem__()‎ و setdefault()‎ و ‎__delitem__()‎ و ‎__contains__()‎. يكون المفتاح في كل هذه العمليات هو اسم الترويسة (ليست حساسة لحالة الأحرف) وتكون القيمة هي أول قيمة مرتبطة باسم الترويسة ذاك. يؤدي تعيين ترويسة إلى حذف أي قيمة موجودة في تلك الترويسة، ثم تضاف القمية الجديدة إلى نهاية قائمة الترويسات. تضاف الترويسات الجديدة إلى نهاية القائمة وبذلك يتم المحافظة على ترتيب الترويسات الموجودة أصلًا. تختلف كائنات Headers عن القواميس في أنّها ...

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

تقدّم بايثون مكتبة تضمّ مجموعة من الوحدات القياسية (standard modules) وبعضها مدمج مع مفسّر بايثون وتتيح الوصول إلى عمليات هي ليست في الأصل جزءًا من اللغة، ولكن الهدف منها هو إما زيادة كفاءة عمل المفسّر أو لإتاحة الوصول إلى العمليات الأساسية في نظام التشغير مثل استدعاءات النظام (system calls). مجموعة الوحدات هذه هي جزء من خيارات إعدادات اللغة ولكنّها تعتمد أيضًا على نظام التشغيل الذي تعمل عليه اللغة. فعلى سبيل المثال وحدة winreg متوفّرة على أنظمة تشغيل ويندوز فقط. من ...

يعيد التابع صفًّا يضمّ ثلاثة عناصر هي (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()‎: يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، حيث يأخذ يوم الاثنين الرقم ...

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

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

يعيد التابع كائن تكرار iterator يتضمّن أرقام أيام الأسبوع التي ستستخدم لأسبوع واحد. البنية العامة ‎iterweekdays() القيمة المعادة يعيد التابع كائن تكرار iterator لأرقام أيام الأسبوع التي ستستخدم لأسبوع واحد. وتكون القيمة الأولى في كائن التكرار هي نفسها قيمة الخاصية firstweekday. أمثلة يبين المثال التالي آلية عمل التابع: >>> from calendar import Calendar >>> cal = Calendar() >>> for c in cal.iterweekdays(): ... print(c) ... 0 1 2 3 4 5 6 انظر أيضًا التابع itermonthdates()‎: يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة. التابع ...

يعيد التابع التقويم الخاص بشهر معيّن على هيئة سلسلة نصية متعددة الأسطر. البنية العامة ‎formatmonth(theyear, themonth, w=0, l=0) المعاملات theyear السنة المطلوبة. themonth الشهر المطلوب. w يحدد المعامل الاختياري ‏w عرض أعمدة التاريخ، والتي تأخذ محاذاة وسطية. l يحدد المعامل الاختياري l عدد الأسطر التي سيستخدمها كل أسبوع. القيمة المعادة يعيد التابع التقويم الخاص بشهر معيّن على هيئة سلسلة نصية متعددة الأسطر. يعتمد التابع في تحديد اليوم الأول من الأسبوع على القيمة المحدّدة في الدالة البانية أو المعيّنة بواسطة التابع ...

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

تُعيد الدالة مُعرِّف المجموعة الحقيقي لمُستخدِم العملية الحالية. البنية العامة getgid() القيمة المعادة تُعيد الدالة نوع عددي صحيح يُمثِّل مُعرِّف (id) المجموعة الحقيقي (real) لمُستخدِم العملية الحالية. أمثلة يعرض المقتطف البرمجي أدناه مثالين للحصول على مُعرِّف مجموعة المستخدم: الأوَّل يكون فيه صاحِب الجلسة مُستخدِم عادي، والثاني مُستخدِم جذر. >>> from os import getgid >>> getgid() 1000 >>> getgid() 0 انظر أيضًا الدالة ()os.geteuid: تُعيد المُعرِّف الفعلي لمُستخدِم العملية الحالية. مصادر قسم الوحدة os في توثيق بايثون الرسمي.

الصنف timezone هو صنف فرعي من الصنف tzinfo، وتمثّل كل نسخة من منه منطقة زمنية محدّدة بمقدار إزاحة ثابت عن التوقيت العالمي المنسّق. يجب الانتباه إلى أنه لا يمكن استخدام كائنات هذا الصنف لتمثيل معلومات المناطق الزمنية في المواقع التي تستخدم فيها مقادير إزاحة مختلفة خلال السنة، أو المناطق التي حدث فيها تغييرات تاريخية على الأوقات المدنية. البنية العامة class datetime.timezone(offset, name=None) المعاملات offset كائن timedelta يمثّل الفارق بين التوقيت المحلي والتوقيت العالمي المنسّق، ويجب أن يأخذ قيمة تكون ضمن ...

يستند هذا المعالج على sys.stdin و sys.stdout و sys.stderr و os.environ. يمكن الاستفادة من هذا الصنف عند الحاجة إلى تشغيل تطبيق WSGI كشيفرة CGI، حيث يمكن ببساطة تنفيذ التعبير CGIHandler().run(app)‎، إذ يمثل المعامل app كائن تطبيق WSGI الذي ترغب في تنفيذه. يتفرّع هذا الصنف من الصنف BaseCGIHandler والذي يعين القيمة True للمتغير wsgi.run_once والقيمة False للمتغير wsgi.multithreadto، والقيمة True للمتغير wsgi.multiprocess ويستخدم الوحدتين sys و os دائمًا للحصول على تدفقات وبيئة CGI التي يحتاج إليها في عمله. انظر أيضًا الصنف ...

تعيد الدّالة repr()‎ سلسلة نصيّة تحتوي على تمثيل قابل للطّباعة للكائن المُعطى. البنية العامة repr(object) المعاملات object الكائن المرغوب الحصول على تمثيله. القيمة المعادة في الكثير من الحالات، تُحاول الدّالة إعادة سلسلة نصيّة تُعيد كائنًا بنفس القيمة عند تمريره إلى الدّالة eval()‎، وفي غير ذلك من حالات، يكون التّمثيل سلسلةً نصيّة، ويكون مُضمّنًا داخل قوسي <>‎ يحتوي على اسم نوع الكائن إضافةً إلى معلومات أخرى، وعادةً ما تكون هذه المعلومات اسم الكائن وعنوانه في الذّاكرة. يُمكن لصنفٍ أن يتحكّم فيما ...

الدالة البانية للصنف GzipFile، والذي يقدّم محاكاة لمعظم توابع كائن الملف باستثناء التابع truncate()‎. البنية العامة gzip.GzipFile(filename=None, mode=None, compresslevel=9, fileobj=None, mtime=None) المعاملات filename و fileobj يجب أن يأخذ أحد المعاملين fileobj و filename على الأقل قيمة غير بسيطة non-trivial value. تستند النسخة الجديدة من الصنف على الكائن fileobj، والذي يمكن أن يكون ملفًّا عاديًا، أو كائن io.BytesIO أو اي كائن آخر يحاكي الملفات. يأخذ هذا المعامل القيمة None، وفي مثل هذه الحالة يُفتح filename لتوفير كائن ملف. عندما لا تكون ...

هذا التابع غير معرّف في الصنف BaseHandler، ولكن يجب على الأصناف المتفرّعة منه أن تعيد تعريفه إن كانت معدّة لالتقاط جميع أخطاء HTTP غير المعالجة. يُستدعى هذا التابع تلقائيًا بواسطة كائن OpenerDirector الذي يتلقّى الخطأ، ويجب عدم استدعائه في الظروف الأخرى. يُستدعى هذا التابع، في حال استخدامه، من قبل كائن OpenerDirector الأب. يُستدعى هذا التابع قبل أي تابع open خاصّ بالبروتوكول. البنية العامة BaseHandler.http_error_default(req, fp, code, msg, hdrs) المعاملات req سيكون كائن Request. fp سيكون كائنًا شبيهًا بالملفات مع متن ...

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

يعيد التابع صفًّا بهيئة يتضمّن الموقع الحالي في الذاكرة والطول بعدد العناصر في الذاكرة المؤقتة buffer والمستخدمة لاستيعاب محتويات المصفوفة. البنية العامة ‎array.buffer_info() القيمة المعادة يعيد التابع صفًّا بهيئة (عنوان، طول) يتضمّن الموقع الحالي في الذاكرة والطول بعدد العناصر في الذاكرة المؤقتة والمستخدمة لاستيعاب محتويات المصفوفة. يمكن حساب حجم الذاكرة المؤقتة بالبايتات بواسطة التعبير array.buffer_info()[1] * array.itemsize، وهذا مفيد في بعض الأحيان وخصوصًا عند العمل مع واجهات إدخال وإخراج ذات مستوى واطئ (وغير آمنة بطبيعة الحال) والتي تحتاج إلى عناوين ...

يعيد التابع موقع أول ظهور للقيمة المعطاة في المصفوفة. البنية العامة ‎array.index(x) المعاملات x القيمة المراد معرفة موقعها في المصفوفة. القيمة المعادة يعيد التابع موقع أول ظهور للقيمة المعطاة في المصفوفة. يطلق التابع الخطأ ValueError في حال عدم عثوره على القيمة المطلوبة. أمثلة يبين المثال التالي آلية عمل التابع: >>> import array >>> a1 = array.array('l', [1, 2, 8, 12, 88]) >>> a1.index(8) 2 >>> a1.index(12) 3 >>> a1.index(99) Traceback (most recent call last): File "<stdin>", line 1, in <module> ValueError: array.index(x): x not in list انظر ...

تنسخ الدالة كائن شبكة network object المشار إليه بواسطة عنوان URL إلى ملف محلّي. إن أشار عنوان URL إلى ملف محلي، فإنّ الكائن لن يُنسخ إلا إذا زُوّدت الدالة باسم للملف. البنية العامة urllib.request.urlretrieve(url, filename=None, reporthook=None, data=None) المعاملات filename معامل اختياري، يحدّد موقع الملف الذي ستُجرى عملية النسخ إليه (وإن لم يكن الملف موجودًا، فإنّ الموقع سيكون ملفًّا مؤقتًا tempfile يحمل اسمًا تُنشئه الدالة). reporthook معامل اختياري وهو كائن قابل للاستدعاء ويُستدعى لمرة واحدة عند إجراء الاتصال بالشبكة ومرة بعد ...

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

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

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

تعيد الدّالة id()‎ عددًا صحيحًا يُعدّ مُعرّف الكائن. البنية العامة id(object) المعاملات object الكائن المُراد الحصول على مُعرّفه. القيمة المعادة عدد صحيح فريد وثابت يُمثّل مُعرّف الكائن الذي سيبقى مُرتبطًا بالكائن ما دام في الذّاكرة. يُمكن أن تكون قيمة المُعرّف مُتساويّة لكائنين خُزّنا في الذّاكرة في وقتين مُختلفين مع شرط عدم تقاطع مدّة تخزين الكائن الأول مع الآخر، (أي أنّ كائنًا جديدًا قد يملك نفس مُعرّف كائن آخر حُذف من الذّاكرة مُسبقًا). أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: ...

تُستعمَل الدّالة exec()‎ لتنفيذ شيفرة بايثون ديناميكيًّا. البنية العامة exec(object[, globals[, locals]]) المعاملات object سلسلة نصيّة تُمثّل شيفرة بايثون المُراد تنفيذها أو كائن شيفرة كذلك الذي تُعيده الدّالة compile()‎. إن كان سلسلةً نصيّة، فستُعالج على أنّها جمل بايثون عاديّة وستُنفّذ (إلّا في حالة حدث خطأ في بنية الشّيفرة). إن كان كائنَ شيفرة، فسيُنفّذ فقط. وعلى أية حال، يجب على الشّيفرة المرغوب تنفيذها أن تكون شيفرة بايثون صالحة. وانتبه إلى أنّه لا يجوز استخدام الجملتين return و yield خارج تعريفات الدّوال ...

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

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

تتكوّن الأعداد المركبّة من جزأين حقيقي وتخيّلي وكلاهما من الأعداد العشرية ذات الفاصلة العائمة float ، ويمكن استخدام الخاصيتين z.real و z.imagلاستخراج هذين الجزأين من عدد تخيلي z. يستخدم الحرفان 'j' أو 'J' للتعبير عن الأعداد المركبة كما هو موضح في الأمثلة التالية: >>>w = 3j #عدد مركّب الجزء الحقيقي فيه يساوي 0 >>>x = 2+5J >>>y = -3-9j >>>z = 3.1 + 4.5J >>>z.real 3.1 >>> z.imag 4.5 الدالة complex()‎ تعيد الدّالة complex()‎ عددًا مُركّبًا (complex number) حسب العدد الحقيقي والعدد التّخيّلي المُعطيين، أو تُحوّل ...

تعيد الدّالة hash()‎ قيمة تجزئة (hash) الكائن المُعطى (إن امتلك الكائن تجزئةً معروفة). البنية العامة hash(object) المعاملات object الكائن المُراد الحصول على تجزئته. القيمة المعادة عدد صحيح يُمثّل قيمة تجزئة الكائن. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> hash(1) 1 >>> hash(1.0) 1 >>> hash('x') # تجزئة محرف واحد مباشرةً 5693259701801553312 >>> a = 'x' >>> hash(a) # تجزئة المحرف نفسه بعد تخزينه في مُتغيّر 5693259701801553312 ملاحظات تُستخدم التّجزئات لمُقارنة مفاتيح القواميس بسرعة أثناء بحث في القاموس. تملك القيم العدديّة التي تُساوي بعضها البعض نفس قيمة ...

يضيف التابع عنصرًا جديدًا يحمل القيمة المعطاة إلى نهاية المصفوفة. البنية العامة ‎array.append(x) المعاملات x العنصر المراد إضافته إلى نهاية المصفوفة. القيمة المعادة يعيد التابع القيمة None. أمثلة يبين المثال التالي آلية عمل التابع: >>> import array >>> a = array.array('l', [1, 3, 5, 7, 9]) >>> a array('l', [1, 3, 5, 7, 9]) >>> a.append(11) >>> a array('l', [1, 3, 5, 7, 9, 11]) انظر أيضًا التابع array.extend()‎: يلحق التابع عناصر كائن التكرار المعطى إلى نهاية المصفوفة. التابع array.insert()‎: يدرج التابع عنصرًا جديدًا يحمل القيمة ...