عرض مصدر Python/os/unsetenv

{{DISPLAYTITLE:الدالة <code>()os.unsetenv</code> في بايثون}}
تُزيل الدالة مُتغيّر البيئة المُمرَّر.

== البنية العامة ==
<syntaxhighlight lang="python3">
unsetenv(key)
</syntaxhighlight>الدالة متوافرة في معظم الأنظمة الشبيهة بيونكس وفي أنظمة ويندوز.

== المعاملات ==

=== <code>key</code> ===
مُتغيّر البيئة المُراد إزالته.

== القيمة المعادة ==
لا تُعيد الدالة أي قيمة (أي أنَّ قيمتها المعادة [[Python/constants#None|None]]).

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

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

== أمثلة ==
يُبيّن المثال التالي آلية عمل الدالة.<syntaxhighlight lang="python3">
>>> from os import getenv, environ
>>> getenv("USER")
'TEST'
>>> del environ["USER"]
>>> getenv("USER")
>>>

</syntaxhighlight>

== مصادر ==
[https://docs.python.org/3/library/os.html#os.unsetenv قسم الوحدة os في توثيق بايثون الرسمي].
[[تصنيف:Python]]
[[تصنيف:Python Function]]
[[تصنيف:Python os]]