نتائج البحث

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

يعيد التابع الخيارات المنطوية تحت القسم المعطى. البنية العامة items(raw=False, vars=None) items(section, raw=False, vars=None) ‎المعاملات section ‎في حال عدم تمرير المعامل section فإنّ التابع يعيد قائمة تتضمّن أزواج اسم القسم، وسيط القسم (section_name, section_proxy) إضافة إلى قسم الإعدادات الافتراضية DEFAULTSECT. أما في حال تمرير المعامل section فإنّ التابع يعيد قائمة تتضمّن أزواج اسم، قيمة (name, value) للخيارات الموجودة في القسم المعطى. راجع التابع get()‎ للمزيد من التفاصيل حول المعاملات raw و vars. القيمة المعادة يعيد التابع قائمة تتضمن قيمًا مختلفة بالاعتماد ...

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

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

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

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

يضغط التابع البيانات المعطاة ويعيد كائن bytes يحتوي على البيانات المضغوطة لجزء من البيانات المعطاة على الأقل. البنية العامة Compress.compress(data) المعاملات data البيانات المراد ضغطها. يجب أن تكون هذه البيانات مرتبطة concatenated بالمخرجات الناتجة من أي استدعاءات سابقة للتابع compress()‎. قد يحتفظ التابع ببعض المدخلات في ذواكر داخلية لغرض المعالجة في وقت لاحق. انظر أيضًا التابع Decompress.decompress()‎: يفكّ التابع الضغط عن البيانات المعطاة، ويعيد كائن bytes يتضمّن البيانات مفكوكة الضغط والمرتبطة على الأقل بجزء من البيانات في السلسلة النصية string. ...

يحدّد هذا التابع ما إذا كان بإمكان محرّك SQLite تحميل الملحقات من المكتبات المشتركة. تعرّف ملحقات SQLite دوال أو مجاميع أو إضافة خاصية جديدة مثل الجداول الافتراضية. تعدّ fulltext-search إحدى أشهر الملحقات التي توزّع مع SQLite. يجدر التنبيه إلى أنّ الملحقات القابلة للتحميل معطّلة بصورة افتراضية، وذلك لأنّ بعض المنصّات (وبالخصوص Mac OS X) تمتلك مكتبات SQLite مصرّفة دون تضمين هذه الميزة. لتفعيل ميزة الملحقات القابلة للتحميل يجب تمرير ‎-enable-loadable-sqlite-extensions إلى الإعدادات. ملاحظة: هذا التابع جديد في الإصدار 3.2. البنية ...

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

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

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

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

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

يسجّل هذا التابع كائن استدعاء خلفيٍّ، وينفّذ هذا الكائن في كل محاولة للوصول إلى عمود في جدول ضمن قاعدة البيانات. البنية العامة set_authorizer(authorizer_callback) ‎ المعاملات authorizer_callback كائن استدعاء خلفي يُنفّذ في كل محاولة للوصول إلى أعمدة الجداول في قاعدة البيانات. يجب أن يعيد الاستدعاء الخلفية النتيجة SQLITE_OK إن كان الوصول مسموحًا به، والنتيجة SQLITE_DENY إن كان المطلوب تجاهل جملة SQL بأكملها مع إطلاق خطأ، والنتيجة SQLITE_IGONRE إن كن المطلوب التعامل مع العمود على أنّه يحمل القيمة NULL. هذه الثوابت متاحة ...

يعيد التابع مكرِّرًا iterator يمكن استخدامه لعرض (dump) قاعدة البيانات بصيغة SQL النصية. البنية العامة iterdump() ‎القيمة المعادة يعيد التابع مكرِّرًا iterator يمكن استخدامه لعرض (dump) قاعدة البيانات بصيغة SQL النصية. هذا التابع مفيد عند التعامل مع قواعد البيانات المخزّنة في الذاكرة. يقدّم هذا التابع نفس الإمكانات التي يقدّمها الأمر ‎.dumb في صدفة sqlite3. أمثلة يعرض المثال التالي كيفية تحويل الملف existing_db.db إلى ملف عرض SQL يحمل الاسم dump.sql: import sqlite3 con = sqlite3.connect('existing_db.db') with open('dump.sql', 'w') as f: ...

يعيد التابع المعلومات المطلوبة لتوثيق المستخدم عند المضيف المعطى في حقل الأمان security realm المحدّد. البنية العامة FancyURLopener.prompt_user_passwd(host, realm) ‎المعاملات ‎host المضيف الذي يعيد التابع منه المعلومات المطلوبة لتوثيق المستخدم. realm حقل الأمان المطلوب. القيمة المعادة يجب أن تكون القيمة المعادة صفًّا بهيئة (user, password) والذي يمكن استخدامه لإجراء عمليات الاستيثاق البسيطة. يطلب التابع إدخال هذه المعلومات في الطرفية، ويمكن للتطبيق أن يعيد تعريف هذا التابع لاستخدام الطريقة الملائمة للتفاعل مع المستخدم في البيئة المحلية. مصادر صفحة Extensible library for ...

ينفّذ التابع جملة SQL المعطاة. البنية العامة execute(sql[, parameters]) ‎المعاملات sql سلسلة نصية تتضمن جملة SQL المراد تنفيذها. يمكن استخدام جمل تتضمن معاملات (أي استخدام محتوى نائب placeholder عوضًا عن الحروف). تدعم وحدة sqlite3 نوعين من المحتويات النائبة، هما: علامة الاستفهام (نمط qmark) ومحتوى نائب مسمّى (نمط التسمية). ينفّذ تابع execute()‎ جملة SQL واحدة، ويطلق التابع تحذيرًا في حال استخدام أكثر من جملة واحدة. يمكن استخدام التابع executescript()‎ لتنفيذ جمل متعددة في استدعاء واحد. أمثلة يبين المثال التالي طريقة استخدام ...

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

يؤدي استدعاء هذا التابع إلى معالجة جميع المدخلات المعلّقة، ويعيد التابع كائن bytes يحتوي على المخرجات المضغوطة المتبقية. البنية العامة Compress.flush([mode]) المعاملات mode يمكن أن يأخذ المعامل mode إحدى القيم الثابتة التالية: Z_NO_FLUSH، Z_PARTIAL_FLUSH، Z_SYNC_FLUSH، Z_FULL_FLUSH، Z_BLOCK (في الإصدار 1.2.3.4 من zlib) أو ‎Z_FINISH، ويأخذ القيمة الافتراضية Z_FINISH. تسمح جميع الثوابت -باستثناء الثابت Z_FINISH- بضغط سلاسل بايتات إضافية من البيانات، في حين ينهي الثابت Z_FINISH تدفق البيانات المضغوطة ويمنع ضغط المزيد من البيانات. لا يمكن استدعاء التابع compress()‎ مرة أخرى ...

يستخرج التابع جميع الأعضاء في ملف الأرشيف إلى المجلد الحالي. البنية العامة ZipFile.extractall(path=None, members=None, pwd=None) ‎المعاملات ‎path يحدّد المعامل مسارًا بديلًا لاستخراج الملفات فيه. members معامل اختياري يجب أن يكون مجموعة فرعية من القائمة المعادة بواسطة التابع namelist()‎. pwd كلمة المرور المستخدمة لتعمية الملفات. تحذير لا تستخرج ملفات الأرشيف القادمة من مصادر غير موثوقة دون فحصها. من الممكن أن تكون الملفات قد أنشئت خارج المسار المحدد في المعامل path (مثل: ملفات تبدأ أسماءها بخط مائل "/" أو تتضمّن نقطتين ".."). ...

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

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

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

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

تعيد الدّالة reversed()‎ مُكرّرًا معكوسًا يحتوي على كائن التّسلسل (sequence) المُعطى بالتّرتيب المُعاكس. البنية العامة reversed(seq) المعاملات seq تسلسل القيم المرغوب الحصول على مُكرّر مُعاكس لها. يجب أن تكون قيمة المُعامل كائنًا يمتلك صنفه التّابع الخاصّ ‎_‎_‎reversed‎_‎_‎(‎)‎ أو أن يدعم بروتوكول التّسلسل (أي أن يحتوي صنفه على التّابع ‎_‎_‎len‎_‎_‎(‎)‎ والتّابع ‎_‎_‎getitem‎_‎_‎(‎)‎ مع مُعاملات أعداد صحيحة تبدأ من الصّفر). القيمة المعادة مُكرّر تكون عناصره نتيجة عكس ترتيب العناصر المُعطاة. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة، لاحظ أنّنا نُحوّل المُكرّر ...

يُعيد الصّنف bool()‎ قيمةً منطقيّةً تكون إمّا True أو False. ويُعَامَل مُعاملة دالةٍ مُضمنّة في بايثون. البنية العامة bool([x]) المعاملات x مُعامل اختياريّ يُحوَّل إلى قيمة منطقيّة باستعمال طريقة اختبار الصّحّة الاعتياديّة. القيمة المعادة إن كان المُعامل المُمرّر يحمل قيمة منطقيّة خطأ (false) أو لم يُمرّر أي مُعامل إلى الصّنف، فالقيمة المُعادة ستكون False، وتُعاد القيمة True في غير ذلك من حالات. أمثلة المثال التّالي يُوضّح كيفيّة عمل هذا الصّنف. لاحظ أنّه يُستدعى كما تُستدعى الدّوال في بايثون: >>> bool(1) True >>> ...

يعيد التابع عدد مرات ظهور القيمة المعطاة في المصفوفة. البنية العامة ‎array.count(x) المعاملات x القيمة المراد معرفة عدد مرات ظهورها في المصفوفة. القيمة المعادة يعيد التابع عدد مرات ظهور القيمة المعطاة في المصفوفة. أمثلة يبين المثال التالي آلية عمل التابع: >>> import array >>> a1 = array.array('l', [1, 1, 3, 5, 5, 5, 6]) >>> a1.count(1) 2 >>> a1.count(5) 3 >>> a1.count(2) 0 انظر أيضًا التابع array.index()‎: يعيد التابع موقع أول ظهور للقيمة المعطاة في المصفوفة. مصادر صفحة Efficient arrays of numeric values في توثيق بايثون الرسمي. ...

يحلّل التابع النموذج النصي المعطى (والذي يُفترض أن يكون بصيغة CSV) ويعيد القيمة True إن كان السطر الأول في الملف عبارة عن سلسلة من ترويسات الأعمدة. البنية العامة has_header(sample) القيمة المعادة يعيد القيمة True إن كان السطر الأول في الملف عبارة عن سلسلة من ترويسات الأعمدة. مصادر صفحة CSV File Reading and Writing في توثيق بايثون الرسمي.

الرف shelf هو كائن مستمر persistent شبيه بالقاموس، ويختلف عن قواعد بيانات "dbm" في أنّ القيم (وليست المفاتيح) في الرفّ يمكن أن تكون من أيّ نوع من أنواع بيانات بايثون، وبمعنى أدق أيّ نوع يمكن لوحدة pickle أن تتعامل معه، وهذا يتضمّن معظم نسخ الأصناف، وأنواع البيانات التعاودية، والكائنات التي تتضمن الكثير من الكائنات الفرعية المشتركة. تكون المفاتيح في الرفوف سلاسل نصية عادية. تحذير: نظرًا لاستناد الرفوف على وحدة pickle، فإنّ من الخطر أن تحمّل رفًّا من مصادر غير موثوقة. ...

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

يعيد التابع تقويم السنة المعطاة على هيئة صفحة HTML كاملة. البنية العامة formatyearpage(theyear, width=3, css='calendar.css', encoding=None) المعاملات theyear السنة المطلوبة. width يحدّد المعامل (والذي يأخذ القيمة الافتراضية 3) عدد الأشهر في كل صفّ من صفوف الجدول المعاد. css يحدّد هذا المعامل اسم ملف الأنماط التشعبية CSS الذي سيُستخدم مع صفحة HTML المعادة. يمكن تمرير القيمة None إلى هذا المعامل في حال عدم الرغبة في استخدام أي أنماط تشعبية. encoding يحدّد هذا المعامل الترميز المستخدم في صفحة HTML المعادة، ويأخذ هذا ...

تفك الدالة ترميز شبيه المسار (path-like) المُمرَّر من ترميز نظام الملفات، مُستخدِمةً مُعالِج الأخطاء 'surrogateescape' أو المُعالِج 'strict' في أنظمة ويندوز. البنية العامة fsdecode(filename) سجل التغييرات الإصدار التغييرات 3.2 أُضيفَت الدالة في هذا الإصدار. 3.6 دُعِمَ استقبال الكائِنات المُنفِّذة للواجهة os.PathLike. المعاملات filename شبيه المسار المُراد فك ترميزه من ترميز نظام الملفات. القيمة المعادة تُعيد الدالة سلسلة نصيّة غير مُغيّرة من الأصل، مفكوكة الترميز من ترميز نظام الملفات الخاص بالنظام. تقوم الدالة ()os.fsencode بالعملية العكس للدالة ()os.fsdecode. أمثلة يُبيّن المثال ...

يعيد التابع قائمة بالأسابيع في الشهر المعطى في السنة المعطاة على هيئة قوائم تضمّ أرقام الأيام السبعة. البنية العامة monthdayscalendar(year, month) المعاملات year السنة المطلوبة. month الشهر المطلوب (من 0 إلى 12). القيمة المعادة يعيد التابع قائمة بالأسابيع في الشهر month في السنة year كأسابيع كاملة. تكون الأسابيع على هيئة قوائم مكوّنة من سبعة صفوف تضمّ بدورها أرقام الأيام وأرقام أيام الأسبوع. أمثلة يبين المثال التالي آلية عمل التابع: >>> from calendar import Calendar >>> cal = Calendar() >>> for c in ...

تُرمِّز الدالة شبيه المسار (path-like) المُمرَّر بترميز نظام الملفات، مُستخدِمةً مُعالِج الأخطاء 'surrogateescape' أو المُعالِج 'strict' في أنظمة ويندوز. البنية العامة fsencode(filename) سجل التغييرات الإصدار التغييرات 3.2 أُضيفَت الدالة في هذا الإصدار. 3.6 دُعِمَ استقبال الكائِنات المُنفِّذة للواجهة os.PathLike. المعاملات filename شبيه المسار المُراد ترميزه بترميز نظام الملفات. القيمة المعادة تُعيد الدالة سلسلة بايتات غير مُغيّرة من الأصل، مُرمَّزة بترميز نظام الملفات الخاص بالنظام. تقوم الدالة ()os.fsdecode بالعملية العكس للدالة ()os.fsencode. أمثلة يُبيّن المثال التالي آلية عمل الدالة. >>> from ...

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

يتسبب هذا الصنف في تمرير الطلبات عبر وسيط معيّن. البنية العامة urllib.request.ProxyHandler(proxies=None) المعاملات proxies معامل اختياري، يجب أن تكون قيمته قاموسًا يربط بين أسماء البروتوكولات وعناوين URL الخاصّة بالوسائط proxies. يجب قراءة قائمة الوسائط افتراضيًا من متغيّرات البيئة التي تحمل الأسماء ‎<protocol>_proxy. وفي حال عدم تعيين أي متغيرات بيئة خاصة بالوسائط، تُؤخذ إعدادات الوسيط في نظام ويندوز من قسم إعدادات الإنترنت Internet Settings في سجلّ النظام، وفي نظام Mac OS X تؤخذ معلومات الوسيط من إطار عمل إعدادات النظام OS ...

يعيد هذا التابع موقع نهاية السلسلة الفرعية التي طوبقت بواسطة المجموعة الممرّرة. البنية العامة match.end([group]) المعاملات group المجموعة التي سيستخدمها التابع لمطابقة السلسلة النصية معها. يأخذ المعامل group القيمة الافتراضية 0 (أي أن التطابق حصل في السلسلة النصية الفرعية بأكملها). القيمة المعادة يعيد التابع موقع بداية السلسلة الفرعية التي طوبقت بواسطة المجموعة الممرّرة. ويعيد التابع القيمة ‎-1 إن كانت المجموعة موجودة ولكنّها لا تساهم في حالة التطابق. لو فرضنا وجود كائن تطابق m ومجموعة g تساهم في حالة التطابق، فإن ...

ينهي التابع عملية الضغط، ويعيد كائن bytes يتضمّن البيانات المخزّنة في الذواكر الداخلية. البنية العامة flush() لا يمكن ضغط البيانات بعد استدعاء هذا التابع. مصادر صفحة Compression using the LZMA algorithm في توثيق بايثون الرسمي.

تعيد الدّالة map()‎ مُكرّرًا (iterator) يُطبّق الدّالة المُعطاة على كل عنصر من عناصر الكائن القابل للتّكرار المُعطى وتعاد نتيجة الاستدعاء في كلّ مرّة. البنية العامة map(function, iterable, ...) المعاملات function الدّالة المرغوب تطبيقها على كلّ عنصر من عناصر المُعامل iterable. iterable الكائن القابل للتّكرار المُراد استدعاء الدّالة function على كلّ عنصر من عناصره. يُمكن كذلك تمرير أكثر من كائن واحد قابل للتّكرار، وإن كان الأمر كذلك، فستُطبّق الدّالة على كلّ عنصر من عناصر الكائنات القابلة للتّكرار على التّوازي، وسيتوقّف المُكرّر ...

تعيد الدّالة min()‎ أصغر عنصر من عناصر كائن قابل للتّكرار أو أصغر مُعامل من مُعاملين أو أكثر. البنية العامة min(iterable, *[, key, default]) # كائن قابل للتّكرار كمُعامل أوّل min(arg1, arg2, *args[, key]) # مُعاملات منفردة المعاملات iterable الكائن القابل للتّكرار المرغوب الحصول على أضغر عناصره. key مُعامل اختياريّ يُمرّر بكلمته المفتاحيّة (keyword-only argument) يُمثّل دالّة تقبل مُعاملًا واحدًا لتُستخدم في ترتيب العناصر المُعطاة مثل الدّالة ‎list‎.‎sort‎(‎)‎. default مُعامل اختياريّ يُمرّر بكلمته المفتاحيّة ويُمثّل القيمة التي ستُعاد افتراضيًّا إن كان الكائن ...

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

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

تعيد الدّالة ord()‎ عددًا صحيحًا يُمثّل نقطة رمز Unicode المحرف المُعطى. البنية العامة ord(c) المعاملات c سلسلة نصيّة تُمثّل المحرف المرغوب الحصول على نقطة رمز Unicode الخاصّة به. القيمة المعادة عدد صحيح يُمثّل نقطة رمز Unicode الخاصّة بالمحرف المُعطى. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> ord('a') 97 >>> ord('€') 8364 انظر أيضًا الأعداد الصحيحة في بايثون. السلاسل النصية في بايثون. الدالة chr()‎: الحصول على المحرف الموافق لنقطة الرّمز. مصادر قسم الدالة ord في صفحة Functions في توثيق Python الرسمي.

تتعامل هذه الدالة مع الاستثناء الموصوف في المعاملات، وتنسّق رسالة الخطأ بصيغة HTML وتعيد النتيجة كسلسلة نصية. البنية العامة cgitb.html(info, context=5) ‎المعاملات info تصف قيمة هذا المعامل الاستثناء الذي ستتعامل معه الدالة، وقيمته عبارة عن صفٍّ tuple ذي ثلاثة عناصر وهو نتيجة استدعاء الدالة sys.exc_inf()‎. context معامل اختياري، يحدّد عدد الأسطر التي ستُعرض في رسالة الخطأ والتي تحيط بالسطر الذي يحتوي على الخطأ في الشيفرة المصدرية، ويأخذ هذا المعامل القيمة الافتراضية 5. القيمة المعادة تعيد الدالة رسالة الخطأ على هيئة ...

تُعيد الدالة عدد المُعالجات المتوفرة في النظام. البنية العامة cpu_count() سجل التغييرات الإصدار التغييرات 3.4 أُضيفَت الدالة في هذا الإصدار. القيمة المعادة تُعيد الدالة نوع عددي صحيح يُمثِّل عدد المُعالجات المتوفرة في النظام. ستُعيد الدالة القيمة None في حال لم تستطع تحديد عدد المعالجات. ملاحظة: لا يُساوي عدد المُعالجات المُعاد من هذه الدالة عدد المعالجات التي يُمكِن للعملية استخدامها. يُمكِنك الحصول على الأخير عبر استخدام التعبير len(os.sched_getaffinity(0))‎. أمثلة في المقتطف أدناه مثال عن استخدام الدالة في جهاز ثنائي المعالِج. >>> ...

تعيد الدالة يوم الأسبوع في اليوم المعطى في الشهر المعطى في السنة المعطاة. البنية العامة calendar.weekday(year, month, day) المعاملات year السنة المطلوبة. month الشهر المطلوب. day اليوم المطلوب. القيمة المعادة تعيد الدالة يوم الأسبوع (0 هو يوم الإثنين و 6 هو يوم الأحد) للسنة year (من 1970 وما بعدها) في الشهر month (يأخذ القيم 1-12) واليوم day (يأخذ القيم 1-31). أمثلة يبين المثال التالي طريقة استخدام الدالة: >>> import calendar >>> calendar.weekday(1988, 2, 7) 6 مصادر صفحة General calendar-related functions في توثيق ...

تُحوّل الدّالة bin()‎ عددًا صحيحًا (integer number) إلى سلسلةٍ نصيّةٍ ثنائيّة (binary string) مسبوقة بالمقطع النّصيّ "0b". البنية العامة bin(x) المعاملات x عدد صحيح، إن لم يكن كائنًا من النّوع int، فيجب على الكائن أن يحتوي على التّابع الخاصّ ‎_‎_index‎_‎_()‎ الذي يجب عليه أن يُعيد عددًا صحيحًا. القيمة المعادة سلسلة نصيّة ثنائيّة مسبوقة بالمقطع النّصيّ "0b". أمثلة تُوضّح الأمثلة التّالية كيفيّة عمل هذه الدّالة: >>> bin(3) '0b11' >>> bin(-10) '-0b1010' ملاحظات إن لم ترغب بالحصول على السّابقة "0b"، يُمكنك استعمال أحد الطرائق التّاليّة: ...

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

يستخدم هذا الصنف لتخمين الصيغة المستخدمة في ملف CSV. توابع الصنف Sniffer التابع Sniffer.sniff()‎ يحلّل التابع النموذج المعطى ويعيد صنفًا متفرعًا من الصنف Dialect الذي يعكس المعاملات التي عثر عليها التابع. التابع Sniffer.has_header()‎ يتحقق التابع من كون السطر الأول في ملف csv عبارة عن سلسلة من ترويسات الأعمدة. انظر أيضًا الوحدة csv في بايثون: تقدّم وحدة csv عددًا من الأصناف التي تساعد في قراءة البيانات المجدولة وكتابتها بصيغة CSV. مصادر صفحة CSV File Reading and Writing في توثيق بايثون الرسمي.

يستخدم هذا الصنف ملفًّا يكتب فيه تدفق البيانات المسلسلة. البنية العامة class pickle.Pickler(file, protocol=None, *, fix_imports=True) ‎ المعاملات file يجب أن يمتلك كائن الملفّ تابع write()‎ يستقبل معامل بايتات واحدًا فقط؛ لهذا يمكن أن يكون ملفًّا مخزّنًا في القرص الصلب مفتوحًا لكتابة البيانات الثنائية، أو نسخة من io.BytesIO، أو أي كائن مخصّص آخر يطابق هذه الشروط. protocol معامل اختياري، وهو عدد صحيح يُعلم المُسلسِل باستخدام البرتوكول المحدّد بالرقم المعطى، والبروتوكولات المدعومة هي من 0 إلى قيمة الثابت HIGHEST_PROTOCOL. * معامل ...

تعيد الدّالة slice()‎ كائن slice يُمثّل مجموعة فهارس (indices) تُحدّد من طرف الاستدعاء ‎range‎(‎start‎,‎ stop‎, ‎step‎)‎‎. البنية العامة class slice(stop) class slice(start, stop[, step]) المعاملات start مُعامل اختياريّ قيمته الافتراضيّة هي None، يُمثّل بداية الفهارس. stop المُعامل المطلوب الوحيد، والذي يُمثّل نقطة توقّف الفهارس. step مُعامل اختياريّ قيمته الافتراضيّة هي None، يُمثّل الخطوة التي بين كل فهرس وآخر. القيمة المعادة كائن slice‎ يحتوي على خصائص start، وstop، وstep قابلة للقراءة فقط، والتي تُعيد قيمة المُعامل المُرتبط بها. الكائن المُعاد لا يمتلك ...

يضيف التابع الموجّه المعطى كموجّه أب. البنية العامة BaseHandler.add_parent(director) ‎المعاملات director الموجه المراد إضافته. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

يفتح التابع عنوان URL الكامل المعطى باستخدام البروتوكول المناسب. يهيّئ هذا التابع الذاكرة المخبئية ومعلومات الوسيط، ثم يستدعي تابع الفتح الملائم مع وسائط الإدخال الخاصة به. إن لم يتمكن التابع من التعرّف على المخطّط يُستدعى التابع open_unknown()‎. البنية العامة URLopener.open(fullurl, data=None) ‎المعاملات ‎data يحمل المعامل data المعنى نفسه لنظيره في الدالة urlopen()‎. القيمة المعادة يعيد التابع كائن urllib.response.addinfourl. أمثلة يقرأ المثال التالي أول 300 بايت من موقع Python: >>> from urllib import request >>> opener = request.URLopener() >>> result = opener.open("https://www.python.org") >>> print(result.read(300)) b'<!doctype ...

يمثّل كائن TarInfo عضوًا واحدًا في كائن TarFile. يحفظ هذا الكائن جميع الخصائص المطلوبة في الملف (مثل نوع الملف، وحجمه، ووقت التعديل، والأذونات، ومالك الملف وغيرها)، إلى جانب أنّه يقدّم بعض التوابع المفيدة لتحديد نوع الملف، ولا يحتوي هذا الكائن على بيانات الملف. تعيد التوابع getmember()‎ و getmembers()‎ و gettarinfo()‎ كائنات TarInfo. البنية العامة الدالة البانية للصنف TarInfo: class tarfile.TarInfo(name="") خصائص كائنات TarInfo يمتلك كائن TarInfo الخصائص العامة التالية: TarInfo.name اسم عضو الأرشيف. TarInfo.size الحجم بالبايتات. TarInfo.mtime وقت آخر تعديل. ...

تضبط الدالة المُعرَّف الحقيقي والفعلي لمجموعة العملية الحالية. البنية العامة setregid(rgid, egid) الدالة متوافرة في أنظمة يونكس. المعاملات rgid المُعرِّف الحقيقي الجديد المُراد إسناده لمجموعة العملية الحالية. egid المُعرِّف الفعلي الجديد المُراد إسناده لمجموعة العملية الحالية. القيمة المعادة لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None). لاحظ أنَّ الدالة يجب أن تُنفَّذ من مُستخدِم يملك صلاحيات الجذر. أمثلة يُبيّن المثال التالي آلية عمل الدالة. >>> from os import setregid >>> setregid(1,2) مصادر قسم الوحدة os في توثيق بايثون الرسمي. ...

يتحقق التابع من وجود الخيار المعطى في القسم المحدّد. البنية العامة has_option(section, option) ‎المعاملات ‎section القسم الذي سيبحث فيه التابع عن الخيار المعطى. option الخيار الذي سيبحث عنه التابع. القيمة المعادة إن كان القسم المعطى موجودًا ويتضمّن الخيار المعطى فإنّ التابع يعيد القيمة True، ويعيد القيمة False فيما عدا ذلك. إن كان القسم المحدّد هو None أو سلسلة نصية فارغة، فإنّ التابع يفترض بأنّه القسم DEFAULT. أمثلة لنفرض أن لدينا ملف الإعدادات التالي: [DEFAULT] ServerAliveInterval = 45 Compression = yes CompressionLevel = 9 ForwardX11 ...

يكتب التابع صفًّا مع أسماء الحقول (كما هو محدّد في الدالة البانية). ملاحظة: هذا التابع جديد في الإصدار 3.2. البنية العامة writeheader() ‎مصادر صفحة CSV File Reading and Writing في توثيق بايثون الرسمي.

تضبط الدالة المُعرِّف الحقيقي والفعلي والمحفوظ لمجموعة العملية الحالية. البنية العامة setresgid(rgid, egid, sgid) سجل التغييرات الإصدار التغييرات 3.2 أُضيفَت الدالة في هذا الإصدار. الدالة متوافرة في أنظمة يونكس. المعاملات rgid المُعرِّف الحقيقي الجديد المُراد إسناده لمجموعة العملية الحالية. egid المُعرِّف الفعلي الجديد المُراد إسناده لمجموعة العملية الحالية. sgid المُعرِّف المحفوظ الجديد المُراد إسناده لمجموعة العملية الحالية. القيمة المعادة لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None). لاحظ أنَّ الدالة يجب أن تُنفَّذ من مُستخدِم يملك صلاحيات الجذر. ...

تحذف الدالة وتعيد أصغر عنصر في الكومة مع الحفاظ على ثبات الكومة. البنية العامة heapq.heappop(heap) المعاملات heap اسم الكومة التي سيُحذف أصغر عنصر منها. القيمة المعادة تحذف الدالة وتعيد أصغر عنصر في الكومة heap، مع الحفاظ على ثبات الكومة. إن كانت الكومة فارغة، تطلق الدالة الخطأ IndexError. للوصول إلى أصغر عنصر دون حذفه، يمكن استخدام heap[0]‎. أمثلة يبين المثال التالي آلية عمل التابع: >>> import heapq >>> li = [5, 7, 9, 1, 3] >>> heapq.heapify(li) >>> print(list(li)) [1, 3, 9, 7, 5] >>> heapq.heappop(li) 1 >>> ...

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

تُعرَّف الدوال باستخدام الكلمة المفتاحية def يتبعها اسم الدالة ثم قائمة بالمعاملات محاطة بالأقواس. أما الكتلة الرئيسية للدالة فتبدأ في السطر التالي لسطر التعريف، ويجب أن تزاح بمقدار إزاحة واحدة. مثال >>> def fib(n): # دالة لإنشاء متسلسلة فابيوناتشي ... """Print a Fibonacci series up to n.""" ... a, b = 0, 1 ... while a < n: ... print(a, end=' ') ... ...

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

تُعيد الدالة كائِن ملف مفتوح مُتَّصِل بواصِف الملف المُمرَّر. البنية العامة fdopen(fd, [, mode[, bufsize]]) المعاملات fd واصِف الملفات المُراد ربط كائِن الملف المُعاد به. mode مُعطى اختياري ينبغي تمرير سلسلة نصيّة له تحوي الوضع المُراد فتح الملف به. bufsize مُعطى اختياري يُحدِّد حجم الصِوان (buffer) المُراد استخدامه. القيمة المعادة تُعيد الدالة كائِن ملف مفتوح مُتَّصِل بواصِف الملف المُمرَّر للمعامِل fd. هذه الدالة مُكافِئة للدالة ()open المُضمَّنة داخليًّا في بايثون، وكذلك تستقبل نفس مُعطياتها. الفرق الوحيد بين الدالة ()fdopen والدالة ...

هذا التابع غير معرّف في الصنف BaseHandler، ولكن يجب على الأصناف المتفرّعة منه أن تعرّف هذا التابع إن كان المطلوب التقاط جميع عناوين URL. يُستدعى هذا التابع، في حال استخدامه، من قبل كائن OpenerDirector الأب. يُستدعى هذا التابع قبل أي تابع open خاصّ بالبروتوكول. البنية العامة BaseHandler.default_open(req) القيمة المعادة يجب أن يعيد التابع كائنًا شبيهًا بالملفات file-like object كما هو موصوف في القمية المعادة من التابع open()‎ في كائنات OpenerDirector، أو يعيد القيمة None. يجب أن يطلق التابع الخطأ URLError ...

يطلق هذا التابع افتراضيًا الاستثناء UnpicklingError. البنية العامة persistent_load(pid) المعاملات pid في حال تعريف هذا التابع فإنّه يعيد الكائن المحدّد بواسطة المعرّف المستمر pid، وإذا كان المعرّف المستمّر غير صالحٍ فإنّ التابع يُطلق الاستثناء UnpicklingError. راجع قسم "استمرارية الكائنات الخارجية" في وحدة pickle للاطلاع على المزيد من التفاصيل والأمثلة حول هذا الموضوع. انظر أيضًا التابع Unpickler.persistent_id()‎ : لا يؤدي هذا التابع افتراضيًا أي وظيفة، والهدف من وجوده هو إمكانية إعادة تعريفه override بواسطة صنف فرعي. مصادر صفحة DB-API 2.0 interface for ...

يحول التابع المصفوفة إلى مصفوفة من قيم الجهاز ويعيد كذلك تمثيل البايتات (تسلسل البايتات نفسه الذي يمكن كتابته إلى ملف باستخدام التابع tofile()‎). تغير اسم التابع tostring()‎ إلى tobytes()‎ في الإصدار 3.2 وذلك لزيادة الإيضاح. البنية العامة ‎array.tobytes() القيمة المعادة يعيد التابع التمثيل الخاص بالبايتات (تسلسل البايتات نفسه الذي يمكن كتابته إلى ملف باستخدام التابع tofile()‎). أمثلة يبين المثال التالي آلية عمل التابع: >>> import array >>> a1 = array.array('l', [1, 2, 3, 4, 5]) >>> a1 array('l', [1, 2, 3, 4, 5]) >>> ...

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

يسجّل هذا التابع استدعاءً خلفيًا يجري تنفيذه لكل n من تعليمات SQLite في الجهاز الافتراضي virtual machine. هذا التابع مفيد عند الحاجة إلى اجراء استدعاء من SQLite أثناء عملية طويلة، كتحديث واجهة رسومية مثلًا. البنية العامة set_progress_handler(handler, n) المعاملات handler يمكن استدعاء التابع مع تمرير القيمة None للمعامل handler للتخلص من أي استدعاء خلفي معدّ مسبقًا. تؤدي إعادة قيمة غير الصفر من الاستدعاء الخلفي إلى إنهاء الاستعلام الحالي وإطلاق الاستثناء OperationalError. n عدد تعليمات SQLite. انظر أيضًا التابع Connection.set_authorizer()‎:يسجّل هذا ...

تُعيد الدالة صفًّا يحتوي على المُعرِّف الحقيقي والفعلي والمحفوظ لمجموعة العملية الحالية. البنية العامة getresuid() القيمة المعادة تُعيد الدالة صفًّا يحتوي (بالترتيب المذكور) على المُعرِّف الحقيقي (real) والفعلي (effective) والمحفوظ (saved) لمجموعة العملية الحالية. أمثلة في المقتطف أدناه مثالين على استخدام الدالة للحصول على المُعرِّفات الثلاث لمجموعة العملية الحالية. >>> from os import getresuid >>> getresuid() (1000, 1000, 1000) >>> getresuid() (0, 0, 0) مصادر قسم الصفحة os في توثيق بايثون الرسمي.

تحدّد الدالة ما إذا كان التمثيل المنسّق للكائن المعطى "قابلًا للقراءة" أو يمكن استخدامه لإعادة بناء القيمة باستخدام الدالة eval()‎. البنية العامة pprint.isreadable(object) القيمة المعادة تعيد هذه الدالة القيمة False دائمًا مع الكائنات التعاودية Recursive objects. أمثلة يبين المثال التالي آلية عمل الدالة: >>> import pprint >>> stuff = ['spam', 'eggs', 'lumberjack', 'knights', 'ni'] >>> stuff.insert(0, stuff) >>> pprint.pprint(stuff) [<Recursion on list with id=...>, 'spam', 'eggs', 'lumberjack', 'knights', 'ni'] >>> pprint.isreadable(stuff) False انظر أيضًا التابع PrettyPrinter.isreadable()‎: يحدّد التابع ما إذا كان التمثيل المنسّق للكائن المعطى "قابلًا ...

يكتب التابع جميع العناصر (كقيم جهاز) في كائن الملف المعطى. البنية العامة ‎array.tofile(f) المعاملات f كائن ملف المراد كتابة عناصر المصفوفة فيه. القيمة المعادة أمثلة يبين المثال التالي آلية عمل التابع: انظر أيضًا التابع array.tobytes()‎: يحول التابع المصفوفة إلى مصفوفة من قيم الجهاز. التابع array.tolist()‎: يحول التابع المصفوفة إلى قائمة عادية تتضمن نفس العناصر. التابع array.tounicode()‎: يحول التابع المصفوفة إلى سلسلة نصية بترميز Unicode. مصادر صفحة Efficient arrays of numeric values في توثيق بايثون الرسمي.

تُغيّر الدالة مُجلَّد الجذر للعملية الحالية إلى المسار المُمرَّر. البنية العامة chroot(path) الدالة متوافرة في أنظمة يونكس. المعاملات path المسار المراد تغيير مُجلَّد الجذر للعملية الحالية إليه. القيمة المعادة لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None). لاحظ أنَّ الدالة ينبغي تنفيذها بصلاحية الجذر. أمثلة يُبيّن المثال التالي آلية عمل الدالة. >>> from os import chroot >>> chroot("/home") مصادر قسم الوحدة os في توثيق بايثون الرسمي.

يستدعي هذا التابعُ التابعَ Cursor.executescript()‎ مع تمرير المعاملات المعطاة. البنية العامة executescript(sql_script) ‎المعاملات sql_script سلسلة نصية تتضمن شيفرة SQL المراد تنفيذها. القيمة المعادة هذا التابع هو طريقة مختصرة لإنشاء كائن مؤشر عن طريق استدعاء التابع cursor()‎، حيث يستدعي التابع executescript()‎ في كائن المؤشر مع تمرير قيمة المعامل sql_script، ثم يعيد كائن المؤشر. أمثلة يبين المثال التالي آلية عمل التابع: import sqlite3 conn = sqlite3.connect('example.db') conn.executescript(""" insert into recipe (name, ingredients) values ('broccoli stew', 'broccoli peppers cheese tomatoes'); ...

يجب أن تكون nnn عددًا من ثلاث مراتب يمثّل شيفرة خطأ HTTP. هذا التابع غير معرّف في الصنف BaseHandler أيضًا، ولكن سيُستدعى إن كان موجودًا على نسخة من الصنف المتفرّع عن الصنف BaseHandler عند حدوث خطأ HTTP يحمل الشيفرة nnn. يجب على الأصناف الفرعية أن تعيد تعريف هذا التابع لمعالجة أخطاء HTTP معيّنة. البنية العامة BaseHandler.http_error_nnn(req, fp, code, msg, hdrs) يجب أن تكون المعاملات والقيم المعادة والاستثناءات المُطلقة مشابهة لنظيراتها في التابع http_error_default()‎. مصادر صفحة Extensible library for opening URLs ...

يستخرج التابع جميع الأعضاء من ملف الأرشيف إلى المجلد الحالي أو المسار المعطى. البنية العامة TarFile.extractall(path=".", members=None, *, numeric_owner=False) المعاملات ‎memebers معامل اختياري، ويجب أن يكون مجموعة متفرّعة subset من القائمة المعادة من التابع getmembers()‎. يجري تحديد المعلومات الخاصة بالمجلد مثل صاحب المجلد ووقت التعديل والأذونات بعد استخراج جميع الأعضاء من ملف الأرشيف، ويحدث هذا لسببين: يعاد تعيين قيمة وقت التعديل للمجلد في كل مرة يتم فيها إنشاء ملف جديد فيه. إن لم تسمح أذونات مجلّد معين بالكتابة فيه، ستفشل ...

يحمّل التابع الإعدادات من أي كائن يوفّر تابعًا شبيهًا بالتابع items()‎ في كائنات dict. تتضمّن المفاتيح أسماء الأقسام، أمّا القيم فعبارة عن قواميس تتضمّن المفاتيح والقيم التي تنطوي عليها الأقسام. إن كان القاموس المستخدم قادرًا على الاحتفاظ بترتيب العناصر، فستضاف الأقسام ومفاتيحها بحسب الترتيب. تُحوّل القيم إلى سلاسل نصية تلقائيًا. يمكن استخدام هذا التابع لنسخ الحالة بين المحلّلات المختلفة. البنية العامة read_dict(dictionary, source='<dict>') ‎المعاملات dictionary القاموس الذي سيقرأ التابع منه الإعدادات. ‎source معامل اختياري يحدد اسمًا خاصًّا بالسياق context-specific name ...

كائنات Cursor هي وسيلة التواصل بين المستخدم وقاعدة البيانات، حيث يمكن باستخدام الخصائص والتوابع التي تقدّمها هذه الكائنات تنفيذ جمل SQL وإجراء الاستعلامات وجلب النتائج من قاعدة البيانات. خصائص كائنات Cursor يمتلك كائن المؤشر الخصائص التالية: الخاصية rowcount بالرغم من أنّ صنف Cursor في وحدة sqlite3 يتضمّن هذه الخاصية، إلا أنّ الدعم الذي يقدّمه محرّك SQLite لتحديد "عدد الصفوف المتأثرة"/"عدد الصفوف المحدّدة" جيّد أيضًا. يُجمع عدد التعديلات في الخاصية rowcount عند تنفيذ جمل الاستعلام بواسطة التابع executemany()‎. تتطلب معايير بايثون ...

ينشئ تابع الصنف هذا كائن ZipInfo للملف المعطى، ويهيّئه لإضافته إلى ملف zip. البنية العامة ZipInfo.from_file(filename, arcname=None) ‎ المعاملات filename مسار الملف أو المجلّد المعطى. arcname معامل اختياري، يستخدم كاسمٍ للملف المعطى داخل الأرشيف. في حال عدم تعيين قيمة لهذا المعامل، فإنّ اسم الملف المعطى سيبقى نفسه داخل الأرشيف، ولكن بعد اقتطاع محرف محرّك الأقراص وفواصل المسارات. ملاحظات: هذا التابع جديد في الإصدار 3.6 من بايثون. يستقبل المعامل filename كائنًا شبيهًا بالمسارات في الإصدار 3.6.2. مصادر صفحة Work with ZIP ...

يعكس التابع ترتيب عناصر الكائن deque في نفس المكان. البنية العامة d.reverse() القيمة المعادة يعيد التابع القيمة None. ملاحظة: هذا التابع جديد في الإصدار 3.2. أمثلة يبين المثال التالي آلية عمل التابع. >>> from collections import deque >>> d = deque('abcdefg') >>> d deque(['a', 'b', 'c', 'd', 'e', 'f', 'g']) >>> d.reverse() >>> d deque(['g', 'f', 'e', 'd', 'c', 'b', 'a']) مصادر قسم deque Objects في صفحة Container Datatypes في توثيق بايثون الرسمي.

يجلب التابع المجموعة اللاحقة من الصفوف rows في نتيجة الاستعلام، ويعيد النتيجة كقائمة. البنية العامة fetchmany(size=cursor.arraysize) المعاملات size يمكن تحديد عدد الصفوف التي يجلبها التابع مع كل استدعاء عن طريق المعامل size. وفي حال عدم تحديد قيمة لهذا المعامل فإنّ قيمة خاصية arraysize في كائن المؤشر ستحدّد عدد الصفوف التي سيجلبها التابع (القيمة الافتراضية لهذه الخاصية هي 1 وهذا يعني أنّ التابع سيجلب صفًّا واحدًا فقط). سيحاول التابع جلب الصفوف المحدّدة في معامل size، وإن كان ذلك غير ممكنًا بسبب ...

يقرأ التابع جميع الملفات في الأرشيف ويفحص ترويساتها وCRC الخاصة بها. البنية العامة ZipFile.testzip() ‎القيمة المعادة يعيد التابع اسم أول ملف معطوب أو يعيد القيمة None إن لم يكن هناك ملف معطوب. يؤدي استدعاء التابع testzip()‎ على كائن ZipFile مغلق إلى إطلاق الاستثناء ValueError في الإصدار 3.6 من بايثون. كان التابع يطلق الاستثناء RuntimeError في الإصدارات السابقة. أمثلة يبين المثال التالي آلية عمل التابع: >>> import zipfile >>> zip = zipfile.ZipFile('files.zip') >>> zip.testzip() >>> >>> print(zip.testzip()) None مصادر صفحة Work with ZIP archives في ...

يقلب التابع ترتيب العناصر في المصفوفة. البنية العامة ‎array.reverse() القيمة المعادة يعيد التابع القيمة None. أمثلة يبين المثال التالي آلية عمل التابع: >>> import array >>> a1 = array.array('l', [1, 2, 3, 4, 5]) >>> a1.reverse() >>> a1 array('l', [5, 4, 3, 2, 1]) مصادر صفحة Efficient arrays of numeric values في توثيق بايثون الرسمي.

ينشأ كائن التعبير النمطي regex من تصريف التعبير النمطي بواسطة الدالة re.compile()‎، ويقدّم هذا الكائن مجموعة من الخصائص والتوابع التي يمكن من خلالها إجراء العديد من العمليات على التعابير النمطية المصرّفة. خصائص الكائن regex يقدّم الكائن regex الخصائص التالية: regex.flags رايات التطابق الخاص بالكائن regex، وتمثّل مجموعة الرايات التي تمرّر إلى الدالة re.compile()‎، إضافة إلى الرايات السطرية (‎?...‎) في التعابير النمطية، والرايات الضمنية مثل UNICODE إن كان التعبير النمطي سلسلة نصية بترميز Unicode. regex.groups عدد مجموعات الالتقاط في التعبير النمطي. ...