نتائج البحث

تُستخدم الدّالة input()‎ للحصول على مُدخلات من المُستخدم. البنية العامة input([prompt]) المعاملات prompt مُعامل اختياريّ. الرّسالة التي ستظهر للمُستخدم كسابقة للمحثّ (prompt، عادة ما تكون سؤالًا يطلب من المُستخدم توفير معلومات مُعيّنة). وستظهر دون سطر جديد لاحق. القيمة المعادة القيمة التي أدخلها المُستخدم مُحوَّلة إلى سلسلة نصيّة (مع حذف سطرٍ جديدٍ لاحق). عندما تُقرأ نهاية الملفّ (EOF) فسيُطلق الاستثناء EOFError. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> def hello(): ... name = input("what's your name? ...

تُحدّث الدّالة locals()‎ قاموسًا يُمثّل جدول الرموز المحليّ (local symbol table) وتُعيده. البنية العامة locals() المعاملات لا توجد مُعاملات. القيمة المعادة قاموس يُمثّل المتغيّرات المحليّة. ملاحظات تُعاد المُتغيّرات الحرّة (free variables) من طرف الدّالة عند استدعائها داخل الدّوال وليس داخل الأصناف. لا يجب تعديل مُحتويات القاموس المُعاد، إذ أنّ التّعديلات قد لا تُؤثّر على المتغيّرات المحليّة والحرّة المُستخدمة من طرف المُفسّر. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> y = 1 # هذا المتغيّر لن يكون محليّا نسبة ...

تعيد الدّالة reversed()‎ مُكرّرًا معكوسًا يحتوي على كائن التّسلسل (sequence) المُعطى بالتّرتيب المُعاكس. البنية العامة reversed(seq) المعاملات seq تسلسل القيم المرغوب الحصول على مُكرّر مُعاكس لها. يجب أن تكون قيمة المُعامل كائنًا يمتلك صنفه التّابع الخاصّ ‎_‎_‎reversed‎_‎_‎(‎)‎ أو أن يدعم بروتوكول التّسلسل (أي أن يحتوي صنفه على التّابع ‎_‎_‎len‎_‎_‎(‎)‎ والتّابع ‎_‎_‎getitem‎_‎_‎(‎)‎ مع مُعاملات أعداد صحيحة تبدأ من الصّفر). القيمة المعادة مُكرّر تكون عناصره نتيجة عكس ترتيب العناصر المُعطاة. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة، لاحظ أنّنا نُحوّل المُكرّر ...

تُحوّل الدّالة bin()‎ عددًا صحيحًا (integer number) إلى سلسلةٍ نصيّةٍ ثنائيّة (binary string) مسبوقة بالمقطع النّصيّ "0b". البنية العامة bin(x) المعاملات x عدد صحيح، إن لم يكن كائنًا من النّوع int، فيجب على الكائن أن يحتوي على التّابع الخاصّ ‎_‎_index‎_‎_()‎ الذي يجب عليه أن يُعيد عددًا صحيحًا. القيمة المعادة سلسلة نصيّة ثنائيّة مسبوقة بالمقطع النّصيّ "0b". أمثلة تُوضّح الأمثلة التّالية كيفيّة عمل هذه الدّالة: >>> bin(3) '0b11' >>> bin(-10) '-0b1010' ملاحظات إن لم ترغب بالحصول على السّابقة "0b"، يُمكنك استعمال أحد الطرائق التّاليّة: ...

تعيد الدّالة chr()‎ المحرف الذي يُوافق رمز يونيكود حسب العدد الصّحيح المُعطى. وللقيام بالعكس (أي الحصول على رقم المحرف) فانظر إلى توثيق الدّالة ord()‎. البنية العامة chr(i) المعاملات i العدد الصّحيح الذي ترغب بالحصول على محرف يونيكود الذي يُوافقه. يجب على قيمته أن تكون من 0 إلى 1,114,111 (أي 0x10FFFF في النظام الست عشري). إن كان العدد المُعطى خارج هذا المجال، فسيحدث استثناء ValueError. القيمة المعادة سلسلة نصيّة تحتوي على المحرف الذي يوافق العدد الصّحيح المُعطى في ترميز يونيكود. أمثلة ...

يُعيد الصّنف bool()‎ قيمةً منطقيّةً تكون إمّا True أو False. ويُعَامَل مُعاملة دالةٍ مُضمنّة في بايثون. البنية العامة bool([x]) المعاملات x مُعامل اختياريّ يُحوَّل إلى قيمة منطقيّة باستعمال طريقة اختبار الصّحّة الاعتياديّة. القيمة المعادة إن كان المُعامل المُمرّر يحمل قيمة منطقيّة خطأ (false) أو لم يُمرّر أي مُعامل إلى الصّنف، فالقيمة المُعادة ستكون False، وتُعاد القيمة True في غير ذلك من حالات. أمثلة المثال التّالي يُوضّح كيفيّة عمل هذا الصّنف. لاحظ أنّه يُستدعى كما تُستدعى الدّوال في بايثون: >>> bool(1) True >>> ...

تحذف الدالة وتعيد أصغر عنصر في الكومة مع الحفاظ على ثبات الكومة. البنية العامة heapq.heappop(heap) المعاملات heap اسم الكومة التي سيُحذف أصغر عنصر منها. القيمة المعادة تحذف الدالة وتعيد أصغر عنصر في الكومة heap، مع الحفاظ على ثبات الكومة. إن كانت الكومة فارغة، تطلق الدالة الخطأ IndexError. للوصول إلى أصغر عنصر دون حذفه، يمكن استخدام heap[0]‎. أمثلة يبين المثال التالي آلية عمل التابع: >>> import heapq >>> li = [5, 7, 9, 1, 3] >>> heapq.heapify(li) >>> print(list(li)) [1, 3, 9, 7, 5] >>> heapq.heappop(li) 1 >>> ...

تعيد الدّالة globals()‎ قاموسًا يحتوي على الكائنات العامّة الحاليّة. البنية العامة globals() المعاملات لا توجد مُعاملات لهذه الدالة. القيمة المعادة قاموس يُمثّل جدول الرّموز العامّ (global symbol table) ويكون دائمًا قاموسَ الوحدة الحاليّة، وفي داخل دالّة أو تابع، فإنّ القاموس يُمثّل الكائنات العامّة في الوحدة التي عُرّفت فيها الدّالة أو التّابع وليس الوحدة التي استُدعيَت منها. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة، لاحظ أنّ المُتغيّر x الذي نُعرّفه داخل الدّالة hello‎‎(‎)‎ لا يظهر في القاموس لأنّه كائن محليّ ...

تعيد الدّالة hasattr()‎ قيمةً منطقيّةً تُحدّد ما إذا كانت الخاصيّةُ المُعطى اسمُها موجودةً في الكائن المُعطى أم لا. البنية العامة hasattr(object, name) المعاملات object الكائن المُراد التّحقق من وجود الخاصيّة فيه. name سلسلة نصيّة تُمثّل اسم الخاصيّة المرغوب التّحقق من وجودها في الكائن. القيمة المعادة القيمة True إن كانت الخاصيّة موجودة. والقيمة False إن لم تكن كذلك. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> class A: ... x = 1 ... >>> hasattr(A, 'x') # الخاصيّة ...

تأخذ الدالة صفًّا من الأوقات كالذي تعيده الدالة gmtime()‎ في وحدة time، وتعيد قيمة الختم الزمني المقابل في نظام يونكس البنية العامة calendar.timegm(tuple) المعاملات تأخذ الدالة صفًّا يتضمّن القيم (ثانية، دقيقة، ساعة، يوم، شهر، سنة) وتحوّله إلى الختم الزمني المقابل في نظام يونكس. القيمة المعادة تأخذ الدالة صفًّا من الأوقات كالذي تعيده الدالة gmtime()‎‎ في وحدة time، وتعيد قيمة الختم الزمني المقابل في نظام يونكس ويبدأ حساب السنين من سنة 1970، وباستخدام الترميز POSIX. وفي الواقع تعكس كل من الدالتين ...