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

من موسوعة حسوب

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

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

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'

مصادر