الدالة ()os.unsetenv في بايثون

من موسوعة حسوب
< Python‏ | os

تُزيل الدالة مُتغيّر البيئة المُمرَّر.

البنية العامة

unsetenv(key)

الدالة متوافرة في معظم الأنظمة الشبيهة بيونكس وفي أنظمة ويندوز.

المعاملات

key

مُتغيّر البيئة المُراد إزالته.

القيمة المعادة

لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة None).

التغييرات التي تجريها الدالة على البيئة تؤثِّر على العمليات الفرعيّة المُنشأة من الدوال ()os.system و ()os.popen و ()os.fork و ()os.execv.

حذف عنصر من القائمة os.environ، إذا ما كانت الدالة ()os.unsetenv مدعومة على المنصة، سيتحوَّل تلقائيًّا إلى استدعاء مماثل للدالة ()os.unsetenv. لاحظ أنَّ استدعاء الدالة ()os.unsetenv مباشرةً لن يُحدِّث القاموس os.environ، ولذلك يُفضَّل حذف مُتغيّرات البيئة من القاموس os.environ وليس بواسطة الدالة ()os.unsetenv.

أمثلة

يُبيّن المثال التالي آلية عمل الدالة.

>>> from os import getenv, environ
>>> getenv("USER")
'TEST'
>>> del environ["USER"]
>>> getenv("USER")
>>>

مصادر

قسم الوحدة os في توثيق بايثون الرسمي.