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

من موسوعة حسوب
< Python‏ | os
اذهب إلى التنقل اذهب إلى البحث

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

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

getenv(key, default=None)

المعاملات

key

مُتغيّر البيئة المُراد الحصول على قيمته.

default

القيمة الافتراضيّة لمتغيّر البيئة في حال عدم وجوده.

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

تُعيد الدالة قيمة مُتغيّر البيئة المُمرَّر (key)، أو قيمة الوسيط default في حال عدم وجود المتغيّر. ينبغي أن تكون الوسائط والقيمة المعادة سلاسل نصيّة.

تُرمَّز المفاتيح (الوسيط key) والقيم (قيمة المتغيّر)، في أنظمة يونكس، بنظام الترميز المُعاد من الدالة ()sys.getfilesystemencoding. استخدم الدالة ()os.getenvb في حال كنت تريد استخدام نظام ترميز مُختلف.

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

أمثلة

يُظهِر المُقتطَف البرمجي أدناه مثال عن محاولة الحصول على قيمة مُتغيّر البيئة TEST الغير موجود في النظام، مما سيؤدي إلى إعادة قيمة الوسيط default بدلًا من ذلك.

>>> from os import getenv
>>> getenv(key="TEST", default="TEST")
'TEST'

مصادر