نتائج البحث

تقدّم هذه الوحدة عددًا من الدوال المساعدة لإنشاء أنواع بيانات جديدة بصورة ديناميكية، إضافة إلى أنّها تعرّف أسماءً لبعض أنواع الكائنات التي يستخدمها مفسّر بايثون المعياري، ولكنّها ليست كائنات داخلية مثل int أو str، إلى جانب أنّ هذه الوحدة تقدم بعض الأصناف والدوال المساعدة الخاصة ببعض الأنواع، والتي لا تعدّ أساسية بما يكفي لتصبح أصنافًا ودوالّ داخلية. إنشاء الأنواع ديناميكيًا تقدّم هذه الوحدة ثلاث دوالّ تساعد في إنشاء أنواع البيانات ديناميكيًا: الدالة types.new_class()‎‎ تنشئ هذه الدالة ديناميكيًا كائن صنف باستخدام ...

تعيد الدّالة itertools.starmap()‎ مُكرّرًا يستدعي الدّالة باستخدام المُعاملات المُعطاة في الكائن القابل للتّكرار. تُستعمل عوضًا عن الدالة map()‎ عندما تكون قيم المُعاملات مُجموعةً في صفّ في كائن واحد قابل للتّكرار (أي أنّ البيانات قد جُمِّعَت مُسبقًا). الفرق بين الدالة map()‎ والدّالة itertools.starmap()‎ يُوازي الفرق بين الاستدعاء function(a,b)‎‎ والاستدعاء function(*c)‎‎. البنية العامة itertools.starmap(function, iterable) المعاملات function الدّالة المُراد استدعاؤها. iterable كائن قابل للتّكرار يحتوي على صفوف لتُمرّر إلى الدّالة كمُعاملات مُفكّكة. القيمة المعادة مُكرّر يُعيد نتائج استدعاء الدّالة واحدة بواحدة. أمثلة ...

المجموعة (set) هي مجموعة من الكائنات غير المرتّبة وغير المكرّرة وغير القابلة للتعديل (immutable). تستخدم المجموعات عادة لاختبار وجود العناصر وللتخلص من المدخلات المكرّرة. تدعم كائنات المجموعات العمليات الرياضية مثل الاتحاد (union)، التقاطع (intersection)، الاختلاف (difference)، والاختلاف المتناظر (symmetric difference) (راجع عمليات المجموعات في بايثون). إنشاء مجموعة جديدة تستخدم الأقواس المعقوفة {} أو الدالة set()‎ لإنشاء مجموعة جديدة: >>> basket = {'apple', 'orange', 'apple', 'pear', 'orange', 'banana'} >>> print(basket)                      # تحذف ...

تصرّح الدالة عن وجوب استخدام الدالة المعطاة كدالة اختزال reduction function للكائنات من النوع المعطى. البنية العامة copyreg.pickle(type, function, constructor=None) ‎المعاملات type نوع الكائنات التي ستعمل دالة الاختزال عليها. function الدالة التي ستستخدم كدالة اختزال. يجب أن تعيد الدالة المعطاة سلسلة نصية أو صفًّا يتضمّن عنصرين أو ثلاثة. constructor يجب أن يكون هذا المعامل الاختياري كائنًا قابلًا للاستدعاء يمكن استخدامه لإعادة بناء الكائن عند استدعاءه مع صفّ المعاملات المعاد بواسطة الدالة المعطاة عند إجراء عملية السَلسَلة. القيمة المعادة راجع وحدة ...

توضّح هذه الصفحة كيفيّة استخدام أدوات البناء (Build tools) المشهورة مع شيفرة TypeScript: Browserify التثبيت npm install tsify باستخدام واجهة سطر الأوامر (Command Line Interface) browserify main.ts -p [ tsify --noImplicitAny ] > bundle.js باستخدام الواجهة البرمجية (API) var browserify = require("browserify"); var tsify = require("tsify"); browserify() .add("main.ts") .plugin("tsify", { noImplicitAny: true }) .bundle() .pipe(process.stdout); للمزيد من التفاصيل، انظر: smrq/tsify Duo التثبيت npm install duo-typescript باستخدام واجهة سطر الأوامر (Command ...

يؤدي الخروج من مفسّر بايثون إلى فقدان جميع التعريفات (الدوال والمتغيّرات) التي جرى إنشاؤها سابقًا. ولهذا السبب يفضل استخدام محررات النصوص البرمجية في حال الرغبة بكتابة برامج وشيفرات طويلة، ثم إرسال هذه الشيفرة إلى المفسّر وتشغيلها فيه.  وعندما يبدأ حجم البرنامج بالازدياد تدريجيًا تظهر الحاجة إلى تقسيم الشيفرة إلى ملفات متعددة لتسهيل العمل عليها. وقد يحتاج المبرمج في مرحلة ما إلى استخدام دالة خاصة به في برامج متعدّدة دون أن يضطر إلى نسخ تعريف تلك الدالة في كلّ برنامج. تقدّم ...

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

يعيد التابع find()‎ أدنى قيمة للفهرس والذي يكون التسلسل الفرعي موجودًا في ضمن البيانات الثنائية. البنية العامة bytes.find(sub[, start[, end]]) المعاملات sub التسلسل الفرعي المراد معرفة موقعه، ويمكن أن يكون أيّ كائن شبيه بالبايتات (bytes-like objects)، أو عددًا صحيحًا من 0 إلى 255. start الموقع الذي يبدأ منه التابع عملية البحث ضمن البيانات الثنائية. end الموقع الذي ينهي فيه التابع عملية البحث ضمن البيانات الثنائية. يسلك هذان المعاملان نفس السلوك المتّبع في عملية اقتطاع السلاسل النصية slicing. القيمة المعادة يعيد ...

يعيد التابع find()‎ أدنى قيمة للفهرس والذي يكون التسلسل الفرعي موجودًا في ضمن البيانات الثنائية. البنية العامة bytes.find(sub[, start[, end]]) المعاملات sub التسلسل الفرعي المراد معرفة موقعه، ويمكن أن يكون أيّ كائن شبيه بالبايتات (bytes-like objects)، أو عددًا صحيحًا من 0 إلى 255. start الموقع الذي يبدأ منه التابع عملية البحث ضمن البيانات الثنائية. end الموقع الذي ينهي فيه التابع عملية البحث ضمن البيانات الثنائية. يسلك هذان المعاملان نفس السلوك المتّبع في عملية اقتطاع السلاسل النصية slicing. القيمة المعادة يعيد ...

يقلب التابع حالة الحروف بترميز ASCII في التسلسل الثنائي. البنية العامة bytes.swapcase() القيمة المعادة يعيد التابع التسلسل الثنائي بعد قلب حالة حروف ASCII فيها، أي تصبح الحروف الكبيرة صغيرة، وتصبح الحروف الصغيرة كبيرة. الحروف الصغيرة في ترميز ASCII هي قيم البايتات التي تقع ضمن التسلسل: ‎b'abcdefghijklmnopqrstuvwxyz'‎. أما الحروف الكبيرة في ترميز ASCII هي قيم البايتات التي تقع ضمن التسلسل: ‎b'ABCDEFGHIJKLMNOPQRSTUVWXYZ'‎. ملاحظة: على عكس التابع str.swapcase()‎ يعيد التعبير bin.swapcase()‎.swapcase()‎ تسلسلًا ثنائيًا مطابقًا للتسلسل الثنائي الأصلي. أمثلة يبيّن المثال التالي النتائج المعادة ...

تتحقّق الدالة من أنّ البيانات الثنائية تبدأ بالقيمة التي يحدّدها المستخدم. البنية العامة b.startswith() المعاملات prefix التسلسل الذي ستبحث عنه الدالة، ويمكن أن يكون أيّ كائن شبيه بالبايتات (bytes-like object). start الموقع الذي تبدأ منه الدالة عملية الاختبار ضمن التسلسل الأصلي. end الموقع الذي تنهي فيه الدالة عملية المقارنة ضمن التسلسل الأصلي. القيمة المعادة تعيد الدالة startswith()‎ القيمة True إن كان التسلسل الأصلي يبدأ بالقيمة الممرّرة إلى المعامل prefix، وتعيد القيمة False فيما عدا ذلك. أمثلة >>> name = b'Hsoub ...

يقلب التابع حالة الحروف بترميز ASCII في التسلسل الثنائي. البنية العامة bytes.swapcase() القيمة المعادة يعيد التابع التسلسل الثنائي بعد قلب حالة حروف ASCII فيها، أي تصبح الحروف الكبيرة صغيرة، وتصبح الحروف الصغيرة كبيرة. الحروف الصغيرة في ترميز ASCII هي قيم البايتات التي تقع ضمن التسلسل: ‎b'abcdefghijklmnopqrstuvwxyz'‎. أما الحروف الكبيرة في ترميز ASCII هي قيم البايتات التي تقع ضمن التسلسل: ‎b'ABCDEFGHIJKLMNOPQRSTUVWXYZ'‎. ملاحظة: على عكس التابع str.swapcase()‎ يعيد التعبير bin.swapcase()‎.swapcase()‎ تسلسلًا ثنائيًا مطابقًا للتسلسل الثنائي الأصلي. أمثلة يبيّن المثال التالي النتائج المعادة ...

تفتح الدّالة open()‎ ملفّا وتعيد كائن ملفّ (file object) مرتبط به. إن لم يُمكِن فتح الملفّ، فسيُطلَق الاستثناء OSError‎. البنية العامة open(file, mode='r', buffering=-1, encoding=None, errors=None, newline=None, closefd=True, opener=None) المعاملات file كائن مُشابه للمسارات (path-like object) يُمثّل مسار الملفّ (سواء أكان مُطلقا أو نسبيًّا) المرغوب فتحه. يُمكن كذلك أن يكون واصف ملفّ عدديّ (integer file descriptor) للملفّ لتغطيّته (wrap). إن مُرّر واصف ملفّات، فسيُغلَق عندما يُغلَق كائن I/O المُعاد، إلّا في حالة كانت قيمة المُعامل closefd تساوي False. mode مُعامل ...

تتحقّق الدالة من أنّ البيانات الثنائية تبدأ بالقيمة التي يحدّدها المستخدم. البنية العامة b.startswith() المعاملات prefix التسلسل الذي ستبحث عنه الدالة، ويمكن أن يكون أيّ كائن شبيه بالبايتات (bytes-like object). start الموقع الذي تبدأ منه الدالة عملية الاختبار ضمن التسلسل الأصلي. end الموقع الذي تنهي فيه الدالة عملية المقارنة ضمن التسلسل الأصلي. القيمة المعادة تعيد الدالة startswith()‎ القيمة True إن كان التسلسل الأصلي يبدأ بالقيمة الممرّرة إلى المعامل prefix، وتعيد القيمة False فيما عدا ذلك. أمثلة >>> name = b'Hsoub ...

تُقدّم الوحدة functools دوال عاليّة الرّتبة (higher-order functions)، وهي دوال تستقبل دوالا أخرى، تُغيّرها، أو تُعيد دوال أخرى. وعلى العموم، يُمكن لأيّ كائن قابل للاستدعاء أن يُعامل مُعاملة الدّالة عند استخدام هذه الوحدة. تُعرّف الوحدة functools الدّوال التّاليّة: functools.cmp_to_key()‎ تُحوّل دالّةَ مُقارنة (comparison function) إلى دالّة مفتاح (key function). functools.partial()‎ تُستعمل لإنشاء دالّة جزئيّة من دالّة بتمرير قيم افتراضيّة ثابتة لها. functools.reduce()‎ تُطبّق دالّةً تأخذ مُعاملين بتراكب لعناصر الكائن القابل للتّكرار المُعطى، من اليسار إلى اليمين لتخفيض العناصر إلى قيمة ...

تُحدّث الدّالة functools.update_wrapper()‎ دالّة مُحيطةً (wrapper) لتبدوَ مثل الدّالة المُحاطة (wrapped). المُعاملات الاختياريّة هي صفوفٌ تُستخدم لتحديد أيّ خاصيّات الدّالة الأصليّة ستُعيّن مُباشرة للخاصيّات الموافقة لها على الدّالة المُحيطة وأيّ الخاصيّات من خاصيّات الدّالة المُحيطة ستُحدَّثُ بالخاصيّات المُوافقة لها في الدّالة الأصليّة. القيم الافتراضيّة لهذه المُعاملات هي الثّوابت المُتاحة على مستوى الوحدة: WRAPPER_ASSIGNMENTS‎: والتي تُعيّن كلّا من ‎__module__‎، و‎__name__‎، و‎__qualname__‎، و‎__annotations__‎‎، و‎__doc__‎‎، التي تُعدّ خاصيّاتٍ تُضيف معلومات حول الدّالة. WRAPPER_UPDATES‎: التي تُحدّث خاصيّة ‎__dict__‎ الخاصّة بالدّالة المُحيطة، أي قاموس النّسخة ...

تصرّح هذه الدالة عن كون الكائن المعطى دالة بانية صحيحة. البنية العامة copyreg.constructor(object) ‎ المعاملات object الكائن الذي ستصرح الدالة بأنّه دالة بانية صحيحة. القيمة المعادة تصرّح هذه الدالة عن كون الكائن المعطى دالة بانية صحيحة. إن كان الكائن المعطى غير قابل للاستدعاء (وهكذا يكون غير صالح لأن يصبح دالة بانية) فإنّ الدالة تطلق الاستثناء TypeError. انظر أيضًا الدالة copyreg.pickle: تصرّح الدالة عن وجوب استخدام الدالة المعطاة كدالة اختزال reduction function للكائنات من النوع المعطى. مصادر صفحة Register pickle support ...

مقدمة تقدم واجهة التجزئة الخاصة بإطار Laravel تجزئة Bcrypt و Argon2 آمنة لتخزين كلمات مرور المستخدم. إذا كنت تستخدم الصنفين الداخليين ‎(Built-in classes)‎ LoginController و RegisterController المتضمنين مع تطبيق Laravel الخاص بك، فإنهما يستخدمان Bcrypt للتسجيل والاستيثاق تلقائيًا. ملاحظة: يعدّ Bcrypt خيارًا رائعًا لتجزئة كلمات المرور لأن "عامل العمل" الخاص به قابل للتعديل، مما يعني أنه يمكن زيادة الوقت المستغرق لإنشاء تجزئة كلما زادت طاقة المعدات. الضبط يُضبط محرك تشغيل التجزئة التلقائي الخاص بتطبيقك في ملف الإعدادات config/hashing.php. يوجد حاليا ...

تُحوّل الدّالة functools.cmp_to_key()‎ دالّة مُقارنة (comparison function) إلى دالّة مفتاح (key function). تُستعمل مع الأدوات التي تقبل دوالّ مفتاح مثل sorted()‎، وmin()‎، وmax()‎، وheapq.nlargest()‎، وheapq.nsmallest()‎، وitertools.groupby()‎. تُستعمل هذه الدّالة أساسًا كأداة لنقل البرامج من Python 2 التي دعمت استعمال دوال المُقارنة. دالّة المُقارنة هي كلّ كائن قابل للاستدعاء يستقبل مُعاملين ويُقارن بينهما، ويُعيد عددًا سالبًا في حالة أصغر من، الصّفر في حالة التّساوي، وعددًا موجبًا في حالة أكبر من. ودالّة مفتاح هي كائن قابل للاستدعاء يستقبل مُعاملًا واحدًا ويُعيد قيمةً ...

تقدّم وحدة copyreg طريقة لتعريف دوال تستخدم أثناء سلسلة كائنات معيّنة في بايثون. تستخدم وحدتا pickle و copy هذه الدوال عند سلسلة أو نسخ تلك الكائنات. تقدّم الوحدة كذلك معلومات إعدادات حول الدوال البانية للكائنات التي ليست أصنافًا. يمكن لهذه الدوال البانية أن تكون دوال منشئة للكائنات factory functions أو نسخًا للأصناف. دوال الوحدة copyreg تقدّم الوحدة copyreg الدوال التالية: الدالة ‎copyreg.constructor()‎ تصرّح هذه الدالة عن كون الكائن المعطى دالة بانية صحيحة. إن كان الكائن المعطى غير قابل للاستدعاء (وهكذا ...

abs()‎ القيمة المطلقة (absolute value) لعدد معيّن. all()‎ القيمة True إن كانت جميع عناصر الكائن القابل للتكرار (iterable) المعطى تُساوي القيمة True أو إن كان الكائن القابل للتكرار فارغًا. any()‎ القيمة True إن كان أحد عناصر الكائن القابل للتكرار (iterable) المعطى يساوي القيمة True أو إن كان الكائن القابل للتكرار فارغًا. ascii()‎ تمثيل (representation) نصي لكائن مُعيّنٍ يُمكن طباعته. bin()‎ تُحوّل عددًا صحيحًا (integer number) إلى سلسلةٍ نصيّةٍ ثنائيّة (binary string) مسبوقة بالمقطع النّصيّ "0b". bool()‎ قيمة منطقيّة تكون إمّا ...

تعيد الدالة الإعدادات الحالية الخاصة باليوم الذي يبدأ به الأسبوع. البنية العامة ‎calendar.firstweekday() القيمة المعادة تعيد الدالة الإعدادات الحالية الخاصة باليوم الذي يبدأ به الأسبوع. أمثلة يبين المثال التالي طريقة استخدام الدالة: >>> import calendar >>> calendar.firstweekday() 1 انظر أيضًا الدالة setfirstweekday()‎: تعيّن الدالة اليوم الذي يبدأ به الأسبوع. مصادر صفحة General calendar-related functions في توثيق بايثون الرسمي.

تدعم بايثون مجموعة من العمليات الخاصة بالتسلسلات (القوائم، والصفوف، وكائنات range، والسلاسل النصية، والبايتات ومصفوفات البايتات). العمليات التي تدعمها معظم أنواع التسلسلات يبين الجدول التالي مجموعة من العمليات المدعومة من قبل معظم أنواع التسلسلات بنوعيها القابل للتغيير (mutable) وغير القابل للتغيير (immutable). في هذا الجدول يقصد بالحرفين s و t تسلسلين لهما النوع ذاته، وتمثّل الحروف n, i, j, k أعدادًا صحيحة، وتمثل x أي كائن تنطبق عليه القيود التي تفرضها قيم أو أنواع التسلسل s. هذه العمليات مرتبة حسب ...

تدعم بايثون مجموعة من العمليات الخاصة بالتسلسلات (القوائم، والصفوف، وكائنات range، والسلاسل النصية، والبايتات ومصفوفات البايتات). العمليات التي تدعمها معظم أنواع التسلسلات يبين الجدول التالي مجموعة من العمليات المدعومة من قبل معظم أنواع التسلسلات بنوعيها القابل للتغيير (mutable) وغير القابل للتغيير (immutable). في هذا الجدول يقصد بالحرفين s و t تسلسلين لهما النوع ذاته، وتمثّل الحروف n, i, j, k أعدادًا صحيحة، وتمثل x أي كائن تنطبق عليه القيود التي تفرضها قيم أو أنواع التسلسل s. هذه العمليات مرتبة حسب ...

تدمج الدالة عدة مدخلات مفروزة في مخرج مفرد مفروز . (على سبيل المثال: دمج عناصر ذات ختم زمني من ملفات تسجيل متعددة). البنية العامة heapq.merge(*iterables, key=None, reverse=False) المعاملات ‎*iterables يجب أن تكون جميع المُكرَّرات iterables مفروزة من الأكبر إلى الأصغر. key معامل اختياري يجب تعيينه كمعامل مفتاحي، يحدّد هذا المعامل دالة مفتاحية key function ذات معامل واحد تستخدم في استخلاص مفتاح مقارنة من كل عنصر في مدخلات الدالة. القيمة الافتراضية لهذا المعامل هي None وتجرى مقارنة العناصر على نحو مباشر ...

تدمج الدالة عدة مدخلات مفروزة في مخرج مفرد مفروز . (على سبيل المثال: دمج عناصر ذات ختم زمني من ملفات تسجيل متعددة). البنية العامة heapq.merge(*iterables, key=None, reverse=False) المعاملات ‎*iterables يجب أن تكون جميع المُكرَّرات iterables مفروزة من الأكبر إلى الأصغر. key معامل اختياري يجب تعيينه كمعامل مفتاحي، يحدّد هذا المعامل دالة مفتاحية key function ذات معامل واحد تستخدم في استخلاص مفتاح مقارنة من كل عنصر في مدخلات الدالة. القيمة الافتراضية لهذا المعامل هي None وتجرى مقارنة العناصر على نحو مباشر ...

تحوّل الدالة القائمة المعطاة إلى كومة، في نفس المكان، وفي زمن خطي linear time. البنية العامة heapq.heapify(x) المعاملات x القائمة المراد تحويلها إلى كومة. القيمة المعادة تعيد الدالة القيمة None. أمثلة يبين المثال التالي آلية عمل التابع: >>> import heapq >>> li = [5, 7, 9, 1, 3] >>> heapq.heapify(li) >>> print(list(li)) [1, 3, 9, 7, 5] مصادر صفحة General calendar-related functions في توثيق بايثون الرسمي.

تخبر الدالة ما إذا كانت السنة المعطاة كبيسة أم لا. البنية العامة calendar.isleap(year) المعاملات year السنة المراد معرفة ما إذا كانت كبيسة أم لا. القيمة المعادة تعيد الدالة القيمة المنطقية True إن كانت السنة المعطاة كبيسة، وإلا تعيد القيمة False. أمثلة يبين المثال التالي طريقة استخدام الدالة: >>> import calendar >>> calendar.isleap(2018) False >>> calendar.isleap(2016) True انظر أيضًا الدالة calendar.leapdays()‎: تعيد الدالة عدد السنوات الكبيسة ضمن نطاق السنوات المحدّد. مصادر صفحة General calendar-related functions في توثيق بايثون الرسمي.

تعيّن الدالة اليوم الذي يبدأ به الأسبوع. البنية العامة ‎calendar.setfirstweekday(weekday) المعاملات weekday يمكن استخدام أعداد صحيحة (0 هو يوم الإثنين و 6 هو يوم الأحد). كذلك يمكن استخدام القيم MONDAY، TUESDAY، WEDNESDAY، THURSDAY، FRIDAY، SATURDAY، SUNDAY لتسهيل اختيار اليوم المطلوب. القيمة المعادة تعيد الدالة القيمة None. أمثلة يبين المثال التالي طريقة استخدام الدالة: import calendar calendar.setfirstweekday(calendar.SUNDAY) calendar.setfirstweekday(6) انظر أيضًا الدالة firstweekday()‎: تعيد الدالة الإعدادات الحالية الخاصة باليوم الذي يبدأ به الأسبوع. مصادر صفحة General calendar-related functions في توثيق بايثون الرسمي.

تعيد الدالة يوم الأسبوع في اليوم المعطى في الشهر المعطى في السنة المعطاة. البنية العامة calendar.weekday(year, month, day) المعاملات year السنة المطلوبة. month الشهر المطلوب. day اليوم المطلوب. القيمة المعادة تعيد الدالة يوم الأسبوع (0 هو يوم الإثنين و 6 هو يوم الأحد) للسنة year (من 1970 وما بعدها) في الشهر month (يأخذ القيم 1-12) واليوم day (يأخذ القيم 1-31). أمثلة يبين المثال التالي طريقة استخدام الدالة: >>> import calendar >>> calendar.weekday(1988, 2, 7) 6 مصادر صفحة General calendar-related functions في توثيق ...

تعيد الدالة أول يوم في الشهر وعدد أيام الشهر المعطى في السنة المعطاة. البنية العامة calendar.monthrange(year, month) المعاملات year السنة المطلوبة. month الشهر المطلوب (من 1 إلى 12). القيمة المعادة تعيد الدالة صفًّا يتكون من عنصرين الأول هو اليوم الذي يبدأ به الشهر (كعدد صحيح) والثاني هو عدد أيام ذلك الشهر. أمثلة يبين المثال التالي طريقة استخدام الدالة: >>> import calendar >>> calendar.monthrange(2018, 8) (2, 31) انظر أيضًا الدالة monthcalendar()‎: تعيد الدالة مصفوفة matrix تمثّل تقويم الشهر. مصادر صفحة General calendar-related functions ...

تعيد الدالة عدد السنوات الكبيسة ضمن نطاق السنوات المحدّد. البنية العامة calendar.leapdays(y1, y2) المعاملات y1 و y2 يبدأ نطاق السنوات من y1 إلى y2 مع الانتباه إلى أنّ النطاق لا يتضمّن هاتين السنتين. وتعمل الدالة لنطاق سنوات يمتدّ لقرن واحد. القيمة المعادة تعيد الدالة عددًا صحيحًا يمثّل عدد السنوات الكبيسة في النطاق المحدّد للسنوات. أمثلة يبين المثال التالي طريقة استخدام الدالة: >>> import calendar >>> calendar.leapdays(2000, 2018) 5 انظر أيضًا الدالة isleap()‎: تخبر الدالة ما إذا كانت السنة المعطاة كبيسة أم لا. ...

أمثلة يوضح المثال التالي الطريقة المُثلى للاستفادة من توابع الكشف في الصنف stat: import os, sys from stat import * def walktree(top, callback): '''recursively descend the directory tree rooted at top, calling the callback function for each regular file''' for f in os.listdir(top): pathname = os.path.join(top, f) mode = os.stat(pathname).st_mode ...

الدالة Array.prototype.map()‎ تُنشِئ مصفوفةً جديدةً باستخدام القيم المُعادة من استدعاء دالة مُحدَّدة على جميع عناصر المصفوفة الأصلية. var array1 = [1, 4, 9, 16]; // دالة سهمية const map1 = array1.map(x => x * 2); console.log(map1); // [2, 8, 18, 32] البنية العامة var new_array = arr.map(callback[, thisArg]) callback الدالة التي ستختبر كل عنصر من عناصر المصفوفة، وتقبل ثلاثة وسائط. currentValue العنصر الحالي الذي يُعالِج في المصفوفة، وهذه القيمة مطلوبة. index فهرس العنصر الحالي في المصفوفة، وهذه القيمة اختيارية. array المصفوفة التي استدعيت ...

تعيد الدالة ترويسة تتضمن أسماء أيام الأسبوع بصيغة مختصرة. البنية العامة calendar.weekheader(n) المعاملات n معامل إلزامي، يحدّد عرض الترويسة بالحروف لأسبوع واحد فقط. القيمة المعادة سلسلة نصية تتضمن الصيغة المختصرة لأسماء أيام الأسبوع. أمثلة يبين المثال التالي طريقة استخدام الدالة: >>> import calendar >>> calendar.weekheader(1) 'T W T F S S M' >>> calendar.weekheader(2) 'Tu We Th Fr Sa Su Mo' >>> calendar.weekheader(3) 'Tue Wed Thu Fri Sat Sun Mon' >>> calendar.weekheader(4) 'Tue Wed Thu Fri Sat Sun Mon ' >>> calendar.weekheader(8) ' ...

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

يصم التابع taint الكائن الذي استدعي معه بأنه كائنٌ فاسد (tainted). الكائنات المُعلَّمة على أنها فاسدة ستكون محظورةً عن مختلف التوابع المُضمَّنة (built-in methods). الهدف من هذا الأمر هو منع البيانات الغير آمنة مثل وسائط سطر الأوامر أو السلاسل النصية من القراءة من التابع Kernel.gets، أو من الوصول غير المُصرَّح إلى أنظمة المستخدمين. استخدم التابع ?tainted للتحقق إذا كان الكائن فاسدا أم لا. لا يجب أن تزيل إشارة الفساد من كائن يحملها إلا إذا فصحته شيفرتك البرمجية وقرَّرت أنه آمن. ...

تحذف الدالة وتعيد أصغر عنصر في الكومة مع الحفاظ على ثبات الكومة. البنية العامة 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 >>> ...

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

تعيد الدالة مصفوفة matrix تمثّل تقويم الشهر. البنية العامة calendar.monthcalendar(year, month) المعاملات year السنة المطلوبة. month الشهر المطلوب (من 1 إلى 12). القيمة المعادة تعيد الدالة قائمة تتضمّن مصفوفة matrix تمثّل تقويم الشهر، ويعبّر كل صفّ row في هذه المصفوفة عن أسبوع واحد، أما الأيام التي تكون خارج نطاق الشهر المحدّد فتأخذ القيمة 0. يبدأ كل أسبوع بيوم الإثنين ما لم تحدّد بداية الأسبوع بواسطة الدالة setfirstweekday()‎. أمثلة يبين المثال التالي طريقة استخدام الدالة: >>> import calendar >>> calendar.monthcalendar(2018, 8) [[0, 1, ...

تحذف الدالة وتعيد أصغر عنصر في الكومة مع الحفاظ على ثبات الكومة. البنية العامة heapq.heappushpop(heap, item) المعاملات heap اسم الكومة التي ستجرى عليها عمليتا الإضافة والحذف. item العنصر الذي سيُضاف إلى الكومة. القيمة المعادة تضيف الدالة العنصر item إلى الكومة، ثم تحذف وتعيد أصغر عنصر في الكومة heap. تؤدي هذه الدالة عملها منفردة بكفاءة أكبر من استدعاء الدالة heappush()‎ ثم الدالة heappop()‎ على التوالي. أمثلة يبين المثال التالي آلية عمل التابع: >>> import heapq >>> li = [5, 7, 9, 1, ...

يمكن إنشاء دوال لا تحمل أسماء باستخدام الكلمة المفتاحية lambda، وتأخذ هذه الدوال الصيغة التالية: lambda arguments: expression تسلك هذه الصيغة المختصرة سلوك دالة معرفة بالطريقة التالية: def <lambda>(arguments): return expression على سبيل المثال، تعيد الدالة التالية مجموع الوسيطين الخاصين بها: lambda a, b: a+b يمكن استخدام دوال lambda عند الحاجة إلى كائنات الدالة (function objects)، وتأخذ هذه الدوال تعبيرًا واحدًا فقط، وهي تعدّ صيغةً مختصرةً للطريقة الاعتيادية في تعريف الدوال. كما هو الحال مع تعريفات الدوال المتداخلة، يمكن لدوال ...

يمكن إنشاء دوال لا تحمل أسماء باستخدام الكلمة المفتاحية lambda، وتأخذ هذه الدوال الصيغة التالية: lambda arguments: expression تسلك هذه الصيغة المختصرة سلوك دالة معرفة بالطريقة التالية: def <lambda>(arguments): return expression على سبيل المثال، تعيد الدالة التالية مجموع الوسيطين الخاصين بها: lambda a, b: a+b يمكن استخدام دوال lambda عند الحاجة إلى كائنات الدالة (function objects)، وتأخذ هذه الدوال تعبيرًا واحدًا فقط، وهي تعدّ صيغةً مختصرةً للطريقة الاعتيادية في تعريف الدوال. كما هو الحال مع تعريفات الدوال المتداخلة، يمكن لدوال ...

تعيد الدالة قائمة تضمّ العدد المحدّد من أكبر العناصر في مجموعة البيانات dataset المعرّفة بواسطة كائنات التكرار المعطى. البنية العامة heapq.nlargest(n, iterable, key=None) المعاملات n عدد العناصر المطلوبة. iterable كائن التكرار المراد البحث فيه عن العناصر. key يحدّد هذا المعامل -في حال تعيينه- دالة ذات معامل واحد تُستخدم لاستخلاص مفتاح مقارنة من كل عنصر في المكرّر، مثل: key=str.lower. القيمة المعادة تعيد الدالة قائمة تضمّ n من أكبر العناصر في مجموعة البيانات dataset المعرّفة بواسطة كائن التكرار. هذه الدالة مكافئة للدالة ...

تعيد الدالة قائمة تضمّ العدد المحدّد من أصغر العناصر في مجموعة البيانات dataset المعرّفة بواسطة كائنات التكرار المعطى. البنية العامة heapq.nsmallest(n, iterable, key=None) المعاملات n عدد العناصر المطلوبة. iterable كائن التكرار المراد البحث فيه عن العناصر. key يحدّد هذا المعامل -في حال تعيينه- دالة ذات معامل واحد تُستخدم لاستخلاص مفتاح مقارنة من كل عنصر في المكرّر، مثل: key=str.lower. القيمة المعادة تعيد الدالة قائمة تضمّ n من أكبر العناصر في مجموعة البيانات dataset المعرّفة بواسطة كائن التكرار. هذه الدالة مكافئة للدالة ...

يستخدم هذا الصنف لإنشاء تقويم بهيئة نصية صرفة plain text. البنية العامة ‎calendar.TextCalendar(firstweekday=0) المعاملات firstweekday المعامل firstweekday هو عدد صحيح يحدّد اليوم الأول في الأسبوع. يمثّل العدد 0 يوم الإثنين (وهو القيمة الافتراضية) والعدد 6 هو يوم الأحد. توابع الصنف TextCalendar التابع ‎formatmonth()‎ يعيد التابع التقويم الخاص بشهر معيّن على هيئة سلسلة نصية متعددة الأسطر. التابع ‎prmonth()‎ يطبع التابع تقويم الشهر الذي يعيده التابع formatmonth()‎. التابع ‎formatyear()‎ يعيد التابع العدد المحدد من أعمدة التقويم لسنة كاملة على هيئة سلسلة نصية ...

يعيد التابع قائمة بالأسابيع في الشهر المعطى في السنة المعطاة على هيئة قوائم تضمّ أرقام الأيام السبعة. البنية العامة monthdayscalendar(year, month) المعاملات year السنة المطلوبة. month الشهر المطلوب (من 0 إلى 12). القيمة المعادة يعيد التابع قائمة بالأسابيع في الشهر month في السنة year كأسابيع كاملة. تكون الأسابيع على هيئة قوائم مكوّنة من سبعة صفوف تضمّ بدورها أرقام الأيام وأرقام أيام الأسبوع. أمثلة يبين المثال التالي آلية عمل التابع: >>> from calendar import Calendar >>> cal = Calendar() >>> for c in ...

تحوّل هذه الدالة أوائل الكلمات في السلسلة النصية المعطاة إلى أحرف كبيرة. البنية العامة string.capwords(s, sep=None) المعاملات s السلسلة النصية المراد معالجتها. sep تعتمد الدالة قيمة المعامل الاختياري sep كفاصل تقسم بواسطة كلمات السلسلة النصية ثم تربطها بعضها ببعض. في حال لم يأخذ هذا المعامل أيّ قيمة، أو أخذ القيمة None، فإنّ المسافات البيضاء مهما كان عددها ستستبدل بمسافة بيضاء واحدة، وستُحذف المسافات البيضاء من بداية ونهاية السلسلة النصية أيضًا. القيمة المعادة تقسم الدالة السلسلة النصية المعطاة إلى كلمات باستخدام ...

يعيد التابع تقويم الشهر المعطى بصيغة جدول HTML. البنية العامة ‎formatmonth(theyear, themonth, withyear=True) المعاملات theyear السنة المطلوبة. themonth الشهر المطلوب (من 1 إلى 12). withyear معامل اختياري يحمل قيمة منطقية. إن أخذ هذا المعامل القيمة True فإنّ التابع سيضيف السنة إلى ترويسة جدول HTML المعاد. أما إن أخذ االمعامل القيمة False فتقتصر الترويسة على اسم الشهر فقط. القيمة المعادة سلسلة نصية تتضمّن تقويم الشهر المطلوب في السنة المطلوبة بهيئة جدول HTML. أمثلة يبين المثال التالي آلية عمل التابع: >>> from ...

يعيد التابع كائن تكرار iterator يتضمّن أرقام أيام الأسبوع التي ستستخدم لأسبوع واحد. البنية العامة ‎iterweekdays() القيمة المعادة يعيد التابع كائن تكرار iterator لأرقام أيام الأسبوع التي ستستخدم لأسبوع واحد. وتكون القيمة الأولى في كائن التكرار هي نفسها قيمة الخاصية firstweekday. أمثلة يبين المثال التالي آلية عمل التابع: >>> from calendar import Calendar >>> cal = Calendar() >>> for c in cal.iterweekdays(): ... print(c) ... 0 1 2 3 4 5 6 انظر أيضًا التابع itermonthdates()‎: يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة. التابع ...

يعيد التابع التقويم الخاص بشهر معيّن على هيئة سلسلة نصية متعددة الأسطر. البنية العامة prmonth(theyear, themonth, w=0, l=0) المعاملات theyear السنة المطلوبة. themonth الشهر المطلوب. w يحدد المعامل الاختياري ‏w عرض أعمدة التاريخ، والتي تأخذ محاذاة وسطية. l يحدد المعامل الاختياري l عدد الأسطر التي سيستخدمها كل أسبوع. القيمة المعادة يطبع التابع تقويم الشهر الذي يعيده التابع formatmonth()‎. أمثلة يبين المثال التالي آلية عمل التابع: >>> from calendar import TextCalendar >>> tcal = TextCalendar() >>> tcal.prmonth(2018, 8) August 2018 Mo ...

تحذف الدالة وتعيد أصغر عنصر في الكومة، وتضيف كذلك العنصر الجديد المعطى. البنية العامة heapq.heapreplace(heap, item) المعاملات heap الكومة التي ستُدرج فيها قيمة المعامل item. item القيمة المراد إدراجها في الكومة. القيمة المعادة تحذف الدالة وتعيد أصغر عنصر في الكومة heap، وتضيف كذلك العنصر الجديد item. لا يؤدي استخدام هذه الدالة إلى إحداث تغير في حجم الكومة، وتطلق الدالة الخطأ IndexError في حال كون الكومة فارغة. تؤدي هذه الدالة عملها بكفاءة أكبر من استدعاء الدالة heappop()‎ متبوعة بالدالة heappush()‎، إلى ...

ينشئ التابع دالة تجميع aggregate function معرّفة من قبل المستخدم. البنية العامة create_aggregate(name, num_params, aggregate_class) المعاملات name اسم دالة التجميع المراد إنشاؤها. num_params عدد المعاملات التي تستقبلها الدالة (يمكن تعيين القيمة ‎-1 لهذا المعامل لتستقبل الدالة أي عدد من المعاملات). aggregate_class صنف تجميع يجب أن يتضمّن تابع step، والذي يأخذ المعامل num_params والذي يحدّد عدد المعاملات في الدالة التي ينشئها التابع (يمكن تعيين القيمة ‎-1 لهذا المعامل لتستقبل الدالة أي عدد من المعاملات)، وتابع finalize والذي سيعيد النتيجة النهائية من ...

تطبع الدالة تقويم الشهر الذي تعيده الدالة month()‎. البنية العامة calendar.prmonth(theyear, themonth, w=0, l=0) المعاملات theyear السنة المطلوبة. themonth الشهر المطلوب (من 1 إلى 12). w معامل اختياري، يأخذ القيمة الافتراضية 0، ويحدّد عرض التقويم الذي ستطبعه الدالة. l معامل اختياري، يأخذ القيمة الافتراضية 0، ويحدّد مقدار الفاصل بين الأسطر في التقويم الذي ستطبعه الدالة. القيمة المعادة تعيد الدالة تقويم الشهر المعطى في السنة المعطاة. أمثلة يبين المثال التالي طريقة استخدام الدالة: >>> import calendar >>> calendar.prmonth(2018, 8, 1, 1) ...

يعيد التابع قائمة بالأسابيع في الشهر المعطى في السنة المعطاة على هيئة قوائم مكوّنة من سبعة صفوف تضمّ بدورها أرقام الأيام وأرقام أيام الأسبوع. البنية العامة monthdays2calendar(year, month) المعاملات year السنة المطلوبة. month الشهر المطلوب (من 0 إلى 12). القيمة المعادة يعيد التابع قائمة بالأسابيع في الشهر month في السنة year كأسابيع كاملة. تكون الأسابيع على هيئة قوائم مكوّنة من سبعة صفوف تضمّ بدورها أرقام الأيام وأرقام أيام الأسبوع. أمثلة يبين المثال التالي آلية عمل التابع: >>> from calendar import ...

يمكن التعامل مع البيانات النصية في بايثون باستخدام كائنات str أو السلاسل النصية (strings)، وهي تسلسلات (sequences) غير قابلة للتغيير (immutable) من رموز يونيكود (Unicode). هناك طرائق مختلفة للتعبير عن السلاسل النصية، إذ يمكن أن تحاط بعلامات اقتباس مفردة ('...') أو مزدوجة ("...")، ويستخدم الرمز \ لتهريب علامات الاقتباس: >>> 'spam eggs'  # علامات اقتباس مفردة 'spam eggs' >>> 'doesn\'t'  # استخدم \' لتهريب علامات الاقتباس المفردة...‏ "doesn't" >>> "doesn't"  # ...أو استخدم علامات الاقتباس المزدوجة "doesn't" >>> '"Yes," he said.' '"Yes," he said.' >>> "\"Yes,\" he said." '"Yes," ...

يمكن التعامل مع البيانات النصية في بايثون باستخدام كائنات str أو السلاسل النصية (strings)، وهي تسلسلات (sequences) غير قابلة للتغيير (immutable) من رموز يونيكود (Unicode). هناك طرائق مختلفة للتعبير عن السلاسل النصية، إذ يمكن أن تحاط بعلامات اقتباس مفردة ('...') أو مزدوجة ("...")، ويستخدم الرمز \ لتهريب علامات الاقتباس: >>> 'spam eggs'  # علامات اقتباس مفردة 'spam eggs' >>> 'doesn\'t'  # استخدم \' لتهريب علامات الاقتباس المفردة...‏ "doesn't" >>> "doesn't"  # ...أو استخدم علامات الاقتباس المزدوجة "doesn't" >>> '"Yes," he said.' '"Yes," he said.' >>> "\"Yes,\" he said." '"Yes," ...

يعيد التابع التقويم الخاص بشهر معيّن على هيئة سلسلة نصية متعددة الأسطر. البنية العامة ‎formatmonth(theyear, themonth, w=0, l=0) المعاملات theyear السنة المطلوبة. themonth الشهر المطلوب. w يحدد المعامل الاختياري ‏w عرض أعمدة التاريخ، والتي تأخذ محاذاة وسطية. l يحدد المعامل الاختياري l عدد الأسطر التي سيستخدمها كل أسبوع. القيمة المعادة يعيد التابع التقويم الخاص بشهر معيّن على هيئة سلسلة نصية متعددة الأسطر. يعتمد التابع في تحديد اليوم الأول من الأسبوع على القيمة المحدّدة في الدالة البانية أو المعيّنة بواسطة التابع ...

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

يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق datetime.date، وتعاد الأيام على هيئة أعداد صحيحة. البنية العامة itermonthdays(year, month) المعاملات year السنة المطلوبة. month الشهر المطلوب (من 0 إلى 12). القيمة المعادة يعيد التابع كائن تكرار للشهر month في السنة year بصورة مشابهة للتابع ()itermonthdates، ولكنّ النتيجة لا تكون مقيّدة بالنطاق datetime.date. تعاد الأيام على هيئة أعداد تمثّل اليوم في الشهر، أما الأيام التي تكون خارج الشهر المحدد فتأخذ القيمة 0. أمثلة يبين المثال التالي ...

ينشئ التابع مقارنة collation يحمل الاسم المعطى مع الكائن القابل للاستدعاء المعطى. البنية العامة create_collation(name, callable) ‎المعاملات name اسم المقارنة المراد إنشاؤها. callable كائن قابل للاستدعاء. سيُمرّر وسيطان نصّيان إلى الكائن القابل للاستدعاء، وسيعيد النتيجة ‎-1 إن كان ترتيب الوسيط الأول أدنى من الوسيط الثاني، ويعيد 0 إن كان الوسيطان متساويين، ويعيد 1 إن كان ترتيب الوسيط الأول أعلى من الوسيط الثاني. لاحظ أنّ هذه المقارنة تتحكّم في عبارة (ORDER BY في SQL) لكي لا تؤثّر عمليات المقارنة على عمليات ...

تعيد الدالة تقويم الشهر على هيئة سلسلة نصية متعددة الأسطر. البنية العامة calendar.month(theyear, themonth, w=0, l=0) المعاملات theyear السنة المطلوبة. themonth الشهر المطلوب (من 1 إلى 12). w معامل اختياري، يأخذ القيمة الافتراضية 0، ويحدّد عرض التقويم الذي ستطبعه الدالة. l معامل اختياري، يأخذ القيمة الافتراضية 0، ويحدّد مقدار الفاصل بين الأسطر في التقويم الذي ستطبعه الدالة. القيمة المعادة تعيد الدالة تقويم الشهر على هيئة سلسلة نصية متعددة الأسطر باستخدام التابع formatmonth()‎ الخاص بالصنف TextCalendar. أمثلة يبين المثال التالي طريقة ...

يعيد التابع ‎__id__‎‎ (يدعى أيضًا object_id) مُعرِّفا عدديًا للكائن الذي استُدعي معه. سيُعاد نفس المعرِّف في كل مرة يُستدعى فيها التابع object_id مع الكائن نفسه، ولن يتشارك أي كائنين نشطين نفس المعرِّف. ملاحظة: يُعاد استخدام بعض كائنات الأصناف المٌضمّنة (built-in classes) وذلك لتحسين الأداء. هذا هو الحال بالنسبة للقيم المباشرة (immediate values) والسلاسل النصية الحرفية المجمدة (frozen string literals). لا تُمرَّر القيم المباشرة بالمرجع (reference) ولكنَّها تُمرَّر بالقيمة، مثل nil، وtrue، وfalse، وFixnums، وSymbols، وFloats. البنية العامة object_id → integer ...

مقدمة تعليمات الشرطات المائلة الثلاث (Triple-slash directives) هي تعليقات تكتب في سطر واحد تحتوي على وسم XML واحد. تُستخدَم محتويات التعليق كتعليمات (إرشادات) للمترجم. تكون تعليمات الشرطات المائلة الثلاث صالحةً فقط في أعلى الملفّ الذي تكون هذه التعليمات موجودة داخله. ويُمكن لهذه التعليمات أن تُسبَق فقط بتعليق في سطر واحد أو تعليق متعدّد الأسطر (multi-line comment)، ما يشمل تعليمات شرطات مائلة ثلاث أخرى. إذا وُجِدَت بعد جملة أو تصريح فستُعامَل على أنها تعليقات عادية في سطر واحد (regular single-line comments)، ...

يعدّ UserString صنفًا يغلّف السلاسل النصية في بايثون، ولكن الحاجة إلى هذا الصنف أصبحت محدودة نظرًا لإمكانية التفريع المباشر من الصنف str، ولكن التعامل مع هذا الصنف أسهل بسبب إمكانية الوصول إلى السلسلة النصية الضمنية كخاصية. البنية العامة class collections.UserString(seq) يحاكي هذا الصنف السلاسل النصية العادية في بايثون، ويجري الاحتفاظ بمحتويات النسخة في سلسلة نصية عادية يمكن الوصول إليها عن طريق خصائص نسخ الصنف UserString. تُسند محتويات النسخة بادئ الأمر إلى نسخة من المعامل seq. يمكن أن يكون المعامل seq ...

يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق datetime.date، وتعاد الأيام على هيئة صفوف تتضمّن رقم السنة، ورقم الشهر، ورقم اليوم في الشهر، ورقم اليوم في الأسبوع. البنية العامة monthdatescalendar(year, month) المعاملات year السنة المطلوبة. month الشهر المطلوب (من 0 إلى 12). القيمة المعادة يعيد التابع قائمة بالأسابيع في الشهر month في السنة year كأسابيع كاملة. الأسابيع هي قوائم تتضمّن سبعة كائنات datetime.date. أمثلة يبين المثال التالي آلية عمل التابع: >>> for c in cal.monthdatescalendar(2018, ...

هذا الصنف متفرّع من الصنف TextCalendar. يمكن تمرير اسم المنطقة في المعامل locale إلى الدالة البانية وستعيد الدالة أسماء الأشهر وأيام الأسبوع حسب المنطقة المحدّدة. إن تضمّنت المنطقة ترميزًا خاصًّا فإنّ جميع السلاسل النصية التي تتضمّن أسماء الأشهر وأيام الأسبوع ستعاد بالترميز unicode. البنية العامة ‎calendar.LocaleTextCalendar(firstweekday=0, locale=None) المعاملات firstweekday المعامل firstweekday هو عدد صحيح يحدّد اليوم الأول في الأسبوع. يمثّل العدد 0 يوم الإثنين (وهو القيمة الافتراضية) والعدد 6 هو يوم الأحد. locale سلسلة نصية تتضمن اسم الإعدادات المحلية المطلوب ...

يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق datetime.date، وتعاد الأيام على هيئة صفوف تتضمن رقم اليوم في الشهر ورقم اليوم في الأسبوع. البنية العامة itermonthdays2(year, month) المعاملات year السنة المطلوبة. month الشهر المطلوب (من 0 إلى 12). القيمة المعادة يعيد التابع كائن تكرار للشهر month في السنة year بصورة مشابهة للتابع ()itermonthdates، ولكنّ النتيجة لا تكون مقيّدة بالنطاق datetime.date. تكون الأيام المعادة على هيئة صفوف تتضمن رقم اليوم في الشهر ورقم اليوم في الأسبوع. ...

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

يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة. البنية العامة itermonthdates(year, month) المعاملات year السنة المطلوبة. month الشهر المطلوب (من 0 إلى 12). القيمة المعادة يعيد التابع كائن تكرار للشهر month في السنة year، وسيعيد هذا الكائن جميع الأيام (ككائنات datetime.date) للأشهر والأيام كلها قبل بداية الشهر أو بعد نهاية الشهر والتي تكون مطلوبة للحصول على أسبوع كامل. أمثلة يبين المثال التالي آلية عمل التابع: >>> from calendar import Calendar >>> cal = Calendar() >>> for c in cal.itermonthdates(2018, 8): ... ...

يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق datetime.date، وتعاد الأيام على هيئة صفوف تتضمن رقم السنة والشهر ويوم الأسبوع. البنية العامة itermonthdays3(year, month) المعاملات year السنة المطلوبة. month الشهر المطلوب (من 0 إلى 12). القيمة المعادة يعيد التابع كائن تكرار للشهر month في السنة year بصورة مشابهة للتابع ()itermonthdates، ولكنّ النتيجة لا تكون مقيّدة بالنطاق datetime.date. كون الأيام المعادة على هيئة صفوف تتضمن رقم السنة والشهر ويوم الأسبوع. ملاحظة: هذا التابع جديد في الإصدار ...

هذا الصنف متفرّع من الصنف HTMLCalendar. يمكن تمرير اسم المنطقة في المعامل locale إلى الدالة البانية وستعيد الدالة أسماء الأشهر وأيام الأسبوع حسب المنطقة المحدّدة. إن تضمّنت المنطقة ترميزًا خاصًّا فإنّ جميع السلاسل النصية التي تتضمّن أسماء الأشهر وأيام الأسبوع ستعاد بالترميز unicode. البنية العامة ‎calendar.LocaleHTMLCalendar(firstweekday=0, locale=None) المعاملات firstweekday المعامل firstweekday هو عدد صحيح يحدّد اليوم الأول في الأسبوع. يمثّل العدد 0 يوم الإثنين (وهو القيمة الافتراضية) والعدد 6 هو يوم الأحد. locale سلسلة نصية تتضمن اسم الإعدادات المحلية المطلوب ...

ينشئ التابع دالة معرفة من قبل المستخدم يمكن استعمالها لاحقًا ضمن جمل SQL. البنية العامة create_function(name, num_params, func) ‎المعاملات name اسم الدالة المراد إنشاؤها. num_params عدد المعاملات التي تستقبلها الدالة (يمكن تعيين القيمة ‎-1 لهذا المعامل لتستقبل الدالة أي عدد من المعاملات). func كائن قابل للاستدعاء callable في بايثون، والذي سيستدعى كدالة SQL. القيمة المعادة يمكن للدالة أن تعيد أيّة قيمة من القيم المدعومة في SQLite وهي: bytes، str، int، float، None. أمثلة يبين المثال التالي طريقة استخدام الدالة: import ...

يقدّم كائن Calendar في وحدة calendar عددًا من التوابع التي يمكن استخدامها لتحضير بيانات التقويم لغرض التنسيق. وتجدر الإشارة هنا إلى أنّ هذا الصنف لا يؤدي أي عمليات تنسيق، وأنّ هذه العمليات تقع على عاتق الأصناف الفرعية. البنية العامة calendar.Calendar(firstweekday=0) تنشئ هذه الدالة البانية كائن Calendar جديد. المعاملات firstweekday المعامل firstweekday هو عدد صحيح يحدّد اليوم الأول في الأسبوع. يمثّل العدد 0 يوم الإثنين (وهو القيمة الافتراضية) والعدد 6 هو يوم الأحد. توابع الصنف Calendar تقدّم نسخ الصنف Calendar التوابع ...

يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة دون تقييد النتيجة بالنطاق datetime.date، وتعاد الأيام على هيئة صفوف تتضمّن رقم السنة، ورقم الشهر، ورقم اليوم في الشهر، ورقم اليوم في الأسبوع. البنية العامة itermonthdays4(year, month) المعاملات year السنة المطلوبة. month الشهر المطلوب (من 0 إلى 12). القيمة المعادة يعيد التابع كائن تكرار للشهر month في السنة year بصورة مشابهة للتابع ()itermonthdates، ولكنّ النتيجة لا تكون مقيّدة بالنطاق datetime.date. تكون الأيام المعادة على هيئة صفوف تتضمّن رقم السنة، ورقم الشهر، ...

يستخدم هذا الصنف ملفًّا يكتب فيه تدفق البيانات المسلسلة. البنية العامة class pickle.Pickler(file, protocol=None, *, fix_imports=True) ‎ المعاملات file يجب أن يمتلك كائن الملفّ تابع write()‎ يستقبل معامل بايتات واحدًا فقط؛ لهذا يمكن أن يكون ملفًّا مخزّنًا في القرص الصلب مفتوحًا لكتابة البيانات الثنائية، أو نسخة من io.BytesIO، أو أي كائن مخصّص آخر يطابق هذه الشروط. protocol معامل اختياري، وهو عدد صحيح يُعلم المُسلسِل باستخدام البرتوكول المحدّد بالرقم المعطى، والبروتوكولات المدعومة هي من 0 إلى قيمة الثابت HIGHEST_PROTOCOL. * معامل ...

يستخدم هذا الصنف لإنشاء تقويم بهيئة HTML. البنية العامة calendar.HTMLCalendar(firstweekday=0) المعاملات firstweekday المعامل firstweekday هو عدد صحيح يحدّد اليوم الأول في الأسبوع. يمثّل العدد 0 يوم الإثنين (وهو القيمة الافتراضية) والعدد 6 هو يوم الأحد. توابع الصنف HTMLCalendar تقدّم نسخ الصنف HTMLCalendar التوابع التالية: التابع ‎formatmonth()‎ يعيد التابع تقويم الشهر المعطى بصيغة جدول HTML. التابع ‎formatyear()‎ يعيد التابع تقويم السنة المعطاة على هيئة جدول HTML. التابع ‎formatyearpage()‎ يعيد التابع تقويم السنة المعطاة على هيئة صفحة HTML كاملة. خصائص الصنف HTMLCalendar ...

تتيح هذه الوحدة الحصول على تقاويم مشابهة لمخرجات البرنامج cal في أنظمة يونكس، إلى جانب أنّها تقدّم عددًا من التوابع المفيدة والخاصة بالتقاويم. يبدأ الأسبوع في هذه التقاويم بصورة افتراضية بيوم الإثنين، وينتهي بيوم الأحد (هذا هو السائد في أوروبا). يمكن استخدام الدالة setfirstweekday()‎ لجعل الأسبوع يبدأ بيوم الأحد (6) أو أي يوم آخر. تكون المعاملات التي تحدّد التواريخ أعدادًا صحيحة. تقدّم بايثون وحدتين إضافيتين للتعامل مع الوقت والتاريخ هما datetime و time. تستخدم الدوال والأصناف المعرّفة في هذه الوحدة ...

تتضمّن هذه الوحدة أنواع بيانات متخصّصة بالحاويات container وتقدّم بدائل للحاويات الداخلية dict و list و set و tuple. تقدّم هذه الوحدة الكائنات التالية: namedtuple دالة مولِّدة factory function لإنشاء أصناف فرعية من صفٍّ يتضمن حقولًا مسمّاة deque حاوية شبيهة بالقوائم تمتاز بأدائها السريع في إضافة العناصر وحذفها في كلا الطرفين. ChainMap صنف شبيه بالقواميس يستخدم لإنشاء عرض منفرد لعمليات ربط mapping متعددة Counter صنف فرعي من الصنف dict الهدف منه عدّ الكائنات القابلة للتقطيع hashable OrderedDict صنف فرعي من ...

تقدّم بايثون عبارة if للتحكم المشروط بتدفق الشيفرة، وتأخذ الصيغة التالية: if expression: statement فعلى سبيل المثال: >>> x = int(input("Please enter an integer: ")) Please enter an integer: -16 >>> if x < 0: ...     x = 0 ...     print('Negative changed to zero') Negative changed to zero عبارة elif يمكن استخدام عبارة elif (وهي اختصار لعبارة 'else if' ) عند الحاجة إلى التحقق من شروط إضافية، وكما هو موضح في المثال التالي: >>> x = int(input("Please enter an integer: ")) Please ...

تقدّم بايثون عبارة if للتحكم المشروط بتدفق الشيفرة، وتأخذ الصيغة التالية: if expression: statement فعلى سبيل المثال: >>> x = int(input("Please enter an integer: ")) Please enter an integer: -16 >>> if x < 0: ...     x = 0 ...     print('Negative changed to zero') Negative changed to zero عبارة elif يمكن استخدام عبارة elif (وهي اختصار لعبارة 'else if' ) عند الحاجة إلى التحقق من شروط إضافية، وكما هو موضح في المثال التالي: >>> x = int(input("Please enter an integer: ")) Please ...

تختلف عبارة for قليلًا في بايثون عن نظيرتها في لغتي C أو Pascal، فبدلًا من تكرار الحلقة استنادًا إلى عملية حسابية (مثل لغة Pascal) أو منح المستخدم القدرة على تعريف عدد مرات التكرار والشرط الذي يؤدي إلى إيقاف عمل الحلقة (كما في لغة C)، فإنّ عبارة for في بايثون تمرّ على عناصر أي تسلسل (قائمة أو سلسلة نصية) معتمدة في ذلك على ترتيب تلك العناصر في ذلك التسلسل. بنية عبارة for >>> # معرفة أطوال السلاسل النصية: ... words = ['cat', ...

تختلف عبارة for قليلًا في بايثون عن نظيرتها في لغتي C أو Pascal، فبدلًا من تكرار الحلقة استنادًا إلى عملية حسابية (مثل لغة Pascal) أو منح المستخدم القدرة على تعريف عدد مرات التكرار والشرط الذي يؤدي إلى إيقاف عمل الحلقة (كما في لغة C)، فإنّ عبارة for في بايثون تمرّ على عناصر أي تسلسل (قائمة أو سلسلة نصية) معتمدة في ذلك على ترتيب تلك العناصر في ذلك التسلسل. بنية عبارة for >>> # معرفة أطوال السلاسل النصية: ... words = ['cat', ...

تعيد الدّالة itertools.groupby()‎ مُكرّرًا يُعيد مفاتيح مُتسلسلة ومجموعات (groups) تنتمي إلى هذه المفاتيح من الكائن القابل للتّكرار المعطى. العمليّة التي تقوم بها الدّالة مُشابهة لكيفيّة عمل المُرشّح uniq في أنظمة Unix. إذ تُولّد نقطة توقّف (break) أو مجموعة جديدة في كلّ مرّة تتغيّر فيها قيمة الدّالةِ المفتاح (لذا يجب في الغالب ترتيب البيانات باستعمال نفس الدّالة المفتاح). وطريقة العمل هذه تختلف عن طريقة عمل عبارة GROUP BY في لغة SQL التي تجمع العناصر المُشتركة بغضّ النّظر عن ترتيب البيانات. البنية ...

تُحوّل الدّالة functools.singledispatch()‎ دالّةً عاديّة إلى دالّة عموميّة وحيدة الإرسال (single-dispatch generic function). الدّالة العموميّة هي كلّ دالّة تتكوّن من عدّة دوال تُنفّذ نفس العمليّة لعدّة أنواع. تُحدّد الدّالة التي ستُنفّذ عبر خوارزميّة الإرسال (dispatch algorithm). تكون الدّالة العموميّة وحيدةَ إرسالٍ إذا كان نوع مُعامل واحد هو الذي يُحدّد الدّالة التي ستُنفَّذ. البنية العامة @functools.singledispatch المعاملات لا توجد مُعاملات القيمة المعادة دالّة عموميّة وحيدة الإرسال. أمثلة لإنشاء دالّة عموميّة، زخرِفها بالمُزخرِف ‎@singledispatch‎. لاحظ أنّ الإرسال يحدث عند نوع أوّل مُعامل: ...

القواميس المرتّبة OrderedDict مطابقة للقواميس العادية باستثناء أنّها تتذكر ترتيب العناصر لحظة إدراجها فيها، بمعنى أنّه عند إضافة العناصر إلى قاموس مرتب، تعاد العناصر حسب ترتيب مفاتيحها عند إضافتها أول مرّة. البنية العامة class collections.OrderedDict([items]) تعيد الدالة البانية نسخة من صنف متفرّع عن الصنف dict تدعم جميع توابعه. كائن OrderedDict هو قاموس يتذكّر ترتيب مفاتيحه عند إدخالها أوّل مرة. وإن جرى كتابة عنصر جديد فوق عنصر موجود في القاموس المرتّب، فإنّ موضع الإدخال الأصلي لا يتغيّر، أما حذف عنصر معيّن ...

يطبع التابع التقويم لسنة كاملة بالاعتماد على ما يعيده التابع formatyear()‎. البنية العامة pryear(theyear, w=2, l=1, c=6, m=3) المعاملات theyear السنة المطلوبة. w معامل اختياري يحدّد عرض عمود التاريخ، ويأخذ القيمة الافتراضية 2. l معامل اختياري يحدّد عدد الأسطر لكل أسبوع، ويأخذ القيمة الافتراضية 1. c معامل اختياري يحدّد عدد الفراغات بين أعمدة الشهر. m معامل اختياري يحدّد عدد أعمدة التقويم، ويأخذ القيمة الافتراضية 3. القيمة المعادة يطبع التابع التقويم لسنة كاملة بالاعتماد على ما يعيده التابع formatyear()‎. أمثلة يبين ...

تُعرَّف الدوال باستخدام الكلمة المفتاحية def يتبعها اسم الدالة ثم قائمة بالمعاملات محاطة بالأقواس. أما الكتلة الرئيسية للدالة فتبدأ في السطر التالي لسطر التعريف، ويجب أن تزاح بمقدار إزاحة واحدة. مثال >>> def fib(n): # دالة لإنشاء متسلسلة فابيوناتشي ... """Print a Fibonacci series up to n.""" ... a, b = 0, 1 ... while a < n: ... print(a, end=' ') ... ...

صنف متفرّع من الصنف الداخلي dict يعيد تعريف override تابع واحد ويضيف متغير نسخة واحدًا قابلًا للكتابة. البنية العامة ‎class collections.defaultdict([default_factory[, ...]]) تعيد الدالة البانية لهذا الصنف كائنًا جديدًا شبيهًا بالقاموس، وdefaultdict هو صنف متفرّع من الصنف الداخلي dict يعيد تعريف override تابع واحد ويضيف متغير نسخة واحدًا قابلًا للكتابة. أما بقية التوابع فهي مماثلة للصنف الرئيسي ولن توثّق هنا. يحدّد المعامل الأول القيمة الابتدائية للخاصية default_factory ويأخذ هذا المعامل القيمة الافتراضية None. أما بقية المعاملات (ومن ضمنها المعاملات المفتاحية) ...

يعيد التابع البيانات الخاصة بالسنة المعطاة، وتكون البيانات جاهزة للتنسيق، وتكون العناصر في قوائم الأسابيع عبارة عن صفوف تتضمّن أعداد الأيام. البنية العامة yeardayscalendar(year, width=3) المعاملات year السنة المطلوبة. width يحدّد الحد الأقصى للشهور في كل صفّ، ويأخذ القيمة 3 كقيمة افتراضية. القيمة المعادة يعيد التابع البيانات الخاصة بالسنة المعطاة، وتكون البيانات جاهزة للتنسيق (كما هو الحال مع التابع yeardatescalendar()‎). العناصر في قوائم الأسابيع عبارة عن صفوف تتضمّن أعداد الأيام. وتأخذ الأيام التي تكون خارج نطاق هذا الشهر القيمة 0. ...

تُعرَّف الدوال باستخدام الكلمة المفتاحية def يتبعها اسم الدالة ثم قائمة بالمعاملات محاطة بالأقواس. أما الكتلة الرئيسية للدالة فتبدأ في السطر التالي لسطر التعريف، ويجب أن تزاح بمقدار إزاحة واحدة. مثال >>> def fib(n): # دالة لإنشاء متسلسلة فابيوناتشي ... """Print a Fibonacci series up to n.""" ... a, b = 0, 1 ... while a < n: ... print(a, end=' ') ... ...

تُعرَّف الدوال باستخدام الكلمة المفتاحية def يتبعها اسم الدالة ثم قائمة بالمعاملات محاطة بالأقواس. أما الكتلة الرئيسية للدالة فتبدأ في السطر التالي لسطر التعريف، ويجب أن تزاح بمقدار إزاحة واحدة. مثال >>> def fib(n): # دالة لإنشاء متسلسلة فابيوناتشي ... """Print a Fibonacci series up to n.""" ... a, b = 0, 1 ... while a < n: ... print(a, end=' ') ... ...

بنية اللغة بيان للبنية العامة للغة بايثون وبعض الأمور العامة مثل التعليقات وتسمية المعرّفات وغيرها. مفسر بايثون يستخدم مفسر بايثون لمعالجة الشيفرات المكتوبة بها، وهو يقبل عددًا من الخيارات، ويمكن تشغيله في الوضع التفاعلي. أنواع البيانات القيمة المنطقية (boolean) القيمتان المنطقيتان اللتان تدعمهما بايثون هما True و False وهما كائنان ثابتان (Constant objects) يعبران عن صحّة تعبير ما، فإمّا أن يكون صحيحًا True أو خطأً False. الأعداد الصحيحة (int) العدد الصحيح integer هو أي عدد موجب أو سالب لا يتضمن ...

تقدّم كائنات الاتصال Connection عددًا من الخصائص والتوابع التي تساعد المستخدم في التعامل مع قواعد بيانات SQLite، كالاتصال بقاعدة البيانات وتحميل الملحقات وإنشاء النسخ الاحتياطية وغيرها. تنشأ كائنات الاتصال كنتيجة لاستدعاء الدالة sqlite3.connect()‎. خصائص كائنات الاتصال تمتلك كائنات الاتصال بقواعد البيانات SQLite الخصائص التالية: الخاصية isolation_level يمكن استخدام هذه الخاصية لمعرفة مستوى العزل الافتراضي الحالي أو تعيينه. تأخذ الخاصية القيمة None لنمط الحفظ التلقائي autocommit أو إحدى القيم "DEFERRED" أو "IMMEDIATE" أو "EXCLUSIVE". راجع قسم التحكم بالإجراءات للمزيد من المعلومات. ...

تقدّم كائنات الاتصال Connection عددًا من الخصائص والتوابع التي تساعد المستخدم في التعامل مع قواعد بيانات SQLite، كالاتصال بقاعدة البيانات وتحميل الملحقات وإنشاء النسخ الاحتياطية وغيرها. تنشأ كائنات الاتصال كنتيجة لاستدعاء الدالة sqlite3.connect()‎. خصائص كائنات الاتصال تمتلك كائنات الاتصال بقواعد البيانات SQLite الخصائص التالية: الخاصية isolation_level يمكن استخدام هذه الخاصية لمعرفة مستوى العزل الافتراضي الحالي أو تعيينه. تأخذ الخاصية القيمة None لنمط الحفظ التلقائي autocommit أو إحدى القيم "DEFERRED" أو "IMMEDIATE" أو "EXCLUSIVE". راجع قسم التحكم بالإجراءات للمزيد من المعلومات. ...

يعيد التابع التقويم الخاص بشهر معيّن على هيئة سلسلة نصية متعددة الأسطر. البنية العامة formatyear(theyear, w=2, l=1, c=6, m=3) المعاملات theyear السنة المطلوبة. w معامل اختياري يحدّد عرض عمود التاريخ، ويأخذ القيمة الافتراضية 2. l معامل اختياري يحدّد عدد الأسطر لكل أسبوع، ويأخذ القيمة الافتراضية 1. c معامل اختياري يحدّد عدد الفراغات بين أعمدة الشهر. m معامل اختياري يحدّد عدد أعمدة التقويم، ويأخذ القيمة الافتراضية 3. القيمة المعادة يعيد التابع العدد المحدّد من أعمدة التقويم لسنة كاملة على هيئة سلسلة ...

يعيد التابع تقويم السنة المعطاة على هيئة صفحة HTML كاملة. البنية العامة formatyearpage(theyear, width=3, css='calendar.css', encoding=None) المعاملات theyear السنة المطلوبة. width يحدّد المعامل (والذي يأخذ القيمة الافتراضية 3) عدد الأشهر في كل صفّ من صفوف الجدول المعاد. css يحدّد هذا المعامل اسم ملف الأنماط التشعبية CSS الذي سيُستخدم مع صفحة HTML المعادة. يمكن تمرير القيمة None إلى هذا المعامل في حال عدم الرغبة في استخدام أي أنماط تشعبية. encoding يحدّد هذا المعامل الترميز المستخدم في صفحة HTML المعادة، ويأخذ هذا ...

يقدّم الصنف Chainmap طريقة سريعة لربط عدد من عمليات الربط mappings ليصبح بالإمكان التعامل معها كوحدة واحدة. وعادة ما تكون هذه الطريقة أسرع من إنشاء قاموس جديد واستدعاء التابع update()‎ مرّات عدة. يمكن استخدام هذا الصنف لمحاكاة النطاقات المتشعّبة وهو مفيد في عملية القولبة templating. البنية العامة class collections.ChainMap(*maps) يجمع الصنف CmainMap عددًا من القواميس أو وسائل الربط الأخرى لإنشاء عرض مفرد قابل للتحديث. في حال تعيين قيمة المعامل maps، فإنّ الصنف يقدّم قاموسًا واحدًا فارغًا، وبهذا ستمتلك السلسلة الجديدة كائن ...

يعيد التابع تقويم السنة المعطاة على هيئة جدول HTML. البنية العامة formatyear(theyear, width=3) المعاملات theyear السنة المطلوبة. width يحدّد المعامل (والذي يأخذ القيمة الافتراضية 3) عدد الأشهر في كل صفّ من صفوف الجدول المعاد. القيمة المعادة سلسلة نصية تتضمّن تقويم السنة المطلوبة بهيئة جدول HTML. أمثلة يبين المثال التالي آلية عمل التابع: >>> from calendar import HTMLCalendar >>> cal = HTMLCalendar() >>> cal.formatyear(2018) '<table border="0" cellpadding="0" cellspacing="0" class="year">\n<tr><th colspan="3" class="year">2018</th></tr><tr><td><table border="0" cellpadding="0" cellspacing="0" class="month">\n<tr><th colspan="7" class="month">January</th></tr>\n<tr><th class="mon">Mon</th><th class="tue">Tue</th><th class="wed">Wed</th><th class="thu">Thu</th><th class="fri">Fri</th><th class="sat">Sat</th><th class="sun">Sun</th></tr>\n<tr><td ...

المشكلة أن يكون محتوى التابع (method body) بسيطًا وواضحًا أكثر من التابع بحدِّ ذاته، ويمكن عندئذٍ الاستغناء عنه. الحل نقل الشيفرة الموجودة في التابع (محتوى التابع) إلى مواقع استدعائه، وحذف التابع برمته إذ لا داعي له. مثال قبل إعادة التصميم نلاحظ أن محتوى التابع moreThanFiveLateDeliveries()‎ واضحٌ وبسيطٌ لدرجةٍ تجعل الاستغناء عنه ممكنًا: في لغة Java: class PizzaDelivery { //... int getRating() { return moreThanFiveLateDeliveries() ? 2 : 1; } boolean moreThanFiveLateDeliveries() { ...