نتائج البحث

تُغيّر الدالة مُجلَّد العمل الحالي إلى المُجلَّد المُمرَّر. البنية العامة chdir(path) سجل التغييرات الإصدار التغييرات 3.3 إضافة القدرة على تمرير واصِف ملفات للوسيط path على بعض المنصات. 3.6 أصبحت الدالة قادرة على استقبال كائِن من النوع path-like. المعاملات path المُجلَّد المراد تغيير مُجلَّد العمل الحالي إليه. القيمة المعادة لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None). تدعم الدالة التعامل مع واصفات الملفات، ولكن على الواصف أن أن يُشير إلى مُجلَّد مفتوح وليس إلى ملف. أمثلة يُظهِر المقتطف أدناه ...

تُعيد الدالة اسم المُستخدم المُسجَّل في الطرفية المتحكمة بالعملية الحالية. البنية العامة getlogin() الدالة متوافرة في أنظمة يونكس وويندوز. القيمة المعادة تُعيد الدالة سلسلة نصيّة تحتوي على اسم المُستخدِم المُسجَّل في الطرفية المتحكمة بالعملية الحالية. لِمُعظم الاستخدامات، من الأفضل والأكثر إفادة استخدام الدالة ()getpass.getuser للحصول على اسم المُستخدِم؛ حيث أنَّ هذه الدالة تتحقَّق من مُتغيّرات البيئة LOGNAME و USERNAME لإيجاد اسم المُستخدِم، ومن ثمَّ تقوم بتنفيذ التعليمة pwd.getpwuid(os.getuid())[0]‎ للجصول اسم التسجيل (login name) للمُعرِّف الحقيقي (real id) للمُستخدِم الحالي. أمثلة يعرض ...

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

تُعيد الدالة قائمة بالمُجلَّدات التي سيتُم البحث فيها عن الملفات التنفيذيّة عند تشغيل عملية ما. البنية العامة get_exec_path(env=None) المعاملات env قاموس متغيّرات البيئة الذي سيُبحَث فيه عن المتغيّر PATH. تُسنَد القيمة None للوسيط env، ويُستخدَم القاموس os.environ للحصول على متغيّر البيئة PATH افتراضيًا. القيمة المعادة تُعيد الدالة قائمة بالمُجلَّدات التي سيتم البحث فيها عن الملفات التنفيذيّة، كما يحدث في الصدفة (shell)، عند تشغيل عملية ما. أمثلة يعرض المقتطف أدناه مثال عن استخدام الدالة للحصول على مسارات التي سيُبحَث فيها عن ...

تُعيد الدالة قيمة مُتغيّر البيئة المُمرَّر. البنية العامة getenv(key, default=None) المعاملات key مُتغيّر البيئة المُراد الحصول على قيمته. default القيمة الافتراضيّة لمتغيّر البيئة في حال عدم وجوده. القيمة المعادة تُعيد الدالة قيمة مُتغيّر البيئة المُمرَّر (key)، أو قيمة الوسيط default في حال عدم وجود المتغيّر. ينبغي أن تكون الوسائط والقيمة المعادة سلاسل نصيّة. تُرمَّز المفاتيح (الوسيط key) والقيم (قيمة المتغيّر)، في أنظمة يونكس، بنظام الترميز المُعاد من الدالة ()sys.getfilesystemencoding. استخدم الدالة ()os.getenvb في حال كنت تريد استخدام نظام ترميز مُختلف. ...

تُعيد الدالة قائمة بالمُجلَّدات التي سيتُم البحث فيها عن الملفات التنفيذيّة عند تشغيل عملية ما. البنية العامة get_exec_path(env=None) المعاملات env قاموس متغيّرات البيئة الذي سيُبحَث فيه عن المتغيّر PATH. تُسنَد القيمة None للوسيط env، ويُستخدَم القاموس os.environ للحصول على متغيّر البيئة PATH افتراضيًا. القيمة المعادة تُعيد الدالة قائمة بالمُجلَّدات التي سيتم البحث فيها عن الملفات التنفيذيّة، كما يحدث في الصدفة (shell)، عند تشغيل عملية ما. أمثلة يعرض المقتطف أدناه مثال عن استخدام الدالة للحصول على مسارات التي سيُبحَث فيها عن ...

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

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

التابع Path.home يعيد كائن مسار جديدًا يمثّل المسار الرئيسي (home directory) للمستخدم (بشكل مشابه للتابع os.path.expanduser مع الوسيط '~') وهو تابع جديد في النسخة 3.5. البنية العامة Path.home() المعاملات بدون معاملات القيمة المعادة يعيد كائن مسار جديدًا يمثّل المسار الرئيسي (home directory) للمستخدم. أمثلة يبين المثال التالي طريقة استخدام التابع: >>> from pathlib import Path >>> Path.home() WindowsPath('D:/Downloads/WinPython/settings') >>> import os >>> os.path.expanduser('~') 'D:\\Downloads\\WinPython\\settings' انظر أيضًا التابع os.path.expanduser في الوحدة os. مصادر قسم الوحدة pathlib في توثيق بايثون الرسمي.

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