نتائج البحث

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

تعيد الدّالة getattr()‎ قيمة الخاصيّة المُعطاة من الكائن المُعطى. البنية العامة getattr(object, name[, default]) المعاملات object الكائن المراد الحصول على قيمة خاصيّته. name سلسلة نصيّة تُمثّل اسم الخاصيّة المرغوب الوصول إلى قيمتها. default مُعامل اختياريّ. القيمة الافتراضيّة التي ستُعاد إن لم تكن الخاصيّة موجودة. القيمة المعادة قيمة الخاصيّة ذات الاسم الذي يوافق المُعامل name. إن لم تكن الخاصيّة موجودة فستُعاد قيمة المُعامل default إن توفّر، أو سيُطلَق خطأ AttributeError إن لم تتوفّر قيمة للمُعامل. أمثلة المثال التّالي يوضّح كيفيّة عمل ...

البايتات هي تسلسلات لبايتات مفردة غير قابلة للتغيير (immutable)، وهي مشابهة إلى حدّ كبير للسلاسل النصية. توفّر هذه الكائنات توابع تكون صالحة للاستخدام مع البيانات ذات الترميز ASCII نظرًا لأنّ الكثير من البروتوكولات الثنائية الرئيسية مستندة إلى هذا الترميز. تعريف البايتات صيغة تعريف البايتات مماثلة لصيغة تعريف السلاسل النصية، باستثناء إضافة السابقة b إلى عبارة التعريف وكما يلي: b'still allows embedded "double" quotes' # علامات اقتباس مفردة b"still allows embedded 'single' quotes". ...

تعيد الدّالة callable()‎ قيمة منطقيّة تُشير إلى ما إذا كان الكائن المُعطى قابلًا للاستدعاء أم لا. البنية العامة callable(object) المعاملات object الكائن المرغوب التّحقق من قابليّة استدعائه. القيمة المعادة القيمة True إن كان الكائن قابلًا للاستدعاء، والقيمة False إن كان الكائن غير قابل للاستدعاء. أمثلة المثال التّالي يوضّح طريقة عمل الدّالة: >>> callable(len) # هنا الكائن دالّةٌ مُضمّنة True >>> x = 1 >>> callable(x) # المتغيّرات التي تحمل قيما عاديّة لا تكون قابلة للاستدعاء False >>> def test(): ... pass ... >>> ...

تعيد الدّالة issubclass()‎ قيمة منطقيّةً تُشير إلى ما إذا كان الصّنف المُعطى صنفًا فرعيًّا لصنف آخر أم لا. البنية العامة issubclass(class, classinfo) المعاملات class الصّنف المرغوب التّحقّق من كونه فرعًا من الصّنف classinfo . classinfo الصّنف أو النّوع المرغوب التّحقق من أنّ الصّنف class فرعٌ منه. يُمكن كذلك أن يكون صفًّا من الأصناف أو الأنواع للتحقّق من أنّ الكائن فرعٌ من أحدها. القيمة المعادة القيمة True إن كان الصّنفُ class صنفًا فرعيًّا من الصّنف classinfo (سواء كان مُباشرًا، غير مباشر، ...

تعيد الدّالة range()‎ كائن مجال يحتوي على أعداد صحيحة من نقطة البداية إلى نقطة النّهاية مع فصلها بمسافة عدديّة. البنية العامة range(stop) range(start, stop[, step]) المعاملات start نقطة بداية المجال. stop نقطة نهاية المجال. step المسافة العدديّة التي ستكون بين عناصر المجال. القيمة المعادة كائن مجال يُعدّ نوعًا من أنواع التّسلسلات غير القابلة للتّغيير (immutable sequence type). أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> list(range(3)) # من صفر إلى ثلاثة [0, 1, 2] >>> list(range(1, 5)) # من 1 إلى 5 [1, ...

تُحوّل الدّالة oct()‎ عددًا صحيحًا إلى سلسلة نصيّة ثُمانيّة (octal string) مسبوقة بالسّابقة 0o والنّتيجة تكون تعبير بايثون صحيحًا. البنية العامة oct(x) المعاملات x عدد صحيح، أو أيّ كائن يُعرّف التّابع الخاصّ ‎_‎_‎‎index‎_‎_‎(‎)‎ يُعيد عددا صحيحًا. القيمة المعادة سلسلة نصيّة ثُمانيّة تُمثّل العدد الصّحيح المُعطى. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> oct(8) '0o10' >>> oct(-56) '-0o70' إن أردت تحويل عدد صحيح إلى سلسلة نصيّة ثمانيّة إمّا دون السّابقة 0o أو معها، فيمكنك استخدام إحدى الطرائق الآتيّة: >>> '%#o' % 10, ...

الدوال من المرتبة الأعلى (Higher-Order Functions) وهي الدوال التي تقبل دوالًا أخرى كمعاملاتٍ (parameters) لها، أو تلك التي تُعيد (return) دوالًا أخرى كنتيجة لها، وكمثالٍ عنها لنأخذ الدالة lock()‎، وهي الدالة التي تقبل كائنًا lock ودالةً أخرى، حيث ستحصلُ الدالة على الكائن lock وتُنفِّذُ الدالةَ الوسيطةَ ثم تُحرِّر القفل في النهاية، كما في الشيفرة: fun <T> lock(lock: Lock, body: () -> T): T { lock.lock() try { ...

تعيد الدّالة repr()‎ سلسلة نصيّة تحتوي على تمثيل قابل للطّباعة للكائن المُعطى. البنية العامة repr(object) المعاملات object الكائن المرغوب الحصول على تمثيله. القيمة المعادة في الكثير من الحالات، تُحاول الدّالة إعادة سلسلة نصيّة تُعيد كائنًا بنفس القيمة عند تمريره إلى الدّالة eval()‎، وفي غير ذلك من حالات، يكون التّمثيل سلسلةً نصيّة، ويكون مُضمّنًا داخل قوسي <>‎ يحتوي على اسم نوع الكائن إضافةً إلى معلومات أخرى، وعادةً ما تكون هذه المعلومات اسم الكائن وعنوانه في الذّاكرة. يُمكن لصنفٍ أن يتحكّم فيما ...

تعيد الدّالة hash()‎ قيمة تجزئة (hash) الكائن المُعطى (إن امتلك الكائن تجزئةً معروفة). البنية العامة hash(object) المعاملات object الكائن المُراد الحصول على تجزئته. القيمة المعادة عدد صحيح يُمثّل قيمة تجزئة الكائن. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> hash(1) 1 >>> hash(1.0) 1 >>> hash('x') # تجزئة محرف واحد مباشرةً 5693259701801553312 >>> a = 'x' >>> hash(a) # تجزئة المحرف نفسه بعد تخزينه في مُتغيّر 5693259701801553312 ملاحظات تُستخدم التّجزئات لمُقارنة مفاتيح القواميس بسرعة أثناء بحث في القاموس. تملك القيم العدديّة التي تُساوي بعضها البعض نفس قيمة ...

تعيد الدّالة tuple()‎ صفًّا يُولَّد من الكائن القابل للتّكرار المُعطى. البنية العامة tuple([iterable]) المعاملات iterable مُعامل اختياريّ، الكائن القابل للتّكرار (كالقوائم، والمجموعات، والسّلاسل النّصيّة وغيرها) المُراد تحويله إلى صفّ. القيمة المعادة صفّ جديد فارغ (إن لم تُمرّر للدّالة أيّة مُعاملات) أو صفّ تكون عناصره هي عناصر الكائن القابل للتّكرار iterable. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> tuple() # صفّ فارغ () >>> tuple('123') # صفّ من سلسلة نصيّة ('1', '2', '3') >>> tuple([1, 2, 3]) # صفّ من قائمة (1, 2, 3) >>> ...

تُنشئ الدّالة setattr()‎ قيمة لخاصيّة كائن مُعيّن. البنية العامة setattr(object, name, value) المعاملات object الكائن المُراد تعديل خاصيّة من خاصيّاته أو إضافة خاصّية جديدة إليه إن لم تكن موجودة مُسبقًا. name سلسلة نصيّة تُمثّل اسم الخاصيّة، يُمكن أن تكون الخاصيّة موجودة مُسبقًا (ستُغيّر قيمتها) أو غير موجودة (ما يعني أنّها ستُنشأ). value القيمة المرغوب إسنادها للخاصيّة. القيمة المعادة القيمة None. ملاحظات يجب على الكائن أن يسمح بتعديل خاصيّاته. الاستدعاء ‎setattr‎(‎x,‎ ‎'foobar'‎, 123‎)‎ مُكافئ للجملة ‎x.‎‎foobar‎ ‎=‎‎ 123‎. أمثلة المثال التّالي ...

تعيد الدّالة ascii()‎ تمثيلًا (representation) نصيًّا لكائن مُعيّنٍ يُمكن طباعته كما الحال مع الدّالة repr()‎، لكن مع تهريب (escape) المحارف التي لا تُعدّ محارفَ ASCII في السلسلة النّصيّة المعادة باستعمال التّهريبات ‎\‎U‎ أو ‎\‎u‎‎ أو ‎\‎x. وتُعيد هذه الدّالة سلسلةً نصيّةً مُشابهةً لتلك التي كانت تُعيدها الدّالة repr()‎ في بايثون 2. البنية العامة ascii(object) المعاملات object الكائن المُراد الحصول على تمثيلٍ نصيّ له. القيمة المعادة سلسلة نصيّة تمثّل الكائن. انظر المثال H]khi. أمثلة يوضّح المثال التّالي الفرق بين كلّ من ...

تعيد الدّالة slice()‎ كائن slice يُمثّل مجموعة فهارس (indices) تُحدّد من طرف الاستدعاء ‎range‎(‎start‎,‎ stop‎, ‎step‎)‎‎. البنية العامة class slice(stop) class slice(start, stop[, step]) المعاملات start مُعامل اختياريّ قيمته الافتراضيّة هي None، يُمثّل بداية الفهارس. stop المُعامل المطلوب الوحيد، والذي يُمثّل نقطة توقّف الفهارس. step مُعامل اختياريّ قيمته الافتراضيّة هي None، يُمثّل الخطوة التي بين كل فهرس وآخر. القيمة المعادة كائن slice‎ يحتوي على خصائص start، وstop، وstep قابلة للقراءة فقط، والتي تُعيد قيمة المُعامل المُرتبط بها. الكائن المُعاد لا يمتلك ...

تعيد الدّالة vars()‎ قيمة الخاصيّة ‎_‎_‎dict‎_‎_‎ الخاصّة بوحدة، أو صنف، أو نُسخة، أو أيّ كائن يمتلك خاصيّةً باسم ‎_‎_‎dict‎_‎_‎. تملك الكائنات مثل الوحدات والنّسخ خاصيّة ‎_‎_‎dict‎_‎_‎ يُمكن تحديثها، لكنّ كائنات أخرى قد تفرض قيودًا على خاصيّة ‎_‎_‎dict‎_‎_‎ الخاصّة بها (فمثلا، يُمكن للأصناف استعمال النّوع ‎‎types‎.‎MappingProxyType‎ لمنع تحديث القاموس مُباشرةً). البنية العامة vars([object]) المعاملات object مُعامل اختياريّ يُمثّل الكائن المرغوب الحصول على قيمة الخاصيّة ‎_‎_‎dict‎_‎_‎ الخاصّة به. القيمة المعادة قيمة الخاصيّة ‎_‎_‎dict‎_‎_‎ الخاصّة بالكائن، وتُمثّل قيمته قاموسًا يحتوي على خاصيّات الكائن ...

تعيد الدّالة frozenset()‎ كائنًا جديدًا من النّوع frozenset‎ مع عناصر مأخوذة من الكائن القابل للتكرار الذي يُمرّر إليها اختياريًّا. انظر الصّنف frozenset‎ للمزيد من المعلومات حول كيفيّة استعماله. القيمة المُعادة تكون مجموعة جامدةً غير قابلة للتّغيير، أي عكس المجموعات في بايثون، فالمجموعات الجامدة لا تقبل تعديل مُحتوياتها إمّا إضافةً أو حذفًا أو غير ذلك. البنية العامة frozenset([iterable]) المعاملات iterable مُعامل اختياريّ. وهو كائن قابل للتّكرار لإنشاء مجموعة جامدة من عناصره. القيمة المعادة مجموعة جامدة تحتوي على العناصر الفريدة الموجودة في ...

تعيد الدّالة next()‎ القيمة التّالية من المُكرّر المٌعطى عبر استدعاء تابعه الخاصّ ‎_‎_‎next‎_‎_‎()‎. البنية العامة next(iterator[, default]) المعاملات iterator المُكرّر المرُاد الحصول على قيمته التّالية. default مُعامل اختياريّ. تُعاد قيمته عندما تنتهي قيم المُكرّر، وإن لم يُمرّر، فسيُطلَق استثناء StopIteration. القيمة المعادة القيمة التّاليّة للمُكرّر أو القيمة الافتراضيّة المُعطاة للمُعامل default عندما تنتهي قيم المُكرّر. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> name = 'Yousuf' >>> iterator = iter(name) >>> iterator <str_iterator object at 0x7f314d904fd0> >>> next(iterator) 'Y' >>> next(iterator) 'o' >>> next(iterator) 'u' >>> next(iterator) 's' >>> next(iterator) 'u' >>> next(iterator) 'f' >>> ...

تعيد الدّالة enumerate()‎ كائنًا قابلًا للتّكرار من النّوع enumerate. وتُستخدم لترقيم الكائنات القابلة للتّكرار. البنية العامة enumerate(iterable, start=0) المعاملات iterable كائن يدعم التّكرار (iteration)، مثل القوائم، والصّفوف والمولّدات والمكرّرات وغيرها. start العدد الذي سيبدأ منه التّرقيم، القيمة الافتراضيّة هي 0. القيمة المعادة كائن قابل للتّكرار من النّوع enumerate. يكون عبارة عن أزواج، الجزء الأول يكون رقم العنصر، والجزء الثّاني يكون العنصر نفسه. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> seasons = ['Spring', 'Summer', 'Fall', 'Winter'] # قائمة بايثون ...

تحذف الدّالة delattr()‎ الخاصيّة المُعطاة من الكائن (إن سمَح الكائن بحذف الخاصيّة). البنية العامة delattr(object, name) المعاملات object الكائن المرغوب حذف خاصيّةٍ من خاصيّاته. name سلسلة نصيّة تُمثّل اسم الخاصيّة المرغوب حذفها. القيمة المعادة القيمة None كبقيّة الدّوال التي لا تُعيد أي قيمة صراحةً في بايثون. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة، لاحظ أنّها مُشابهة للكلمة المفتاحيّة del التي تحذف الكائنات: >>> class A: ... def __init__(self, a=1, b=2): ... ...

تعيد الدّالة isinstance()‎ قيمة منطقيّةً تُشير إلى ما إذا كان الكائن المُعطى نسخة (instance) من الصّنف المُعطى أم لا. البنية العامة isinstance(object, classinfo) المعاملات object الكائن المرغوب التّحقّق من كونه نسخةً من الصّنف (أو النّوع) المُعطى. classinfo الصّنف أو النّوع المرغوب التّحقق من أنّ الكائن نسخة منه. يُمكن كذلك أن يقبل صفًّا (أو عدّة صفوف) من الأصناف أو الأنواع للتحقّق من أنّ الكائن نُسخة من أحدها. القيمة المعادة القيمة True إن كان الكائن نُسخة من الصّنف أو نسخة من أحد ...

تعيد الدّالة divmod()‎ زوجًا من الأعداد تُمثّل ناتج وباقي قسمة العددين عند استعمال قسمة الأعداد الصّحيحة. البنية العامة divmod(a, b) المعاملات a قيمة عددية تمثل المقسوم. b قيمة عددية تمثل المقسوم عليه. القيمة المعادة عند استعمال أنواع operand المختلطة (mixed operand types)، فستُطبّق قواعد عاملات حسابات الأنواع الثّنائيّة (binary arithmetic operators). للأعداد الصّحيحة، ستكون النّتيجة، مُساويّة للزّوج ‎(‎‎a ‎‎/‎/‎ ‎b‎, ‎a ‎% ‎b‎)‎. أمّا للأعداد العشريّة فستكون النّتيجة هي ‎(q‎, ‎a ‎% ‎b‎)‎ بحيث q يكون عادةً نتيجة العمليّة ...

تُحوّل الدّالة hex()‎ عددًا صحيحًا إلى سلسلة نصيّة ست عشريّة (hexadecimal string) مسبوقة بالمقطع 0x. البنية العامة hex(x) المعاملات x كائن من النّوع int. إن لم الكائن كذلك، فيجب على الكائن أن يُعرّف التّابع الخاصّ ‎_‎_‎index‎_‎_‎()‎ والذي عليه أن يُعيد عددًا صحيحًا. القيمة المعادة سلسلة نصيّة ستّ عشريّة مسبوقة بالسّابقة 0x وفي حالة أحرف صغيرة (lowercase). أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> hex(255) # عدد صحيح موجب '0xff' >>> hex(-42) # عدد صحيح سالب '-0x2a' إن أردت تحويل عدد صحيح ...

تعيد الدّالة any()‎ القيمة True إن كان أحد عناصر الكائن القابل للتكرار (iterable) المعطى يساوي القيمة True أو إن كان الكائن القابل للتكرار فارغًا. البنية العامة any() المعاملات iterable كائن قابل للتكرار، يُمكن أن يكون قائمةً أو مجموعةً أو سلسلةً نصيّة أو أيّ كائنٍ يُمكنك استخدام حلقة التّكرار for عليه للوصول إلى كلّ قيمةٍ من قيمه على حدى. القيمة المعادة القيمة True إن كان أحد عناصر الكائن القابل للتكرار المعطى يُساوي القيمة True أو إن كان الكائن القابل للتكرار فارغًا. ...

تعيد الدّالة all()‎ القيمة True إن كانت جميع عناصر الكائن القابل للتكرار (iterable) المعطى تُساوي القيمة True أو إن كان الكائن القابل للتكرار فارغًا. البنية العامة all() المعاملات iterable كائن قابل للتكرار، يُمكن أن يكون قائمةً أو مجموعةً أو سلسلةً نصيّة أو أيّ كائنٍ يُمكنك استخدام حلقة التّكرار for عليه للوصول إلى كلّ قيمةٍ من قيمه على حدى. القيمة المعادة القيمة True إن كانت جميع عناصر الكائن القابل للتكرار المعطى تُساوي القيمة True أو إن كان الكائن القابل للتكرار فارغًا. ...

تعيد الدّالة sum()‎ مجموع عناصر الكائن القابل للتكرار المُعطى إضافةً إلى قيمة بدئيّة إن مُرِّرَت. البنية العامة sum(iterable[, start]) المعاملات iterable الكائن القابل للتّكرار المرغوب جمع عناصره التي تكون عادةً قيمًا عدديّة. start مُعامل اختياريّ يُمثّل القيمة البدئيّة التي ستُضاف إلى المجموع في بدايته، قيمته الافتراضيّةُ 0، ولا يجوز أن تكون قيمته سلسلةً نصيّة. القيمة المعادة مجموع عناصر الكائن القابل للتّكرار إضافةً إلى القيمة البدئيّة. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> sum([1, 2, 3]) # مجموع قائمة ...

تُحوّل الدّالة format()‎ قيمةً مُعطاةً إلى تمثيل مُنسّق حسب ما تُحدّده مواصفة التّنسيق المُعطاة. البنية العامة format(value[, format_spec]) المعاملات value القيمة المرغوب تنسيقها. format_spec مُعامل اختياريّ تكون قيمته الافتراضيّة سلسلةً نصيّةً عادة ما تُعطي نفس تأثير الاستدعاء str‎(‎value‎)‎. القيمة المعادة القيمة المُنسّقة حسب المواصفة المُعطاة. تختلف آليّة تفسير المواصفة المُعطاة للمُعامل format_spec حسب نوع قيمة المُعامل value، لكنّ هناك بنية قياسيّة للتنسيق تُستخدم من طرف مُعظم الأنواع المُضمّنة في لغة بايثون. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة: >>> ...

تُحوّل الدّالة staticmethod()‎ تابعًا إلى تابعٍ ساكن (static method). البنية العامة staticmethod(fun) @staticmethod المعاملات fun الدّالة أو التّابع المُراد تحويله إلى تابعٍ ساكن. القيمة المعادة يُحوّل التّابع المُزخرَف إلى تابعٍ ساكن لا يستقبل مُعاملًا أولًا صريحًا (المُعامل المعروف بالاسم self في التّوابع). أمثلة المثال التّالي يوضّح كيفيّة إنشاء تابع ساكن باستعمال الدّالة staticmethod كمُزخرِف: >>> class A: ... @staticmethod ... def hello(): # لاحظ أنّ التّابع السّاكن لا يستقبل أيّ مُعامل تلقائيّ كما في التّوابع ...

تقدّم PHP الكثير من الدوال والبنى الأساسية والمضمّنة في اللغة. هناك أيضًا دوال تتطلب وجود إضافة خاصّة باللغة، وعدا ذلك سيظهر الخطأ "undefined function". فعلى سبيل المثال، يجب تجميع PHP مع دعم GD لاستخدام الدوال الخاصة بالتعامل مع الصور مثل imagecreatetruecolor()‎. ويجب تجميع اللغة مع دعم MySQL لاستخدام الدالة mysql_connect()‎‎. هناك العديد من الدوالّ الأساسية والمضمّنة في جميع إصدارات PHP، مثل دوال السلاسل النصية والمتغيرات. يمكن استدعاء الدالة phpinfo()‎ أو get_loaded_extensions()‎ لمعرفة الإضافات المُحمّلة مع اللغة. لاحظ أيضًا أن هناك ...

تقدّم PHP الكثير من الدوال والبنى الأساسية والمضمّنة في اللغة. هناك أيضًا دوال تتطلب وجود إضافة خاصّة باللغة، وعدا ذلك سيظهر الخطأ "undefined function". فعلى سبيل المثال، يجب تجميع PHP مع دعم GD لاستخدام الدوال الخاصة بالتعامل مع الصور مثل imagecreatetruecolor()‎. ويجب تجميع اللغة مع دعم MySQL لاستخدام الدالة mysql_connect()‎‎. هناك العديد من الدوالّ الأساسية والمضمّنة في جميع إصدارات PHP، مثل دوال السلاسل النصية والمتغيرات. يمكن استدعاء الدالة phpinfo()‎ أو get_loaded_extensions()‎ لمعرفة الإضافات المُحمّلة مع اللغة. لاحظ أيضًا أن هناك ...

مصفوفات البايتات bytearray هي الكائنات القابلة للتغيير والتي تقابل كائنات البايتات bytes. يُعيد الصّنف bytearray()‎ (والذي يُعامَل مُعاملة الدّالة) مصفوفة بايتات جديدة، ويكون الصّنف تسلسُلًا قابلًا للتّغيير يحتوي على الأعداد الصّحيحة ضمن المدى ‎0 <= x < 256. ويملك مُعظم التّوابع التي تملكها التّسلسلات الأخرى (كالقوائم والصّفوف مثلًا)، والمشروحة في صفحة أنواع التسلسلات القابلة للتّغيير، إضافةً إلى امتلاك مُعظم التّوابع التي يملكها النّوع bytes. البنية العامة bytearray([source[, encoding[, errors]]]) المعاملات source مُعامل اختياريّ يُستعمل لتهيئة المصفوفة عبر عدّة طُرق مختلفة: ...

الدّالة classmethod()‎ مُزخرفٌ يُحوّل تابعًا عاديًّا في صنف ما إلى تابع صنف (class method) ليُمكن الوصول إلى الصّنف الذي عُرّف فيه التّابع. يستقبل تابع الصّنفِ الصّنفَ كمُعاملٍ أول، تمامًا كما يستقبل التّابع العاديّ النّسخة (instance) كمُعامل أولٍ (أي الكائن الذي نُشير إليه عادةً بالاسم self). البنية العامة class C: @classmethod def f(cls, arg1, arg2, ...): ... المعاملات لا توجد مُعاملات. لكنّ الدّالة المُزخرَفَة f تستقبل المُعامل cls الذي يُشير إلى الصّنف الذي عُرّف عليه ...

تعيد الدّالة min()‎ أصغر عنصر من عناصر كائن قابل للتّكرار أو أصغر مُعامل من مُعاملين أو أكثر. البنية العامة min(iterable, *[, key, default]) # كائن قابل للتّكرار كمُعامل أوّل min(arg1, arg2, *args[, key]) # مُعاملات منفردة المعاملات iterable الكائن القابل للتّكرار المرغوب الحصول على أضغر عناصره. key مُعامل اختياريّ يُمرّر بكلمته المفتاحيّة (keyword-only argument) يُمثّل دالّة تقبل مُعاملًا واحدًا لتُستخدم في ترتيب العناصر المُعطاة مثل الدّالة ‎list‎.‎sort‎(‎)‎. default مُعامل اختياريّ يُمرّر بكلمته المفتاحيّة ويُمثّل القيمة التي ستُعاد افتراضيًّا إن كان الكائن ...

تعيد الدّالة round()‎ قيمة العدد المُعطى مُقرّبًا حسب عدد الأرقام كتقريب بعد الفاصلة. البنية العامة round(number[, ndigits]) المعاملات number العدد المُراد تقريبه. ndigits مُعامل اختياريّ يُمثّل عدد الأرقام بعد الفاصلة ويكون عددًا صحيحًا (سواء أكان سالبًا، أو موجبًا، أو صفرًا). إن لم تُمرّر له أيّة قيمة أو مُرّرت إليه القيمة None، فستُعيد الدّالة أقرب عدد صحيح للمُعامل number. القيمة المعادة عدد مُقرّب حسب المُعاملات المُعطاة. تُقرّب القيم إلى أقرب مُضاعف من مُضاعفات 10 مرفوعًا إلى قوّة ناقص العدد المُمرّر إلى ...

تعيد الدالة pow()‎ القيمة xy أي ترفع الأساس x إلى القوة y للقيمتين الممرَّرتين إليها، مع إمكانيّة الحصول على باقي القسمة عند تقسيم النّاتج على المُعامل z. البنية العامة pow(x, y[, z]) المعاملات x الأساس. y القوّة. z العدد الذي ستُقسم عليه النّتيجة لتُعيد الدّالة باقي القسمة. عند تمرير قيمة له، فالعمليّة تكون نسخةً تُحسبُ بطريقة أفضل من الجملة ‎pow‎(‎x‎,‎ ‎y‎)‎ ‎%‎ ‎z‎. القيمة المعادة تُعاد قيمة الأساس x مرفوعًا إلى القوّة y إن لم تُعط قيمة للمُعامل z ويكون ...

تعيد الدّالة max()‎ أكبر عنصر من عناصر كائن قابل للتّكرار أو أكبر مُعامل من مُعاملين أو أكثر. البنية العامة max(iterable, *[, key, default]) # كائن قابل للتّكرار كمُعامل أوّل max(arg1, arg2, *args[, key]) # مُعاملات منفردة المعاملات iterable الكائن القابل للتّكرار المرغوب الحصول على أكبر عناصره. key مُعامل اختياريّ يُمرّر بكلمته المفتاحيّة (keyword-only argument) يُمثّل دالّة تقبل مُعاملًا واحدًا لتُستخدم في ترتيب العناصر المُعطاة مثل الدّالة ‎list‎.‎sort‎(‎)‎. default مُعامل اختياريّ يُمرّر بكلمته المفتاحيّة ويُمثّل القيمة التي ستُعاد افتراضيًّا إن كان الكائن ...

تعيد الدّالة iter()‎ مُكرّرًا حسب المُعاملات المُعطاة. البنية العامة iter(object[, sentinel]) المعاملات object إن لم يكن المُعامل الثّاني sentinel حاضرًا، فلا بدّ لهذا المُعامل أن يكون كائنًا يدعم بروتوكول التّكرار (أي أنّ صنفه يُعرّف التّابع الخاصّ ‎_‎_‎iter‎_‎_‎(‎)‎)، أو يجب أن يدعم بروتوكول التّسلسلات (sequence protocol) الذي يُعرّف صنفه التّابع الخاصّ ‎_‎_‎getitem‎_‎_‎(‎)‎ مع مُعاملات تكون أعدادًا صحيحةً وتبدأ من الصّفر. وإن لم يدعم الكائن أيًّا من هذين البروتوكولين، فسيُطلق الاستثناء TypeError. sentinel مُعامل اختيّاريّ. إن مُرّرت قيمة لهذا المُعامل، فلا بدّ ...

تُستخدم الدّالة eval()‎ لتقدير (evaluate) تعبير بايثون. يُقدّر التّعبير المُعطى باستخدام مُعامل الكائنات العامّة globals والكائنات المحليّة locals. البنية العامة eval(expression, globals=None, locals=None) المعاملات expression سلسلة نصيّة تُمثّل تعبير بايثون المُراد تقديره أو كائن شيفرة كذلك الذي تُعيده الدّالة compile()‎. globals مُعامل اختياريّ. قاموس يُمثّل الكائنات العامّة التي ستُمرّر إلى التّعبير. إن مُرّر هذا المُعامل دون الكائن ‎_‎_‎builtins‎_‎_‎، فستُنسَخ الكائنات العامّة الحاليّة وتُمرّر إلى المُعامل قبل مُعالجة التّعبير. ما يعني أنّ التّعبير يحصل طبيعيًّا على كامل حقوق الوصول إلى الوحدة ...

تطبع الدّالة print()‎ الكائنات المُعطاة. تُفصَل القيم المطبوعة بقيمة المُعامل sep وتُتبع بقيمة المُعامل end. البنية العامة print(*objects, sep=' ', end='\n', file=sys.stdout, flush=False) المعاملات objects مُعامل اختياريّ يُمثّل الكائنات التّي ستُطبع. تُحوّل الكائنات إلى سلاسل نصيّة كما تفعل الدّالة ‎str‎(‎)‎ قبل كتابتها إلى التّيار file مفصولة بالفاصل sep ومتبوعة باللاحقة end. sep مُعامل كلمة مفتاحيّة (يجب عليك تمرير اسم المُعامل مع قيمته). وهو مُعامل اختياريّ. السّلسلةَ النّصيّة التّي ستَفصِل بين كلّ كائن من الكائنات التي ستُطبع. القيمة الافتراضيّة هي مسافة ...

تعيد الدّالة sorted()‎ قائمةً مُرتّبةً من عناصر الكائن القابل للتّكرار المُعطى. البنية العامة sorted(iterable, *, key=None, reverse=False) المعاملات iterable الكائن القابل للتّكرار المُراد ترتيبُ عناصره. key مُعامل اختياريّ ومُعامل كلمة مفتاحيّة (keyword argument) يُحدّد دالّة تقبل مُعاملا واحدًا تُستعمل لأخذ مفتاح ترتيب من كلّ عنصر من عناصر القائمة، يُمكنك استعمال الدّالة ‎str‎.‎lower‎ كمفتاح مثلًا لترتيب الأحرف حسب صيغتها الصّغيرة (lowercase). القيمة الافتراضيّة هي القيمة None والتي تعني بأنّ المُقارنة ستُجرى على العناصر مُباشرةً. reverse مُعامل اختياريّ ومُعامل كلمة مفتاحيّة يكون ...

تُستعمَل الدّالة exec()‎ لتنفيذ شيفرة بايثون ديناميكيًّا. البنية العامة exec(object[, globals[, locals]]) المعاملات object سلسلة نصيّة تُمثّل شيفرة بايثون المُراد تنفيذها أو كائن شيفرة كذلك الذي تُعيده الدّالة compile()‎. إن كان سلسلةً نصيّة، فستُعالج على أنّها جمل بايثون عاديّة وستُنفّذ (إلّا في حالة حدث خطأ في بنية الشّيفرة). إن كان كائنَ شيفرة، فسيُنفّذ فقط. وعلى أية حال، يجب على الشّيفرة المرغوب تنفيذها أن تكون شيفرة بايثون صالحة. وانتبه إلى أنّه لا يجوز استخدام الجملتين return و yield خارج تعريفات الدّوال ...

تسترِد الدّالة ‎__‎‎import‎‎_‎_‎()‎‎ الوحدة المُعطاة. ملاحظة: هذه الدّالة مُتقدّمة غير مطلوبة في برمجة بايثون الاعتياديّة، على عكس الدّالة importlib.import_module. تستدعي الجملة import‎ الدّالةَ ‎__import__()‎ ويُمكن استبدالها عبر استيراد builtins وتعيين دالّة جديدة للخاصيّة ‎builtins‎.‎_‎_‎import‎_‎_‎‎ إن أردت تغيير كيفيّة تصرّف الجملة import‎، لكنّ هذا الأمر غير منصوح به بشدّة إذ عادةً ما تكون خُطّافات الاستيراد (انظر PEP 302) وسيلةً أكثر بساطة للوصول إلى نفس الغاية ولا تُسبّب مشاكل مع الشّيفرة التي تعتمد على كون آليّة الاستيراد طبيعيّة دون تغيّر. واستعمال الدّالة ...

تسترِد الدّالة ‎__‎‎import‎‎_‎_‎()‎‎ الوحدة المُعطاة. ملاحظة: هذه الدّالة مُتقدّمة غير مطلوبة في برمجة بايثون الاعتياديّة، على عكس الدّالة importlib.import_module. تستدعي الجملة import‎ الدّالةَ ‎__import__()‎ ويُمكن استبدالها عبر استيراد builtins وتعيين دالّة جديدة للخاصيّة ‎builtins‎.‎_‎_‎import‎_‎_‎‎ إن أردت تغيير كيفيّة تصرّف الجملة import‎، لكنّ هذا الأمر غير منصوح به بشدّة إذ عادةً ما تكون خُطّافات الاستيراد (انظر PEP 302) وسيلةً أكثر بساطة للوصول إلى نفس الغاية ولا تُسبّب مشاكل مع الشّيفرة التي تعتمد على كون آليّة الاستيراد طبيعيّة دون تغيّر. واستعمال الدّالة ...

تعيد الدّالة property()‎ خاصيّةً يُمكن التّحكم في تابع الحصول على قيمتها، وتابع تعيين قيمة لها، وتابع حذف قيمتها، وسلسلة التّوثيق (docstring) الخاصّة بها. ويُمكن كذلك استخدامها كمُزخرف لتحويل تابع إلى خاصيّة. البنية العامة property(fget=None, fset=None, fdel=None, doc=None) المعاملات fget الدالّة التّي ستُستخدم للحصول على قيمة الخاصيّة. fset الدالّة التّي ستُستخدم لتعيين قيمة للخاصيّة. fdel الدالّة التّي ستُستخدم لحذف قيمة الخاصيّة. doc سلسلة توثيق الخاصيّة. القيمة المعادة كائن خاصيّة (property object). الكائن المُعاد يحتوي على الخاصيّات fget، وfset، وfdel التي تُمثّل ...

تعيد الدّالة type()‎ نوع الكائن المُعطى إن مُرّر مُعامل واحد لها. وتعيد كائن نوعٍ (type object) جديد إن مُرّرت لها ثلاثة مُعاملات. البنية العامة type(object) type(name, bases, dict) المعاملات تقبل الدّالة type()‎ إمّا مُعاملًا واحدًا فقط، أو ثلاثة مُعاملات كما هو واضح في البنية العامّة أعلاه. عند استدعائها بمُعامل واحد فقط، ستُعيد الدّالة نوع الكائن المُمرّر. أمّا عند الاستدعاء بثلاثة مُعاملات، فسيُعاد كائن نوعٍ جديد. وهو طريقة ديناميكيّة لإنشاء الأصناف كبديل للجملة class. object عند استدعائها بمُعامل واحد فقط، يُمثّل هذا ...

تعيد الدّالة zip()‎ مُكرّرًا يُركّب عناصر كلّ من الكائنات القابلة للتّكرار المُعطاة. البنية العامة zip(*iterables) المعاملات iterables مُعامل اختياريّ يُمثّل الكائنات القابلة للتّكرار المرغوب تركيبها. القيمة المعادة مُكرّر يحتوي على صفوف تكون عناصرها ذات نفس الفهرس (index) في كلّ عنصر من عناصر الكائنات القابلة للتّكرار. إذ يحتوي مثلا أول صفّ على جميع العناصر التي تكون أول العناصر في الكائنات القابلة للتّكرار المُعطاة (انظر الأمثلة أدناه). يتوقّف المُكرّر عندما تنتهي عناصر أصغر كائن قابل للتّكرار. عند استدعائها بكائن واحد قابل للتّكرار ...

‎.fadeTo( duration, opacity [, complete ] )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. الوصف يضبط هذا التابع درجة عتامة العناصر المطابقة. ‎.fadeTo( duration, opacity [, complete ] )‎ أُضيف مع الإصدار: 1.0. duration مدة الحركة وهو من النوع عدد Number أو سلسلة نصية String. opacity رقم من النوع Number يتراوح ما بين 0 و 1 ويشير إلى درجة العتامة المستهدفة. complete دالة على الشكل Function()‎‎، تُستدعى بمجرد اكتمال الحركة. ‎.fadeTo( duration, opacity [, easing ] [, complete ] )‎ ...

تُجمّع الدّالة compile()‎ شيفرة بايثون مصدريّةً إلى شيفرة أو كائن AST. يُمكن تنفيذ هذه الكائنات عبر استخدام الدّالة exec()‎ أو الدّالة eval()‎. البنية العامة compile(source, filename, mode, flags=0, dont_inherit=False, optimize=-1) المعاملات source الشيفرة المصدريّة المرغوب تجميعها، يُمكن أن تكون قيمة المُعامل سلسلةً نصيّة، أو سلسلة بايتات نصيّة (byte string) أو كانًا من النّوع AST. انظر توثيق الوحدة ast للمزيد من المعلومات حول كائنات AST. filename اسم الملفّ الذي قُرِئَت منه الشيفرة. مرّر قيمةً مفهومةً إن لم تكن الشّيفرة قد قرئَت ...

تمتلك بايثون عددًا من أنواع البيانات المركبة والتي تستخدم لتجميع القيم الأخرى مع بعضها البعض، والقوائم هي أوسع هذه الأنواع وأكثرها شمولًا، ويمكن كتابتها كقائمة من القيم (العناصر) المفصولة عن بعضها البعض بفواصل (،) ومحاطة بأقواس مربعة. يمكن للقوائم أن تتضمّن أنواعًا مختلفة، ولكن عادة ما تكون العناصر كلها من النوع نفسه. >>> squares = [1, 4, 9, 16, 25] >>> squares [1, 4, 9, 16, 25] فهرسة القوائم واقتطاع أجزاء منها كما هو الحال مع السلاسل النصية (والأنواع الأخرى من التسلسلات ...

تستخدم الدالة الداخلية dir()‎ لمعرفة الأسماء التي تعرّفها الوحدة، وتعيد هذه الدالة قائمة مرتّبة من السلاسل النصية: >>> import fibo, sys >>> dir(fibo) ['__name__', 'fib', 'fib2'] >>> dir(sys) ['__displayhook__', '__doc__', '__excepthook__', '__loader__', '__name__', '__package__', '__stderr__', '__stdin__', '__stdout__', '_clear_type_cache', '_current_frames', '_debugmallocstats', '_getframe', '_home', '_mercurial', '_xoptions', 'abiflags', 'api_version', 'argv', 'base_exec_prefix', 'base_prefix', 'builtin_module_names', 'byteorder', 'call_tracing', 'callstats', 'copyright', 'displayhook', 'dont_write_bytecode', 'exc_info', 'excepthook', 'exec_prefix', 'executable', 'exit', 'flags', 'float_info', 'float_repr_style', 'getcheckinterval', 'getdefaultencoding', 'getdlopenflags', 'getfilesystemencoding', 'getobjects', 'getprofile', 'getrecursionlimit', 'getrefcount', 'getsizeof', 'getswitchinterval', 'gettotalrefcount', 'gettrace', 'hash_info', 'hexversion', 'implementation', 'int_info', 'intern', 'maxsize', ...

تعيد الدّالة super()‎ كائنًا وسيطًا يُفوّض استدعاءات التّوابع إلى صنف أبٍ أو صنف شقيق للصّنف الذي استُدعيَت منه الدّالة. هذا مُفيد للوصول إلى التّوابع الموروثة التي أعيدت كتابتها في صنف مُعيّن. ترتيب البحث يكون هو نفسه التّرتيب المُستخدم من طرف الدّالة getattr()‎ لكنّ النّوع type‎ المُعطى يُتجاهَل. البنية العامة super([type[, object-or-type]]) المعاملات type النّوع الذي ستقوم الدّالة super()‎ بتفويض استدعاءات التّوابع إلى صنف أبٍ أو صنف شقيق له. تعرض الخاصيّة __mro__ الخاصّة بالصّنف type ترتيب البحث عن التوابع (method resolution ...