الفرق بين المراجعتين ل"Python/help"
< Python
اذهب إلى التنقل
اذهب إلى البحث
(إضافة الصّفحة) |
|||
| سطر 25: | سطر 25: | ||
>>> help('json') # عرض صفحة مساعدة حول وحدةٍ قياسيّة | >>> help('json') # عرض صفحة مساعدة حول وحدةٍ قياسيّة | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | المثال الأخير له نفس تأثير كتابة json داخل المُساعد التّفاعليّ. | + | المثال الأخير له نفس تأثير كتابة <code>[[Python/json|json]]</code> داخل المُساعد التّفاعليّ. |
== ملاحظات == | == ملاحظات == | ||
| − | أضيفت الدّالة إلى مجال الأسماء المُضمّن (built-in namespace) عبر الوحدة site. | + | أضيفت الدّالة إلى مجال الأسماء المُضمّن (built-in namespace) عبر الوحدة <code>[[Python/site|site]]</code>. |
== انظر أيضًا == | == انظر أيضًا == | ||
مراجعة 20:54، 3 مايو 2018
تُطلق الدّالة help() نظام المُساعدة المُضمّن (الذي يُستعمل في الوضع التّفاعلي للحصول على معلومات حول الكائنات والوحدات المبنيّة).
البنية العامة
help([object])
المعاملات
object
مُعامل اختياريّ. الكائن المراد الحصول على مُساعدة حوله.
القيمة المعادة
إن لم تُمرّر مُعاملات للدّالة، فسيُطلَق نظام المُساعدة التّفاعلي على المُفسّر. إن كان المُعامل سلسلة نصيّة، فسيُبحث عن القيمة على أنّها اسم وحدة، أو دالّة، أو صنف، أو كلمة مفتاحيّة، أو موضوع توثيق، وستُطبع صفحة مُساعدة (باللغة الانجليزيّة) على الشّاشة. إن كان المُعامل أي نوع آخر من الكائنات، فستُولّد صفحة مُساعدة للكائن وستُعرض على الشّاشة.
أمثلة
المثال التّالي يوضّح كيفيّة عمل هذه الدّالة:
>>> help() # الوصول إلى صفحة المُساعدة التّفاعليّة
>>> help(int) # صفحة مُساعدة حول صنف الأعداد الصّحيحة
>>> help(str) # صفحة مُساعدة حول صنف السّلاسل النّصيّة
>>> help('json') # عرض صفحة مساعدة حول وحدةٍ قياسيّة
المثال الأخير له نفس تأثير كتابة json داخل المُساعد التّفاعليّ.
ملاحظات
أضيفت الدّالة إلى مجال الأسماء المُضمّن (built-in namespace) عبر الوحدة site.