نتائج البحث

تنفّذ هذه الوحدة بعض التوابع المهمة على أسماء المسارات، حيث يمكن تمرير معالملات المسار كنص أو كائن من نوع bytes، ويُستحسن للتطبيقات أن تقوم بتمثيل أسماء المسارات كسلسلة حروف بترميز Unicode. إلا أن بعض أسماء الملفات لا يمكن تمثيلها كسلاسل نصية في يونكس، لذلك تحتاج التطبيقات التي تدعم أسماء الملفات العشوائية في يونكس إلى تمثيلها باستخدام كائنات من نوع bytes. وبالعكس أيضًا، فاستخدام  كائنات من نوع bytes لا يمكنه تمثيل جميع أسماء الملفات في ويندوز (باستخدام ترميز mbcs المعياري)، لذلك ...

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

مؤشر الاستقرار: 2 - مستقر توفر وحدة نظام التشغيل os عددًا من توابع الأدوات المساعدة المتعلقة بنظام التشغيل. ويمكن الوصول إليها باستخدام: const os = require('os'); os.EOL أُضيف مع الإصدار: v0.7.8. من النوع <string> وهو ثابت من النوع سلسلة نصية ويحدد علامة نهاية السطر الخاصة بنظام التشغيل: ‎\n في POSIX. ‎\r\n في Windows. os.arch()‎ أُضيف مع الإصدار: v0.5.0. القيمة المُعادة: من النوع <string>. يعيد التابع os.arch()‎ سلسلة نصية تحدد بنية وحدة المعالجة المركزية لنظام التشغيل التي تُرجِمت إليها ثنائية Node.js. ...

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

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

تُعيد الدالة مُعرِّف العملية الحالية. البنية العامة getpid() القيمة المعادة تُعيد الدالة نوع عددي صحيح يُمثِّل مُعرِّف العملية الحالية. أمثلة يعرض المقتطف أدناه مثال على الحصول على مُعرِّف العملية الحالية (مُفسِر بايثون). >>> from os import getpid >>> getpid() 2761 مصادر قسم الوحدة os في توثيق بايثون الرسمي.

تُعيد الدالة مُعرِّف مجموعة العملية الحالية. البنية العامة getpgrp() الدالة متوافرة في أنظمة يونكس. القيمة المعادة تُعيد الدالة نوع عددي صحيح يُمثِّل مُعرِّف مجموعة العملية الحالية. أمثلة >>> from os import getpgrp >>> getpgrp() 21704 مصادر قسم الوحدة os في توثيق بايثون الرسمي.

تُغلِق الدالة واصِف الملف المُمرَّر. البنية العامة close(fd) المعاملات fd واصِف الملف المُراد إغلاقه. القيمة المعادة لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None). ملاحظة: هذه الدالة مُخصَّصة لعمليات الإدخال والإخراج مُنخفِضة المستوى، وينبغي استخدامها على واصفات الملفات المُعادة من دوال مثل ()os.open أو ()os.pipe. لإغلاق "كائِن ملف" مُعاد من دالة مَضمَّنة في بايثون مثل ()open، أو من دوال مثل ()os.popen أو ()os.fdopen، استخدم التابِع ()close الخاص به. أمثلة يبيّن المثال التالي آلية عمل الدالة. >>> import os >>> ...

تُعيد الدالة اسم ملف الطرفية المتحكمة بالعملية. البنية العامة ctermid() الدالة متوافرة في أنظمة يونكس. القيمة المعادة تُعيد الدالة اسم ملف الطرفية المتحكمة (controlling terminal) بالعملية. أمثلة >>> from os import ctermid >>> ctermid() '/dev/tty' مصادر قسم الوحدة os في توثيق بايثون الرسمي.

تُعيد الدالة المُعرِّف الحقيقي لمُستخدِم العملية الحالية. البنية العامة getuid() الدالة متوافرة في أنظمة يونكس. القيمة المعادة تُعيد الدالة نوع عددي صحيح يُمثِّل المُعرِّف الحقيقي (real id) لمُستخدِم العملية الحالية. أمثلة >>> from os import getuid >>> getuid() 1000 مصادر قسم الوحدة os في توثيق بايثون الرسمي.

تُعيد الدالة مُعرِّف العملية الأم للعملية الحالية. البنية العامة getppid() سجل التغييرات الإصدار التغييرات 3.2 إضافة الدعم لأنظمة ويندوز. الدالة متوافرة في أنظمة يونكس وويندوز. القيمة المعادة تُعيد الدالة نوع عددي صحيح يُمثِّل مُعرِّف العملية الأم للعملية الحالية. تُعيد الدالة على أنظمة يونكس، عند خروج العملية الأم، مُعرِّف إحدى العمليات الاستهلاليّة (ذات المُعرِّف 1)، بينما على أنظمة ويندوز سيُعاد نفس المُعرِّف الذي قد يكون أُستخدِمَ من عملية أخرى. أمثلة يُبيّن المثال التالي آلية عمل الدالة. >>> from os import getppid >>> ...

تُعيد الدالة قائمة بمُعرِّفات المجموعات الإضافيّة (supplemental group) المرتبطة بالعملية الحالية. البنية العامة getgroups() الدالة متوافرة في أنظمة يونكس. القيمة المعادة تُعيد الدالة قائمة بمُعرِّفات المجموعات الإضافيّة (supplemental group) المرتبطة بالعملية الحالية. أمثلة >>> from os import getgroups >>> getgroups() [10, 63, 171, 994, 1000] مصادر قسم الوحدة os في توثيق بايثون الرسمي.

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

 التابع 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 يقوم بنفس ...

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

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

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

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

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

تستدعي الدالة نداء النظام ()setsid الذي يُنشِئ جلسة جديدة ويضبط مُعرِّف مجموعة العملية. البنية العامة setsid() الدالة متوافرة في أنظمة يونكس. القيمة المعادة لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None). لاحظ أنَّ الدالة يجب أن تُنفَّذ من مُستخدِم يملك صلاحيات الجذر. طالِع صفحة الدليل لنداء النظام ()setsid للمزيد من التفاصيل. أمثلة يُبيّن المثال التالي آلية عمل الدالة. >>> from os import setsid >>> setsid() مصادر قسم الوحدة os في توثيق بايثون الرسمي.

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

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

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

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

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

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

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

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

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

تُغلِق الدالة واصفات الملفات بدءً من الواصِف المُمرَّر للمعامل fd_low وصولًا إلى الواصِف الذي يَسبُق الواصِف المُمرَّر للمعامل fd_high، مُتجاهلةً الأخطاء التي قد تَحدُث. البنية العامة closerange(fd_low, fd_high) المعاملات fd_low العدد البادِئ لمجال الواصِفات التي ستُغلَق (سيُغلَق الواصِف المُقابِل لهذا العدد). fd_high العدد المُمثِّل لنهاية مجال الواصِفات التي ستُغلَق (لن يُغلَق الواصِف المُقابِل لهذا العدد). القيمة المعادة لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None). أمثلة يُكافِئ استخدام الدالة تنفيذ الكود (ولكن الدالة تفعل ذلك بشكل أسرع): import ...

تُعيد الدالة رسالة الخطأ للرمز المُمرَّر. البنية العامة strerror(code) المعاملات code رمز الخطأ المراد الحصول على رسالته. القيمة المعادة تُعيد الدالة سلسلة نصيّة تحتوي على رسالة الخطأ للرمز المُمرَّر للمعامل code. ستُصدِر الدالة الاستثناء ValueError في الأنظمة التي تُعيد فيها الدالة ()strerror القيمة NULL عندما لا تتعرَّف على رسالة الخطأ (ستُعيد الرسالة سلسلة نصيّة توضِّح فيها أنَّها لم تتعرَّف على رمز الخطأ في الأنظمة الأخرى). أمثلة يُبيّن المثال التالي آلية عمل الدالة. >>> from os import strerror >>> strerror(0) 'Success' >>> strerror(1) 'Operation not ...

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

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

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

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

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

تستدعي الدالة نداء النظام ()setpgid لإسناد مُعرِّف المجموعة المُمرَّر للوسيط الثاني (pgrp) إلى العملية ذات المُعرِّف المُمرَّر للوسيط الأوَّل (pid). البنية العامة setpgid(pid, pgrp) الدالة متوافرة في أنظمة يونكس. المعاملات pid مُعرِّف العملية المُراد تحديدها. pgrp مُعرِّف المجموعة المُراد إسناده للعملية المُحدَّدة. القيمة المعادة لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None). لاحظ أنَّ الدالة يجب أن تُنفَّذ من مُستخدِم يملك صلاحيات الجذر. طالِع صفحة الدليل لنداء النظام ()setpgid للمزيد من التفاصيل. أمثلة يُبيّن المثال التالي آلية عمل الدالة. ...

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

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

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

تُعيد الدالة قيمة مُتغيّر البيئة المُمرَّر. القيمة المُعادة من هذه الدالة، وكذلك وسائِطها، مُمثَّلة بالبايتات. البنية العامة getenvb(key, default=None) المعاملات key مُتغيّر البيئة المُراد الحصول على قيمته. default القيمة الافتراضيّة لمتغيّر البيئة في حال عدم وجوده. القيمة المعادة تُعيد الدالة قيمة مُتغيّر البيئة المُمرَّر (key)، أو قيمة الوسيط default في حال عدم وجود المتغيّر. ينبغي أن تكون الوسائط والقيمة المعادة مُمثَّلة بالبايتات. تتوفر هذه الدالة فقط في حال كان للمتغيّر supports_bytes_environ القيمة True. الدالة متوفرة في معظم الأنظمة الشبيهة بيونكس. ...

تُغيّر الدالة مُجلَّد العمل الحالي إلى المُجلَّد المُمرَّر. البنية العامة 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 التي يحتاج إليها في عمله. انظر أيضًا الصنف ...

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