نتائج البحث

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

تحوّل الدالة كائن ربط mapping object أو تسلسلًا من صفوف ذات عنصرين، والتي قد تحتوي على كائنات str أو bytes إلى سلسلة نصية مرمّزة بالنسبة المئوية ضمن الترميز ASCII. إن كان المطلوب استخدام السلسلة النصية الناتجة كبيانات لعمليات من نوع POST في الدالة urlopen()‎ فيجب ترميز قيمة المعامل إلى بايتات، وإلّا فإنّ النتيجة ستكون الحصول على الاستثناء TypeError. البنية العامة urllib.parse.urlencode(query, doseq=False, safe='', encoding=None, errors=None, quote_via=quote_plus) ‎المعاملات query إن استخدم تسلسل من صفوف ذات عنصرين كقيمة للمعامل query، فيجب أن ...

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