نتائج البحث

تتيح بايثون إمكانية الوصول إلى الملفات في نظام التشغيل وقرائتها والكتابة عليها دون الحاجة إلى استخدام مكتبات خارجية. قراءة الملفات تستخدم الدالة open()‎ لقراءة الملفات في بايثون، وتعيد هذه الدالة كائن file وتستخدم عادة مع وسيطين open(filename, mode)‎ كما هو موضح في المثال التالي: >>> f = open('workfile', 'w') الوسيط الأول هو سلسلة نصية تتضمن اسم الملف المراد فتحه. أما الوسيط الثاني فهو سلسلة نصية أيضًا تتضمن بضع حروف تصف طريقة استخدام الملف المفتوح. يمكن للوسيط الثاني mode أن يأخذ القيمة ...

 الصنف pathlib.PurePath في بايثون يحوي هذا الصنف التوابع والعمليات الأساسية للتعامل مع المسارات، إلا أنها لا تحوي أي وصول حقيقي إلى نظام الملفات، ومن ثمّ فليس فيها أي عملية إدخال أو إخراج بل تقتصر على العمليات النصية على المسارات، ويمكننا تلخيص عملها بأنها توابع لمعالجة السلاسل النصية التي تمثل مسارات الملفات. يمكن للمسارات النقية أن تكون مفيدةٌ في بعض الحالات الخاصة المماثلة لما يلي: لمعالجة مسارات نظام ويندوز أثناء العمل على جهاز يعمل بنظام يونكس (والعكس بالعكس)، حيث لا يمكنك ...

تعيد الدالة اللهجة المرتبطة بالاسم المعطى. البنية العامة csv.get_dialect(name) ‎المعاملات name اسم اللهجة المطلوبة. القيمة المعادة تعيد الدالة اللهجة المرتبطة بالاسم المعطى. تُطلق الدالة استثناء إن كان الاسم المعطى غير موجود في سجلّ اللهجات. تعيد الدالة كائن Dialect غير قابل للتعديل. أمثلة يعرض المثال التالي طريقة الاستفادة من هذه الدالة: >>> import csv >>> csv.register_dialect('unixpwd', delimiter=':', quoting=csv.QUOTE_NONE) >>> csv.get_dialect('unixpwd') <_csv.Dialect object at 0x7f29af0a6ae8> >>> csv.get_dialect('xpwd') Traceback (most recent call last): File "<stdin>", line 1, in <module> _csv.Error: unknown dialect انظر أيضًا الدالة csv.register_dialect()‎: تربط الدالة ...

 التابع Path.cwd يعيد كائن مسار جديدًا يمثّل المسار الحالي (بشكل مشابه للتابع os.getcwd) البنية العامة Path.cwd() المعاملات بدون معاملات القيمة المعادة يعيد كائن مسار جديدًا يمثّل المسار الرئيسي (home directory) للمستخدم أمثلة يبين المثال التالي طريقة استخدام التابع: >>> from pathlib import Path >>> Path.cwd()#لاحظ أنه يمكن استدعاء التابع دون إنشاء كائن منه WindowsPath('D:/Downloads/WinPython/notebooks') >>> import os >>> os.getcwd()#تابع يقوم بنفس الوظيفة في وحدة نظام التشغيل 'D:\\Downloads\\WinPython\\notebooks' >>> os.chdir('C:\\Program Files (x86)')#تغيير مسار المجلد الرئيسي >>> Path.cwd() WindowsPath('C:/Program Files (x86)') انظر أيضًا التابع os.getcwd في الوحدة os يقوم بنفس ...

 التابع PurePath.with_suffix في بايثون يعيد مسارًا جديدًا بعد تغيير امتداد الملف، وإن لم يكن للملف امتداد فإنه يضيف الامتداد المُعطى إليه. البنية العامة >>> p = PureWindowsPath('c:/Downloads/pathlib.tar.gz') >>> p.with_suffix('.bz2') PureWindowsPath('c:/Downloads/pathlib.tar.bz2') >>> p = PureWindowsPath('README') >>> p.with_suffix('.txt') PureWindowsPath('README.txt') المعاملات الوسيط suffix الامتداد الجديد للملف. القيمة المعادة يعيد مسارًا جديدًا بعد تغيير امتداد الملف، وإن لم يكن للملف امتداد فإنه يضيف الامتداد المُعطى إليه. أمثلة يبين المثال التالي طريقة استخدام التابع: >>> p = PureWindowsPath('c:/Downloads/pathlib.tar.gz') >>> p.with_suffix('.bz2') PureWindowsPath('c:/Downloads/pathlib.tar.bz2') >>> p = PureWindowsPath('README') >>> p.with_suffix('.txt') PureWindowsPath('README.txt') >>> p=PureWindowsPath('C:/Program Files/Windows Mail/wab.exe') >>> p.suffix '.exe' >>> p.with_suffix('.txt') PureWindowsPath('C:/Program Files/Windows Mail/wab.txt') >>> ...

ملفات الإعدادات على مستوى النظام System-wide Configuration files الملف etc/profile/ تقرأ Bash التعليمات الموجودة في etc/profile/ إن استدعيْت بشكل تفاعلي عبر خيار login-- أو إن استدعيْت كـ sh ، تضبط تلك التعليمات عادة المتغيرات PATH - USER - MAIL - HOSTNAME - HISTSIZE ، وهي متغيرات تابعة للصدفة. كذلك تُضبط قيمة umask في etc/profile/ على بعض الأنظمة، أما في بعضها الآخر فإن هذا الملف يحتوي على موجّهات (pointers) لملفات الإعدادات الأخرى مثل: ملف etc/inputrc/ ، وهو ملف تهيئة على مستوى ...

الاستقرار: 1-قيد التجريب تحوي Node.js دعمًا لوحدات ES اعتمادًا على Node.js EP من أجل وحدات ES. ليست جميع مزايا EP كاملةً بعد، وستُحضَر كدعمٍ وتنفيذٍ من أجل VM عندما يكون جاهزًا. لا تزال رسائل الخطأ في طور التحسين والتطوير. عملية التفعيل يمكن استعمال الراية ‎--experimental-modules‎ لتفعيل المزايا التي تمكن من تحميل وحدات ESM. متى ما ضُبِط ذلك، يمكن تحميل الملفات التي تنتهي باللاحقة ‎.mjs‎ كوحدات ES. node --experimental-modules my-app.mjs المزايا المزايا المدعومة يمكن أن يكون الوسيط CLI لنقطة الإدخال الرئيسية ...

تقرأ الدالة قيمة واحدة من الملف المفتوح وتعيدها. البنية العامة marshal.load(file) ‎المعاملات file الملف الذي ستقرأ الدالة منه قيمة واحدة. يجب أن يكون الملف المعطى ملفًّا ثنائيًا قابلًا للقراءة. القيمة المعادة تقرأ الدالة قيمة واحدة من الملف المفتوح وتعيدها. في حال عدم تمكّن الدالة من قراءة أيّ قيمة سليمة (كأن يكون السبب هو أنّ البيانات تمتلك نسخة ترتيب مختلفة وغير متوافقة مع نسخة الترتيب في إصدار بايثون المستخدم) تطلق اللغة الخطأ EOFError أو ValueError أو TypeError. أمثلة يبين المثال التالي ...

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

تعرِض هذه الصفحة عددًا من التعابير الاصطلاحيّة المستخدَمة بكثرةٍ في لغة Kotlin، ولأيّ اصطلاحٍ جديدٍ لم يُذكَر فيمكنك تعديل هذه الصفحة لإضافته. إنشاء كائنات نقل البيانات DTO:‏ Data Transfer Objects (الكائنات POJO/POCO) ليكن الصنف (class) الآتي باسم Customer: data class Customer(val name: String, val email: String) وله التوابع الوظيفيّة (functional methods) الآتية: توابع getter (وتوابع setter في حالة المتحولات من النوع var) لكافة الخاصّيّات (properties) equals()‎ hashCode()‎ toString()‎ copy()‎ component1()‎ و component2()‎ ...إلخ. وذلك لكافة الخاصّيّات (properties) في الصنف (راجع أصناف البيانات ...

صنف تغليف wrapper تحوّل كائنًا شبيهًا بالملف file-like object إلى مكرّر. تدعم الكائنات الناتجة التكرار استخدام التابعين ‎__getitem__()‎ و ‎__iter__()‎ وذلك للتوافق مع الإصدار 2.1 من بايثون ومع Jython. البنية العامة wsgiref.util.FileWrapper(filelike, blksize=8192) المعاملات ‎blksize المعامل الاختياري يُمُرّر بصورة متكررة في كلّ مرة يجري فيها المرور على الكائن، إلى التابع read()‎ في الكائن الشبيه بالملف المعطى وذلك للحصول على سلاسل بايتات نصية. إذا أعاد التابع read()‎ سلسلة بايتات نصية فارغة، تتوقّف عملية التعاود تمامًا. إن كان الكائن الشبيه بالملفات المعطى ...

صنف تغليف wrapper تحوّل كائنًا شبيهًا بالملف file-like object إلى مكرّر. تدعم الكائنات الناتجة التكرار استخدام التابعين ‎__getitem__()‎ و ‎__iter__()‎ وذلك للتوافق مع الإصدار 2.1 من بايثون ومع Jython. البنية العامة wsgiref.util.FileWrapper(filelike, blksize=8192) المعاملات ‎blksize المعامل الاختياري يُمُرّر بصورة متكررة في كلّ مرة يجري فيها المرور على الكائن، إلى التابع read()‎ في الكائن الشبيه بالملف المعطى وذلك للحصول على سلاسل بايتات نصية. إذا أعاد التابع read()‎ سلسلة بايتات نصية فارغة، تتوقّف عملية التعاود تمامًا. إن كان الكائن الشبيه بالملفات المعطى ...

بعد قراءة هذا الدّليل، ستتمكّن من: إنشاء تطبيق ريلز. توليد النماذج، ووحدات التحكّم، وتهجيرات قاعدة البيانات (database migrations)، ووحدات الاختبار. بدء الخادم الإنتاجي. كيفية تجربة الكائنات من خلال صدفة تفاعليّة (interactive shell) يفترض هذا الدليل أن لديك معرفة أساسية بإطار العمل ريلز من قراءة دليل البدء مع ريلز. أساسيات سطر الأوامر هناك بضعة أوامر تُعتبر حاسمة للغاية لاستخدامك اليومي لإطار العمل ريلز. هذا الأوامر مرتّبة حسب كثرة استخدامها تقريبًا بالشكل التالي: rails console rails server bin/rails rails generate rails dbconsole ...

يفسّر التابع الإعدادات من سلسلة نصية. ملاحظة: هذا التابع جديد في الإصدار 3.2 من بايثون. البنية العامة read_string(string, source='<string>') المعاملات ‎string السلسلة النصية المراد تفسير الإعدادات فيها. source معامل اختياري يحدد اسمًا خاصًّا بالسياق context-specific name للسلسلة النصية الممرّرة. تُستخدم القيمة '<string>' في حال عدم استخدام هذا المعامل. عادة ما تكون قيمة هذا المعامل مسارًا في ملفات النظام أو عنوان URL. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import configparser >>> sample_config = """ ... [mysqld] ... user = mysql ... ...

تحذف الدّالة delattr()‎ الخاصيّة المُعطاة من الكائن (إن سمَح الكائن بحذف الخاصيّة). البنية العامة delattr(object, name) المعاملات object الكائن المرغوب حذف خاصيّةٍ من خاصيّاته. name سلسلة نصيّة تُمثّل اسم الخاصيّة المرغوب حذفها. القيمة المعادة القيمة None كبقيّة الدّوال التي لا تُعيد أي قيمة صراحةً في بايثون. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة، لاحظ أنّها مُشابهة للكلمة المفتاحيّة del التي تحذف الكائنات: >>> class A: ... def __init__(self, a=1, b=2): ... ...

(PHP 4 >= 4.3.0, PHP 5, PHP 7) تقرأ الدالة file_get_contents()‎ الملف ثمَّ تضع كلَّ محتوياته في سلسلة نصيَّة. الوصف string file_get_contents ( string $filename [, bool $use_include_path= FALSE [, resource $context [, int $offset = 0 [, int $maxlen ]]]] ) تشبه هذه الدالة إلى حدٍّ كبير الدالة file()‎ باستثناء أنَّها تعيد محتوى الملف في سلسلة نصيَّة. يبدأ ذلك المحتوى عند الموقع offset ويكون بطول maxlen بايت. تعيد هذه الدالة عندما تفشل القيمة FALSE. تعدُّ الدالة file_get_contents()‎ وسيلة مفضَّلة لقراءة ...

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

الاستقرار: 2 - مستقر توفِّر الوحدة fs‎ واجهةً برمجيةً للتعامل مع نظام الملفات بطريقة قريبة جدًا من دوال POSIX القياسية. يمكن الوصول إلى هذه الوحدة باستعمال الأمر التالي: const fs = require('fs'); جميع عمليات نظام الملفات لها أشكال متزامنة وغير متزامنة. تأخذ الأشكال المتزامنة دالة رد نداء مكملة دومًا وتُمرَّر إليها كآخر وسيط. تعتمد الوسائط المُمرَّرة إلى دالة رد النداء المكملة تلك على التابع نفسه، ولكن الوسيط الأول فيها محجوزٌ دومًا للاستثناء. إن اكتملت العملية بنجاح، فستكون قيمة هذا الوسيط null‎ ...

يجري التابع test عدة اختبارات على ملف واحد أو على ملفين. البنية العامة test(cmd, file1 [, file2] ) → obj‎ المعاملات cmd‎ يحدد الاختبار المراد تطبيقه. اختبارات File التي تطبَّق على ملف واحد هي: المعامل cmd نوع القيمة المعادة وصف "A" Time توقيت آخر دخول إلى الملف file1. "b" قيمة منطقية يعيد True إن كان الملف file1 جهازًا كتليًّا (block device). "c" قيمة منطقية يعيد True إن كان file1 من النوع جهازًا محرفيًّا (character device). "C" Time توقيت آخر تغيير ...

استخدام أمر read أمر read هو الأمر المتمم لأمريْ echo و printf، وبنيته اللغوية كالتالي: read [options] NAME1 NAME2 ... NAMEN يُقرأ سطر واحد من المُدخل القياسي (standard input) أو من واصف ملف (file descriptor) أُدخِل كوسيط لخيار u-، وتُعيَّن أول كلمة من السطر لأول اسم NAME1، والثانية للاسم الثاني NAME2 وهكذا، ثم تُعيَّن الكلمات المتبقية وفاصلاتها المتداخلة (intervening seperators) إلى الاسم الأخير NAMEN، أما إن كانت الكلمات المقروءة من مجرى الدخل أقل من الأسماء فتعيَّن قيم فارغة لتلك الأسماء. تُستخدم ...

تفتح الدّالة open()‎ ملفّا وتعيد كائن ملفّ (file object) مرتبط به. إن لم يُمكِن فتح الملفّ، فسيُطلَق الاستثناء OSError‎. البنية العامة open(file, mode='r', buffering=-1, encoding=None, errors=None, newline=None, closefd=True, opener=None) المعاملات file كائن مُشابه للمسارات (path-like object) يُمثّل مسار الملفّ (سواء أكان مُطلقا أو نسبيًّا) المرغوب فتحه. يُمكن كذلك أن يكون واصف ملفّ عدديّ (integer file descriptor) للملفّ لتغطيّته (wrap). إن مُرّر واصف ملفّات، فسيُغلَق عندما يُغلَق كائن I/O المُعاد، إلّا في حالة كانت قيمة المُعامل closefd تساوي False. mode مُعامل ...

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

التابع Path.mkdir في بايثون يُنشئ هذا التابع مجلّدًا في المسار المُعطى بالخصائص التي يتم تحديدها في باقي الوسطاء. Create a new directory at this given path. If mode is given, it is combined with the process’ umask value to determine the file mode and access flags. If the path already exists, FileExistsError is raised. If parents is true, any missing parents of this path are created as needed; they are created with the default permissions without taking mode into account ...

تمتلك عبارة try جزءًا اختياريًا آخر، والهدف منه هو تعريف أحداث تنظيف (clean-up actions) يجب تنفيذها في جميع الظروف، فعلى سبيل المثال: >>> try: ...     raise KeyboardInterrupt ... finally: ...     print('Goodbye, world!') ... Goodbye, world! KeyboardInterrupt Traceback (most recent call last):   File "<stdin>", line 2, in <module> تُنفّذ عبارة finally دائمًا قبل الخروج من عبارة try، سواء أحدث الاستثناء أم لم يحدث. وعند حدوث استثناء في عبارة try ولم تجر معالجته بواسطة عبارة except (أو أنّه حدث في عبارة except أو else) فإنّه يعاد إطلاق ذلك ...

تمتلك عبارة try جزءًا اختياريًا آخر، والهدف منه هو تعريف أحداث تنظيف (clean-up actions) يجب تنفيذها في جميع الظروف، فعلى سبيل المثال: >>> try: ...     raise KeyboardInterrupt ... finally: ...     print('Goodbye, world!') ... Goodbye, world! KeyboardInterrupt Traceback (most recent call last):   File "<stdin>", line 2, in <module> تُنفّذ عبارة finally دائمًا قبل الخروج من عبارة try، سواء أحدث الاستثناء أم لم يحدث. وعند حدوث استثناء في عبارة try ولم تجر معالجته بواسطة عبارة except (أو أنّه حدث في عبارة except أو else) فإنّه يعاد إطلاق ذلك ...

مقدمة تعليمات الشرطات المائلة الثلاث (Triple-slash directives) هي تعليقات تكتب في سطر واحد تحتوي على وسم XML واحد. تُستخدَم محتويات التعليق كتعليمات (إرشادات) للمترجم. تكون تعليمات الشرطات المائلة الثلاث صالحةً فقط في أعلى الملفّ الذي تكون هذه التعليمات موجودة داخله. ويُمكن لهذه التعليمات أن تُسبَق فقط بتعليق في سطر واحد أو تعليق متعدّد الأسطر (multi-line comment)، ما يشمل تعليمات شرطات مائلة ثلاث أخرى. إذا وُجِدَت بعد جملة أو تصريح فستُعامَل على أنها تعليقات عادية في سطر واحد (regular single-line comments)، ...

يقدّم هذا الدليل التقنيات اللازمة لتنقيح تطبيقات ريلز. بعد قراءة هذا الدليل، ستتعلّم: الغرض من التنقيح. كيفة تتبّع العلل والأخطاء التي لا تتعرّف عليها الاختبارات في تطبيقك. طرقًا مختلفة للتنقيح. كيفيّة تحليل أثر المكدس. مساعدي العرض للتنقيح احدى المهام الشائعة في التنقيح هي فحص محتويات متغيّر معيّن، لذا يوفر ريلز ثلاثة طرائق لفعل ذلك: Debug To_yaml Inspect debug سيعيد المساعد debug الوسم <pre> الذي يصدّر الكائن باستخدام تنسيق YAML، وسيؤدي هذا إلى توليد بيانات يمكن للإنسان قراءتها من أي كائن. ...

تستعمل الوحدة Process للتعامل والتحكم بجميع العمليات في روبي. الثوابت CLOCK_BOOTTIME اطلع على توثيق التابع clock_gettime. CLOCK_BOOTTIME_ALARM اطلع على توثيق التابع clock_gettime. CLOCK_MONOTONIC اطلع على توثيق التابع clock_gettime. CLOCK_MONOTONIC_COARSE اطلع على توثيق التابع clock_gettime. CLOCK_MONOTONIC_FAST اطلع على توثيق التابع clock_gettime. CLOCK_MONOTONIC_PRECISE اطلع على توثيق التابع clock_gettime. CLOCK_MONOTONIC_RAW اطلع على توثيق التابع clock_gettime. CLOCK_MONOTONIC_RAW_APPROX اطلع على توثيق التابع clock_gettime. CLOCK_PROCESS_CPUTIME_ID اطلع على توثيق التابع clock_gettime. CLOCK_PROF اطلع على توثيق التابع clock_gettime. CLOCK_REALTIME اطلع على توثيق التابع clock_gettime. CLOCK_REALTIME_ALARM اطلع على توثيق ...

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

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

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

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

يغلق التابع كائن TarFile. في وضع الكتابة، يلحق التابع بالأرشيف كتلتين من أصفار الإنهاء finishing zero block. البنية العامة TarFile.close() ‎أمثلة يبين المثال التالي طريقة استخدام التابع: >>> import tarfile >>> tar = tarfile.open('files.tar', 'w') >>> tar.close() انظر أيضًا التابع TarFile.open()‎: دالة بانية بديلة لكائنات TarFile. مصادر صفحة Read and write tar archive files في توثيق بايثون الرسمي.

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

تعيد الدّالة iter()‎ مُكرّرًا حسب المُعاملات المُعطاة. البنية العامة iter(object[, sentinel]) المعاملات object إن لم يكن المُعامل الثّاني sentinel حاضرًا، فلا بدّ لهذا المُعامل أن يكون كائنًا يدعم بروتوكول التّكرار (أي أنّ صنفه يُعرّف التّابع الخاصّ ‎_‎_‎iter‎_‎_‎(‎)‎)، أو يجب أن يدعم بروتوكول التّسلسلات (sequence protocol) الذي يُعرّف صنفه التّابع الخاصّ ‎_‎_‎getitem‎_‎_‎(‎)‎ مع مُعاملات تكون أعدادًا صحيحةً وتبدأ من الصّفر. وإن لم يدعم الكائن أيًّا من هذين البروتوكولين، فسيُطلق الاستثناء TypeError. sentinel مُعامل اختيّاريّ. إن مُرّرت قيمة لهذا المُعامل، فلا بدّ ...

تابع صنف يقرأ العضو التالي من كائن TarFile المعطى ويعيده على هيئة كائن TarInfo. البنية العامة TarInfo.fromtarfile(tarfile) المعاملات tarfile كائن TarFile. القيمة المعادة يعيد التابع كائن TarInfo. انظر أيضًا التابع TarInfo.frombuf()‎: تابع صنف ينشئ ويعيد كائن TarInfo من سلسلة ذاكرة نصية string buffer (أو ما يعرف بملف الذاكرة) معطاة. مصادر صفحة Read and write tar archive files في توثيق بايثون الرسمي.

يتوافر العديد من خيارات سطر الأوامر التي يمكن استعمالها مع Node.js. تُستعمَل هذه الخيارات في تنقيح أخطاء الشيفرة، والتحكم في كيفيَّة تنفيذ الشيفرة، وغيرها من الأمور المفيدة. يمكن عرض هذا التوثيق في الطرفيَّة عبر استعمال الأمر man node. البنية العامة node [options] [V8 options] [script.js | -e "script" | -] [--] [arguments] node debug [script.js | -e "script" | <host>:<port>] … node --v8-options إنَّ تنفيذ node دون أيَّة وسائط يؤدي إلى بدئها مع الوحدة REPL. لمزيدٍ من المعلومات حول node debug، راجع رجاءً ...

تعيد الدالة الحجم الأقصى للحقل والذي يسمح المحلّل parser باستخدامه. البنية العامة csv.field_size_limit([new_limit]) المعاملات new_limit معامل اختياري يحدّد الحجم الجديد. القيمة المعادة تعيد الدالة الحجم الأقصى للحقل والذي يسمح المحلّل parser باستخدامه. أمثلة يبين المثال التالي آلية عمل الدالّة: >>> csv.field_size_limit() 131072 >>> csv.field_size_limit(160000) 131072 >>> csv.field_size_limit() 160000 مصادر صفحة CSV File Reading and Writing في توثيق بايثون الرسمي.

تتحقق الدالة ممّا إذا كان بمقدور الوحدة tarfile قراءة ملف الأرشيف المعطى. البنية العامة tarfile.is_tarfile(name) ‎المعاملات ‎ name أرشيف tar الذي ستتحقّق الدالة من إمكانية فتحه بواسطة الوحدة tarfile. القيمة المعادة تعيد الدالة القيمة True إن كانت قيمة name هي ملف أرشيف من نوع tar يمكن للوحدة tarfile أن تقرأه، وتعيد القيمة False فيما عدا ذلك. مصادر صفحة Read and write tar archive files في توثيق بايثون الرسمي.

تفكّ الدالة الضغط عن البيانات المعطاة وتعيد كائن bytes يتضمّن البيانات غير المضغوطة. البنية العامة gzip.decompress(data) المعاملات ‎data البيانات المراد ضغطها. ملاحظة: هذه الدالة جديدة في الإصدار 3.2 من بايثون. القيمة المعادة تعيد الدالة كائن bytes يتضمّن البيانات غير المضغوطة. انظر أيضًا الدالة gzip.compress()‎: تضغط الدالة البيانات المعطاة وتعيد كائن bytes يتضمّن البيانات المضغوطة. مصادر صفحة Support for gzip files في توثيق بايثون الرسمي.

يعيد التابع السطر التالي في كائن المكرّر iterable object الخاص بكائن القراءة. البنية العامة csvreader.__next__() القيمة المعادة يعيد التابع السطر التالي في كائن المكرّر الخاص بكائن القراءة على هيئة قائمة (إن كان الكائن معادًا من الدالة reader()‎) أو قاموس (إن كان الكائن نسخة من الصنف DictReader) وتكون القيمة المعادة مفسّرة بحسب اللهجة المستخدمة. يُستدعى هذا التابع عادة بهذه الطريقة next(reader)‎. مصادر صفحة CSV File Reading and Writing في توثيق بايثون الرسمي.

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

كيفية عمل حلقة until تشبه هذه الحلقةُ التكرارية حلقةَ while باستثناء أن الحلقة هنا تُنفَّذ إلى أن يُنفَّذ أمر اختباري TEST-COMMAND بنجاح، فتظل الحلقة عاملة طالما كان تنفيذ الأمر الاختباري يفشل. والبنية اللغوية لها تشبه البنية اللغوية لحلقة while : until TEST-COMMAND; do CONSEQUENT-COMMANDS; done وحالة الإعادة لهذه الحلقة هي نفسها حالة الخروج لآخر أمر يُنفَّذ من الأوامر التابعة CONSEQUENT-COMMANDS أو تكون صفرًا إن لم يُنفَّذ أي أمر. وقد يكون الأمر الاختباري TEST-COMMAND أي أمر يمكن أن يخرج بحالة نجاح أو فشل، ...

تعيد الدالة قائمة باللهجات المسجّلة. البنية العامة 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 في توثيق بايثون الرسمي.

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

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

تُقرأ شيفرات بايثون بواسطة المحلّل parser. مدخلات المحلّل هي تدفّق من العلامات tokens التي ينشئها محلل المفردات lexical analyzer. يصف هذا القسم طريقة تقسيم ملفات بايثون إلى علامات بواسطة محلل المفردات. بنية السطر تقسم شيفرة بايثون إلى نوعين من الأسطر هما الأسطر المنطقية والأسطر الفيزيائية. الأسطر المنطقية Logical lines ينتهي السطر المنطقي بعلامة السطر الجديد NEWLINE، ولا يمكن للعبارات أن تتجاوز حدود السطر المنطقي إلا إذا كانت صيغتها تسمح بذلك. ويتألف السطر المنطقي من سطر فيزيائي واحد أو أكثر وبالاعتماد ...

الصنف pathlib.Path في بايثون هو الصنف العام للأصناف التي تتعامل مع المسارات مع السماح بالقيام بعمليات الإدخال والإخراج، وتُسمّى بأصناف المسارات الصلبة Concrete Paths. البنية العامة pathlib.Path(*args,**kwargs)‎ المعاملات args* يمكن تمرير عدد غير محدود من السلاسل النصية أو من كائنات من النوع Path حيث تمثل السلاسل النصية أسماء المجلدات والملفات بالترتيب من المستوى الأعلى للأدنى. kwargs** معامل غير مستخدم. يمكنك مراجعة المقال التالي بخصوص هذا النوع من المعاملات. الاستخدام الأساسي يمكن إنشاء كائن من الصنف Path بثلاث طرق مختلفة: 1- ...

مؤشر الاستقرار: 2 - مستقر. توفر وحدة المسار path أدوات للعمل مع مسارات الملفات والمجلدات. ويمكن الوصول إليها باستخدام: const path = require('path'); ويندوز في مقابل POSIX يختلف التشغيل الإفتراضي لوحدة path استنادًا إلى نظام التشغيل الذي يعمل عليه أحد تطبيقات Node.js. على وجه التحديد، عند تشغيل نظام تشغيل ويندوز، ستفترض وحدة path استخدام نمط ويندوز للمسارات. على سبيل المثال، استخدام الدالة path.basename()‎ مع مسار ويندوز للملف C:\temp\myfile.html، وسيُسفر ذلك عن نتائج مختلفة عند تشغيله على نظام يتبع معايير POSIX ...

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

تابع صنف classmethod ينشئ ويعيد كائن TarInfo من سلسلة ذاكرة نصية string buffer (أو ما يعرف بملف الذاكرة) معطاة. البنية العامة TarInfo.frombuf(buf, encoding, errors) المعاملات buf سلسلة ذاكرة نصية string buffer يستخدمها التابع لإنشاء كائن TarInfo. القيمة المعادة يعيد التابع كائن TarInfo. يطلق التابع الاستثناء HeaderError إن كان ملف الذاكرة غير صالح للاستخدام. انظر أيضًا التابع TarInfo.fromtarfile()‎: تابع صنف يقرأ العضو التالي من كائن TarFile المعطى ويعيده على هيئة كائن TarInfo. مصادر صفحة Read and write tar archive files في توثيق ...

يعيد التابع قائمة بأسماء الأعضاء في الأرشيف. البنية العامة 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 في توثيق بايثون ...

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

يحلّل التابع النموذج المعطى ويعيد صنفًا متفرعًا من الصنف Dialect الذي يعكس المعاملات التي عثر عليها التابع. البنية العامة sniff(sample, delimiters=None) المعاملات ‎delimiters معامل اختياري، تُفسّر قيمته كسلسلة نصية تحتوي على المحارف التي يحتمل استخدامها كفواصل في ملف CSV. القيمة المعادة يعيد التابع صنفًا متفرعًا من الصنف Dialect. أمثلة يبين المثال التالي طريقة عمل التابع: with open('example.csv', newline='') as csvfile: dialect = csv.Sniffer().sniff(csvfile.read(1024)) csvfile.seek(0) reader = csv.reader(csvfile, dialect) ...

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

يعيد التابع قاموسًا يتضمّن القيم الافتراضية على مستوى نسخة الصنف instance-wide defaults. البنية العامة defaults() ‎القيمة المعادة يعيد التابع قاموسًا يتضمّن القيم الافتراضية على مستوى نسخة الصنف instance-wide defaults. أمثلة لنفرض أن لدينا ملف الإعدادات التالي: [DEFAULT] ServerAliveInterval = 45 Compression = yes CompressionLevel = 9 ForwardX11 = yes [bitbucket.org] User = hg [topsecret.server.com] Port = 50022 ForwardX11 = no يؤدي استدعاء التابع defaults()‎ إلى الحصول على المخرجات التالية: >>> import configparser >>> config = configparser.ConfigParser() >>> config.read('config.cfg') ['config.cfg'] >>> config.defaults() OrderedDict([('serveraliveinterval', '45'), ('compression', 'yes'), ('compressionlevel', '9'), ('forwardx11', 'yes')]) مصادر صفحة Configuration file parser في ...

تضغط الدالة البيانات المعطاة وتعيد كائن bytes يتضمّن البيانات المضغوطة. البنية العامة gzip.compress(data, compresslevel=9) المعاملات ‎data البيانات المراد ضغطها. compresslevel يحدّد المعامل compresslevel مستوى الضغط بنفس الطريقة المعتمدة في الدالة البانية لكائنات GzipFile. ملاحظة: هذه الدالة جديدة في الإصدار 3.2 من بايثون. أمثلة يبين المثال التالي طريقة ضغط سلسلة نصية ثنائية: import gzip s_in = b"Lots of content here" s_out = gzip.compress(s_in) انظر أيضًا الدالة gzip.decompress()‎: تفكّ الدالة الضغط عن البيانات المعطاة وتعيد كائن bytes يتضمّن البيانات غير المضغوطة. مصادر صفحة Support ...

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

قد تكون التعابير البرمجية في الشيفرة صحيحة من ناحية الصيغة، لكن قد يؤدي تنفيذ تلك الشيفرة إلى التسبب في حدوث الأخطاء. تسمّى الأخطاء المُكتشفة أثناء تنفيذ الشيفرة بالاستثناءات (exceptions) وقد تتسبب في إيقاف عمل البرنامج (fatal) في بعض الأحيان. صيغة الاستثناءات تُنشئ الاستثناءات رسائل خطإٍ مماثلة لما يلي: >>> 10 * (1/0) Traceback (most recent call last):   File "<stdin>", line 1, in <module> ZeroDivisionError: division by zero >>> 4 + spam*3 Traceback (most recent call last):   File "<stdin>", line 1, in <module> NameError: name 'spam' ...

ناقشنا بعض خيارات صدفة Bash التي قد تفيدك في تنقيح برامج Bash، وسننظر الآن في مزيد من تلك الخيارات بتفصيل أكثر. عرض الخيارات استخدم خيار o- لأمر set لعرض كل خيارات الصدفة: hsoub:~> set -o allexport off braceexpand on emacs ...

يعدّ تابع الصنف هذا بمثابة دالة بانية لكائنات TarFile. والدالة tarfile.open()‎ هي في الواقع اختصار لتابع الصنف هذا. البنية العامة TarFile.open(...) المعاملات يمتلك هذا التابع نفس المعاملات الموجودة في الدالة البانية للصنف TarFile. القيمة المعادة يعيد التابع كائن TarFile. أمثلة لو فرضنا وجود ملفّ مضغوط بصيغة tar فيمكن الوصول إلى هذا الملف وإنشاء كائن TarFile بالطريقة التالية: >>> import tarfile >>> tar = tarfile.TarFile.open("file.tar.xz") يمثّل tar الآن كائن TarFile يمكن استخدامه لتنفيذ التوابع الخاصة بهذا الكائن. انظر أيضًا الدالة tarfile.open()‎: تعيد ...

يحذف التابع زوج (مفتاح، قيمة) عشوائيًا من القاموس ويعيد قيمته. البنية العامة dict.popitem() القيمة المعادة يعيد التابع زوج (مفتاح، قيمة) المحذوف من القاموس، ويطلق الخطأ KeyError إن كانت المجموعة فارغة. أمثلة يبين المثال التالي النتائج المعادة من تطبيق التابع: >>> employee = {'first-name': 'Ahmed', 'last-name': 'Jamil', 'age': 28} >>> employee.popitem() ('age', 28) >>> employee.popitem() ('last-name', 'Jamil') >>> employee.popitem() ('first-name', 'Ahmed') >> employee.popitem() Traceback (most recent call last): File "<stdin>", line 1, in <module> KeyError: 'popitem(): dictionary is empty' انظر أيضًا القواميس في بايثون. التابع dict.pop()‎: حذف المفتاح المحدد ...

يطبع التابع جدولًا بمحتويات ملف الأرشيف إلى مخرجات النظام sys.stdout. البنية العامة ZipFile.printdir() ‎ القيمة المعادة يطبع التابع جدولًا بمحتويات ملف الأرشيف إلى مخرجات النظام sys.stdout. أمثلة يبين المثال التالي آلية عمل التابع: >>> import zipfile >>> zip = zipfile.ZipFile('files.zip') >>> zip.printdir() File Name ...

يُستخدَم العنصر <input> لإنشاء عناصر تفاعلية للنماذج في صفحات الويب التي تقبل معطيات من المستخدم، ثم تُرسَل إلى الخادوم. لتأخذ فكرة عن طريقة عمل (وشكل) مختلف أنواع العنصر <input>، فجرّب تعديل قيمة الخاصية type في المثال الحي الآتي، وسترى الناتج يُحدَّث أثناء كتابتك. وستُمثِّل القيمة الابتدائية (text) حقل إدخال نصيّ عادي، لكنك يمكنك تجربة قيم أخرى مثل number و color و checkbox و radio و date و file و month و password و range و time. مثال عن حقل نصي ...

يضيف التابع كائن 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()‎: ينشئ ...

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

يعيد التابع قائمة بالأقسام المتاحة، ولا يكون قسم الإعدادات الافتراضية DEFAULT ضمن هذه القائمة. البنية العامة sections() ‎القيمة المعادة يعيد التابع قائمة بالأقسام المتاحة، ولا يكون قسم الإعدادات الافتراضية DEFAULT ضمن هذه القائمة. أمثلة لنفرض أن لدينا ملف الإعدادات التالي: [DEFAULT] ServerAliveInterval = 45 Compression = yes CompressionLevel = 9 ForwardX11 = yes [bitbucket.org] User = hg [topsecret.server.com] Port = 50022 ForwardX11 = no يؤدي استدعاء التابع sections()‎ إلى الحصول على المخرجات التالية: >>> import configparser >>> config = configparser.ConfigParser() >>> config.read('config.cfg') ['config.cfg'] >>> config.sections() ['bitbucket.org', 'topsecret.server.com'] انظر أيضًا التابع defaults()‎: يعيد التابع قاموسًا يتضمّن ...

يعيد التابع قائمة بالخيارات المتاحة في القسم المحدد. البنية العامة options(section) ‎المعاملات section اسم القسم الذي سيعيد التابع الخيارات الموجودة فيه. القيمة المعادة يعيد التابع قائمة بالخيارات المتاحة في القسم المحدد. أمثلة إن كان لدينا ملف الإعدادات التالي: [DEFAULT] ServerAliveInterval = 45 Compression = yes CompressionLevel = 9 ForwardX11 = yes [bitbucket.org] User = hg [topsecret.server.com] Port = 50022 ForwardX11 = no يؤدي استدعاء التابع options()‎ إلى الحصول على النتائج التالية: >>> import configparser >>> config = configparser.ConfigParser() >>> config.read('config.cfg') ['config.cfg'] >>> config.options('topsecret.server.com') ['port', 'forwardx11', 'serveraliveinterval', 'compression', 'compressionlevel'] انظر أيضًا التابع sections()‎: يعيد التابع ...

يضيف التابع قسمًا يحمل الاسم المعطى إلى نسخة الصنف RawConfigParser. البنية العامة add_section(section) المعاملات ‎section اسم القسم المراد إضافته إلى ملف الإعدادات. القيمة المعادة إن كان هناك صنف يحمل الاسم ذاته فإنّ التابع يطلق الاستثناء DuplicateSectionError. وإن كان الاسم المعطى هو اسم قسم الإعدادات الافتراضية فإنّ التابع يطلق الاستثناء ValueError. لا يجري التحقّق من نوع القسم الأمر الذي يسمح للمستخدم بإنشاء أسماء أقسام غير نصية، وهذا السلوك غير مدعوم وقد يتسبب في حدوث أخطاء داخلية. أمثلة يبين المثال التالي طريقة ...

تحذف الدالة اللهجة المرتبطة بالاسم المعطى من سجلّ اللهجات. البنية العامة csv.unregister_dialect(name) ‎ المعاملات name اسم اللهجة المراد حذفها من سجلّ اللهجات. القيمة المعادة تحذف الدالة اللهجة المرتبطة بالاسم المعطى من سجلّ اللهجات. تطلق الدالة استثناءً إن كان الاسم المعطى غير موجود في سجلّ اللهجات. أمثلة يبين المثال التالي آلية عمل التابع: >>> import csv >>> csv.register_dialect('unixpwd', delimiter=':', quoting=csv.QUOTE_NONE) >>> csv.get_dialect('unixpwd') >>> csv.unregister_dialect('unixpwd') >>> انظر أيضًا الدالة csv.register_dialect()‎: تربط الدالة اللهجة المعطاة بالاسم المحدّد.. الدالة csv.get_dialect()‎: تعيد الدالة اللهجة المرتبطة بالاسم المعطى. الدالة csv.list_dialects()‎: ...

يعيد التابع العضو التالي في الأرشيف على هيئة كائن 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()‎: يعيد ...

يعيد التابع موقع أول ظهور للقيمة المعطاة في المصفوفة. البنية العامة ‎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 انظر ...

يعيد التابع كائن TarInfo لعضو ملف الأرشيف المعطى. البنية العامة TarFile.getmember(name) المعاملات name اسم العضو في ملف الأرشيف. القيمة المعادة يعيد التابع كائن TarInfo لعضو ملف الأرشيف المعطى، إن لم يتمكن التابع من العثور على الاسم المعطى في ملف الأرشيف، فإنّه يُطلق الاستثناء KeyError. ملاحظة: في حال تكرار عضو من أعضاء الأرشيف لأكثر من مرة، فإنّ الظهور الأخير لهذا العضو سيُعدّ النسخة الأحدث منه. أمثلة يبين المثال التالي آلية عمل التابع: >>> import tarfile >>> tar = tarfile.open(files.tar) >>> tar = tarfile.open('files.tar') >>> ...

توفر إضافة حالة الشبكة (cordova-plugin-network-information) تقديمًا لإصدار قديم من الواجهة البرمجية لمعلومات الشبكة، إذ توفر معلومات حول حالة الاتصال بشبكة الاتصال الخليوية (cellular) والشبكة اللاسلكي (wifi)، وتتحقق مما إذا كان الجهاز متصلًا بالإنترنت. للحصول على بعض الأفكار حول كيفية استخدام هذه الإضافة، انتقل إلى المثال التوضيحي في أسفل هذه الصفحة. التثبيت يمكن تثبيت هذه الإضافة عبر الأمر: cordova plugin add cordova-plugin-network-information‎ المنصات المدعومة أندرويد Browser iOS ويندوز Connection يُوفر الكائن connection، الذي يمكن الحصول عليه عبر navigator.connection، معلوماتٍ حول الاتصال ...

نُفضِّل في معظم الحالات استخدام المُكوّنات المضبوطة من أجل حقول الإدخال، ففي المُكوّنات المضبوطة يتعامل مُكوّن React مع بيانات الحقول. البديل لها هو المُكوّنات غير المضبوطة والتي يتعامل فيها DOM مع بيانات الحقول. لكتابة مُكوّن غير مضبوط بدلًا من كتابة معالج أحداث لكل تحديث للحالة، فبإمكانك استخدام المراجع للحصول على قيم الحقول من DOM. مثلًا تقبل هذه الشيفرة اسمًا واحدًا في المُكوّن غير المضبوط: class NameForm extends React.Component { constructor(props) { super(props); this.handleSubmit ...

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

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

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

تابع مساعد وظيفته تحويل الخيار المعطى في القسم المحدّد إلى عدد عشري ذي فاصلة عائمة. البنية العامة 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()‎: يجلب التابع الخيار المحدّد من القسم المعطى. ...

يكتب التابع تمثيلًا للإعدادات في كائن الملف المعطى. البنية العامة write(fileobject, space_around_delimiters=True) ‎المعاملات ‎fileobject كائن الملف المراد كتابة الإعدادات فيه. ‎space_around_delimiters إن أخذ هذا المعامل القيمة True سيضيف التابع مسافات بيضاء حول الفواصل التي تفصل القيم عن المفاتيح. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import configparser >>> config = configparser.ConfigParser() >>> config['DEFAULT'] = {'ServerAliveInterval': '45', ... 'Compression': 'yes', ... ...

قد تكون أخطاء الصيغة (Syntax errors) أو ما يعرف أيضًا بأخطاء الإعراب (Parsing errors) هي أكثر نوع من الأخطاء التي يواجهها المبتدئون عند تعلّم بايثون: >>> while True print('Hello world')   File "<stdin>", line 1     while True print('Hello world')                    ^ SyntaxError: invalid syntax يعيد المفسّر (parser) طباعة الجملة التي تحتوي على الخطأ مع سهم صغير يشير إلى مكان الخطأ ضمن السطر. ويكون الخطأ ناتجًا عن (أو اكتشف في) المكان الذي يسبق السهم. في المثال السابق ...

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

يستخرج التابع العضو المحدّد في المعاملات من ملف الأرشيف ككائن ملف. البنية العامة TarFile.extractfile(member) المعاملات ‎member يمكن أن يكون المعامل اسم ملف filename أو كائن TarInfo. إن كانت قيمة هذا المعامل ملفًا عاديًا أو وصلة فإنّ التابع سيعيد كائن io.BufferedReader، وإلا فإنّه سيعيد القيمة None. ملاحظة: أصبح التابع يعيد الكائن io.BufferedReader في الإصدار 3.3 من بايثون. القيمة المعادة يعيد التابع كائن ملف يمثّل الملفّ المُستخرج من أرشيف tar. أمثلة يبين المثال التالي آلية عمل التابع: >>> import tarfile >>> tar = ...

تحوّل الدالة الكائنات الشبيهة بالبايتات إلى قيمة. البنية العامة marshal.loads(bytes) ‎المعاملات bytes كائن شبيه بالبايتات. القيمة المعادة تحوّل الدالة الكائنات الشبيهة بالبايتات إلى قيمة. في حال عدم عثور الدالة على أي قيمة سليمة، تطلق اللغة الاستثناء EOFError أو ValueError أو TypeError، وتتجاهل الدالة البايتات الإضافية في المدخلات. أمثلة يبين المثال التالي آلية عمل الدالة: >>> import marshal >>> b1 = marshal.dumps('Hello World') >>> print(b1) b'\xfa\x0bHello World' >>> marshal.loads(b1) 'Hello World' انظر أيضًا الدالة marshal.load()‎: تعيد الدالة كائن bytes الذي ستجري كتابته في ملفّ معين بواسطة ...

قد تكون أخطاء الصيغة (Syntax errors) أو ما يعرف أيضًا بأخطاء الإعراب (Parsing errors) هي أكثر نوع من الأخطاء التي يواجهها المبتدئون عند تعلّم بايثون: >>> while True print('Hello world')   File "<stdin>", line 1     while True print('Hello world')                    ^ SyntaxError: invalid syntax يعيد المفسّر (parser) طباعة الجملة التي تحتوي على الخطأ مع سهم صغير يشير إلى مكان الخطأ ضمن السطر. ويكون الخطأ ناتجًا عن (أو اكتشف في) المكان الذي يسبق السهم. في المثال السابق ...

يغلق التابع المؤشر فورًا (عوضًا عن إغلاقه عند استدعاء التابع ‎__del__‎)، وبعدها لن يكون بالإمكان استخدام المؤشر، وستطلق اللغة الاستثناء ProgrammingError عند تنفيذ أي عملية باستخدام المؤشر. البنية العامة close() أمثلة يبين المثال التالي طريقة استخدام التابع: >>> import sqlite3 >>> conn = sqlite3.connect('example.db') >>> c = conn.cursor() >>> c.execute('''CREATE TABLE stocks ... (date text, trans text, symbol text, qty real, price real)''') <sqlite3.Cursor object at 0x7f0ea62989d0> >>> c.execute("INSERT INTO stocks VALUES ('2006-01-05','BUY','RHAT',100,35.14)") <sqlite3.Cursor ...

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

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

ملاحظة: هذا التابع مهمل منذ الإصدار 3.2 من بايثون، استخدم التابع read_file()‎ عوضًا عنه. ملاحظة: يمرّ التابع readfp()‎ على عناصر fp عوضًا عن استدعاء التابع fp.readline()‎. البنية العامة readfp(fp, filename=None) إن تضمنت الشيفرة استدعاءات للتابع readfp()‎ مع معاملات لا تدعم التكرار، فيمكن استخدام المولّد التالي لتغليف الكائن الشبيه بالملف: def readline_generator(fp): line = fp.readline() while line: yield line line = ...

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

تربط الدالة اللهجة المعطاة بالاسم المحدّد. البنية العامة csv.register_dialect(name[, dialect[, **fmtparams]]) المعاملات ‎name سلسلة نصية تتضمّن الاسم المراد ربطه باللهجة المعطاة. dialect يمكن تحديد اللهجة إمّا بتمرير صنف متفرّع عن الصنف Dialect، أو باستخدام المعاملات المفتاحية fmtparams أو كلاهما، مع الأخذ بنظر الاعتبار أنّ المعاملات المفتاحية ستعيد تعريف قيم المعاملات الخاصة باللهجة. راجع قسم اللهجات ومعاملات التنسيق للاطلاع على المزيد من المعلومات. أمثلة يبين المثال التالي طريقة تسجيل لهجة جديدة: import csv csv.register_dialect('unixpwd', delimiter=':', quoting=csv.QUOTE_NONE) with open('passwd', newline='') as f: ...

كائنات القراءة هي نسخ الصنف DictReader وتنشأ كذلك من الدالة reader()‎. خصائص كائنات القراءة تمتلك كائنات القراءة الخصائص العامة التالية: csvreader.dialect هذه الخاصية للقراءة فقط، وتتضمن وصفًا للهجة المستخدمة بواسطة المفسر. csvreader.line_num عدد الأسطر المقروءة من المكرِّر المصدر. يختلف هذا العدد عن عدد السجلّات المعادة، إذ يمكن للسجل الواحد أن يمتدّ لعدّة أسطر. تمتلك كائنات DictReader الخصائص العامة التالية: csvreader.fieldnames إن لم تمرّر هذه الخاصية كمعامل عند إنشاء الكائن، فإنّ هذه الخاصية تُهيّئ عند الوصول إليها لأول مرّة أو عند ...

يمكن تعريف الدوال مع عدد غير محدّد من المعاملات، وهناك ثلاث صيغ للمعاملات يمكن استخدامها معًا في نفس الوقت. المعاملات ذات القيم الافتراضية يمكن تحديد قيمة افتراضية للمعامل عند تعريفه، وبهذا يمكن استدعاء الدالة مع عدد أقلّ من المعاملات المعرّفة، فعلى سبيل المثال: def ask_ok(prompt, retries=4, reminder='Please try again!'): while True: ok = input(prompt) if ok in ('y', 'ye', 'yes'): ...

الوظائف العامة للصدفة يفسر برنامج صَدَفة يونكس أوامر المستخدم التي يدخلها بنفسه أو التي يمكن استخراجها وقراءتها من ملف نصي يسمى شيفرة الصَّدَفة النصية (shell script) أو برنامج الصدفة (shell program). وتكون تلك الملفات النصية مفسّرة (interpreted) على خلاف الملفات المُجمّعة (compiled)، بمعنى أن الصدفة تقرأ الأوامرَ سطرًا سطرًا وتبحث عنها في النظام، على خلاف البرامج المُجمَّعة التي يحوِّل المُجمِّع (compiler) شيفرتها إلى ملف تنفيذي (executable file) مكتوب بلغة يستطيع الحاسوب فهمها -لغة الآلة-، ثم يُمكن استخدام ذلك الملف بعدها ...

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

يشرح هذا الدليل العمل الداخلي لعملية التهيئة في ريلز. وهو دليل متعمق للغاية وموصى به لمطوري ريلز المتقدمّين. ستتعلم بعد قراءة هذا الدليل: كيفيّة استخدام خادم ريلز (rails server). التسلسل الزمني لتهيئة ريلز. أين تُطلَب الملفّات المختلفة أثناء تسلسل التمهيد. كيفيّة تعريف واجهة Rails::Server واستخدامها. يتضمّن هذا الدليل كل استدعاء لتابع مطلوب لتشغيل مكّدس Ruby on Rails (أي stack) لتطبيق ريلز افتراضي، مع شرح كل جزء بالتفصيل. بالنسبة لهذا الدليل، سنركّز على ما يحدث عند تنفيذ rails server لبدء إقلاع ...

يعيد التابع موقع العنصر المعطى في كائن deque. البنية العامة d.‎index(x[, start[, stop]]) المعاملات x العنصر المراد إيجاد موقعه في كائن deque. === start و stop يمكن البحث عن موقع العنصر x بدءًا من الموقع start وانتهاءً بالموقع stop. القيمة المعادة يعيد التابع موقع العنصر المعطى في كائن deque. ويطلق التابع الخطأ ValueError في حال عدم العثور على العنصر المطلوب. أمثلة يبين المثال التالي آلية عمل التابع. >>> from collections import deque >>> d = deque('abcdefgh') >>> d deque(['a', 'b', 'c', 'd', 'e', ...

تأخذ الدالة البانية للصنف PyZipFile نفس المعاملات الموجودة في الدالة البانية للصنف ZipFile إضافة إلى المعامل optimize. البنية العامة class zipfile.PyZipFile(file, mode='r', compression=ZIP_STORED, allowZip64=True, optimize=-1) ‎المعاملات optimize راجع توثيق التابع PyZipFile.writepy()‎ للاطلاع على وظيفة هذا المعامل. ملاحظات: هذا الكائن جديد في الإصدار 3.2 من بايثون. أصبحت إضافات ZIP64 مفعّلة بصورة افتراضية في الإصدار 3.4 من بايثون. توابع الصنف ZipFile تمتلك نسخ هذا الصنف نفس التوابع الموجودة في الصنف ZipFile إضافة إلى التابع التالي: التابع PyZipFile.writepy()‎ يبحث التابع عن الملفات ذات ...

يحذف التابع العنصر في الموقع المحدد من المصفوفة ويعيده. البنية العامة ‎array.pop([i]) المعاملات i موقع العنصر المراد حذفه. القيمة المعادة يعيد التابع العنصر المحذوف من الموقع المحدد في المصفوفة. أمثلة يبين المثال التالي آلية عمل التابع: >>> import array >>> a1 = array.array('l', [1, 2, 3, 4, 5]) >>> a1.pop(3) 4 >>> a1.pop(0) 1 >>> a1.pop(8) Traceback (most recent call last): File "<stdin>", line 1, in <module> IndexError: pop index out of range انظر أيضًا التابع array.append()‎: يضيف التابع عنصرًا جديدًا يحمل القيمة المعطاة إلى نهاية المصفوفة. ...

يقرأ التابع ويفسّر الإعدادات من المكرِّر iterable المعطى. البنية العامة read_file(f, source=None) ‎المعاملات f‎ مكرّر ينتج سلاسل نصية بترميز Unicode (مثل ملفات مفتوحة في الوضع النصي text mode). source معامل اختياري يحدد اسم الملف الذي تجري قرائته. إن لم يمرّر هذا المعامل وكان للمعامل f خاصية name فستُستخدم كقيمة للمعامل source. القيمة الافتراضية لهذا المعامل هي ‎'<???>'‎. ملاحظة: حلّ هذا التابع محلّ التابع readfp()‎ في الإصدار 3.2 من بايثون. أمثلة يبين المثال التالي طريقة عمل التابع: import configparser, os config = ...