الفرق بين المراجعتين ل"Python/os/getenv"

من موسوعة حسوب
< Python‏ | os
اذهب إلى التنقل اذهب إلى البحث
ط (تصحيح التصنيف)
ط (إضافة قسم "المعاملات")
سطر 5: سطر 5:
 
<syntaxhighlight lang="python3">
 
<syntaxhighlight lang="python3">
 
getenv(key, default=None)
 
getenv(key, default=None)
</syntaxhighlight>حيث الوسيط <code>key</code> هو متغيّر البيئة، والوسيط <code>default</code> يُمثِّل القيمة الافتراضيّة لمتغيّر البيئة في حال عدم وجوده.
+
</syntaxhighlight>
 +
 
 +
== المعاملات ==
 +
 
 +
=== <code>key</code> ===
 +
مُتغيّر البيئة المُراد الحصول على قيمته.
 +
 
 +
=== <code>default</code> ===
 +
القيمة الافتراضيّة لمتغيّر البيئة في حال عدم وجوده.
  
 
== القيمة المعادة ==
 
== القيمة المعادة ==

مراجعة 20:00، 24 يوليو 2018

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

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

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'

مصادر