الفرق بين المراجعتين لصفحة: «Python/os/getenv»
احمد-نورالله (نقاش | مساهمات) ط تصحيح التصنيف |
احمد-نورالله (نقاش | مساهمات) ط ترتيب التصنيفات |
||
| (4 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 5: | سطر 5: | ||
<syntaxhighlight lang="python3"> | <syntaxhighlight lang="python3"> | ||
getenv(key, default=None) | getenv(key, default=None) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== المعاملات == | |||
=== <code>key</code> === | |||
مُتغيّر البيئة المُراد الحصول على قيمته. | |||
=== <code>default</code> === | |||
القيمة الافتراضيّة لمتغيّر البيئة في حال عدم وجوده. | |||
== القيمة المعادة == | == القيمة المعادة == | ||
تُعيد الدالة قيمة مُتغيّر البيئة المُمرَّر (<code>key</code>)، أو قيمة الوسيط <code>default</code> في حال عدم وجود المتغيّر. ينبغي أن تكون الوسائط والقيمة المعادة [[Python/ | تُعيد الدالة قيمة مُتغيّر البيئة المُمرَّر (<code>key</code>)، أو قيمة الوسيط <code>default</code> في حال عدم وجود المتغيّر. ينبغي أن تكون الوسائط والقيمة المعادة [[Python/str|سلاسل نصيّة]]. | ||
تُرمَّز المفاتيح (الوسيط <code>key</code>) والقيم (قيمة المتغيّر)، في أنظمة يونكس، بنظام الترميز المُعاد من الدالة [[Python/sys/getfilesystemencoding|()sys.getfilesystemencoding]]. استخدم الدالة [[Python/os/getenvb|()os.getenvb]] في حال كنت تريد استخدام نظام ترميز مُختلف. | تُرمَّز المفاتيح (الوسيط <code>key</code>) والقيم (قيمة المتغيّر)، في أنظمة يونكس، بنظام الترميز المُعاد من الدالة [[Python/sys/getfilesystemencoding|()sys.getfilesystemencoding]]. استخدم الدالة [[Python/os/getenvb|()os.getenvb]] في حال كنت تريد استخدام نظام ترميز مُختلف. | ||
| سطر 15: | سطر 23: | ||
== أمثلة == | == أمثلة == | ||
<syntaxhighlight lang="python3"> | يُظهِر المُقتطَف البرمجي أدناه مثال عن محاولة الحصول على قيمة مُتغيّر البيئة <code>TEST</code> الغير موجود في النظام، مما سيؤدي إلى إعادة قيمة الوسيط <code>default</code> بدلًا من ذلك.<syntaxhighlight lang="python3"> | ||
>>> from os import getenv | >>> from os import getenv | ||
>>> getenv(key="TEST", default="TEST") | >>> getenv(key="TEST", default="TEST") | ||
| سطر 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 | [[تصنيف:Python Function]] | ||
[[تصنيف:Python os]] | [[تصنيف:Python os]] | ||
المراجعة الحالية بتاريخ 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'