الفرق بين المراجعتين لصفحة: «Python/os/getenv»

من موسوعة حسوب
< Python‏ | os
ط تصحيح التصنيف
ط ترتيب التصنيفات
 
(1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة)
سطر 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> ===
القيمة الافتراضيّة لمتغيّر البيئة في حال عدم وجوده.


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

المراجعة الحالية بتاريخ 16:17، 6 أغسطس 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'

مصادر