نتائج البحث

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

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

لا تنشئ عبارات الإسناد في بايثون نسخة من الكائنات، بل تربط بين الهدف والكائن. ولكن تظهر الحاجة إلى إنشاء نسخ من الكائنات في المجموعات التي تكون قابلة للتعديل أو التي تتضمّن عناصر قابلة للتعديل، بحيث يكون بالإمكان تغيير نسخة دون انتقال تلك التغييرات إلى الكائن الآخر. دوال الوحدة copy تقدّم هذه الوحدة مجموعة من عمليات النسخ السطحية والعميقة. copy.copy(x)‎ تعيد الدالة نسخة سطحية من الكائن المعطى. copy.deepcopy(x)‎ تعيد الدالة نسخة عميقة من الكائن المعطى. exception copy.error يُطلق هذا الاستثناء عند ...

تطلق اللغة هذا الاستثناء عند تمرير سلسلة نصية غير صالحة كتعبير نمطي إلى إحدى الدوال السابقة (كأن تتضمن السلسلة أقواسًا غير متطابقة)، أو عند حدوث أخطاء أخرى أثناء عملية التصريف أو المطابقة. لا يعد خلوّ السلسلة النصية من التطابقات خطأً على الإطلاق. البنية العامة re.error(msg, pattern=None, pos=None) الخاصيات تمتلك نسخة الخطأ الخصائص الإضافية التالية: msg رسالة الخطأ غير المنسّقة. pattern التعبير النمطي. pos موقع حدوث الخطأ في تصريف التعبير النمطي (قد يأخذ القيمة None). lineno السطر الحاوي على قيمة الخاصية ...

تهرّب الدالة جميع المحارف الخاصّة في التعبير النمطي المعطى باستثناء حروف الترميز ASCII، والأعداد والشرطة السفلية. البنية العامة re.escape(pattern) المعاملات pattern التعبير النمطي الذي تهرّب الدالة محارفه الخاصة. القيمة المعادة تعيد الدالة النمط الأصلي بعد تهريب جميع المحارف الخاصّة فيه باستثناء حروف الترميز ASCII، والأعداد والشرطة السفلية. هذه الدالة مفيدة عند الحاجة إلى مطابقة سلسلة نصية يحتمل أن تتضمن بعض الحروف الخاصّة بالتعابير النمطية. أمثلة تبيّن الأمثلة التالية طرق استخدام الدالة re.escape()‎: >>> print(re.escape('python.exe')) python\.exe >>> legal_chars = string.ascii_lowercase + string.digits + ...

تفحص الدالة السلسلة النصية بحثًا عن أول موقع يحصل فيه تطابق مع التعبير النمطي المعطى، وتعيد كائن match المقابل. البنية العامة re.search(pattern, string, flags=0) المعاملات pattern التعبير النمطي المستخدم لإجراء عملية المطابقة. string السلسلة النصية التي ستبحث فيها الدالة عن حالات التطابق. flags الرايات المستخدمة لضبط عملية البحث. يأخذ هذا المعامل القيمة 0 كقيمة افتراضية. راجع قسم المعاملات في توثيق الدالة ()re.compile للمزيد من المعلومات. القيمة المعادة تعيد الدالة كائن match عند العثور على حالة تطابق بين التعبير النمطي والسلسلة ...

تتحقّق الدالة ممّا إذا كانت السلسلة النصية بأكملها مطابقة للتعبير النمطي المعطى. البنية العامة re.fullmatch(pattern, string, flags=0) المعاملات pattern التعبير النمطي المستخدم لإجراء عملية المطابقة. string السلسلة النصية التي ستبحث فيها الدالة عن حالات التطابق. flags الرايات المستخدمة لضبط عملية البحث. يأخذ هذا المعامل القيمة 0 كقيمة افتراضية. راجع قسم المعاملات في توثيق الدالة ()re.compile للمزيد من المعلومات. القيمة المعادة إن طابقت السلسلة النصية بأكملها التعبير النمطي المعطى، فستعيد الدالة كائن match المقابل، وتعيد القيمة None إن لم تطابق السلسلة ...

تعيد الدالة جميع حالات التطابق غير المتداخلة للنمط المطبق على السلسلة النصية المعطاة على هيئة قائمة من السلاسل النصية. البنية العامة re.findall(pattern, string, flags=0) المعاملات pattern التعبير النمطي المستخدم لإجراء عملية المطابقة. string السلسلة النصية التي ستبحث فيها الدالة عن حالات التطابق. flags الرايات المستخدمة لضبط عملية البحث. يأخذ هذا المعامل القيمة 0 كقيمة افتراضية. راجع قسم المعاملات في توثيق الدالة ()re.compile للمزيد من المعلومات. القيمة المعادة تعيد الدالة جميع حالات التطابق غير المتداخلة للنمط المطبق على السلسلة النصية المعطاة ...

تعيد الدالة كائنًا قابلًا للتكرار iterator ينتج عنه كائنات match لجميع حالات التطابق غير المتداخلة والناتجة من تطبيق التعبير النمطي المعطى على السلسلة النصية المعطاة. البنية العامة re.finditer(pattern, string, flags=0) المعاملات pattern التعبير النمطي المستخدم لإجراء عملية المطابقة. string السلسلة النصية التي ستبحث فيها الدالة عن حالات التطابق. flags الرايات المستخدمة لضبط عملية البحث. يأخذ هذا المعامل القيمة 0 كقيمة افتراضية. راجع قسم المعاملات في توثيق الدالة ()re.compile للمزيد من المعلومات. القيمة المعادة تعيد الدالة كائنًا قابلًا للتكرار iterator ينتج ...

تفحص الدالة بداية السلسلة النصية بحثًا عن حالة تطابق مع التعبير النمطي المعطى، وتعيد كائن match المقابل. البنية العامة re.match(pattern, string, flags=0) المعاملات pattern التعبير النمطي المستخدم لإجراء عملية المطابقة. string السلسلة النصية التي ستبحث فيها الدالة عن حالات التطابق. flags الرايات المستخدمة لضبط عملية البحث. يأخذ هذا المعامل القيمة 0 كقيمة افتراضية. راجع قسم المعاملات في توثيق الدالة ()re.compile للمزيد من المعلومات. القيمة المعادة تعيد الدالة كائن match المقابل إن عثرت على صفر أو أكثر من المحارف في بداية ...

تصرّف الدالة التعبير النمطي إلى كائن تعبير نمطي regex يمكن استخدامه للمطابقة بواسطة توابعه الخاصّة match()‎ و search()‎ وغيرها. البنية العامة re.compile(pattern, flag=0) المعاملات pattern التعبير النمطي المراد تصريفه. flags يمكن تحديد طريقة التعامل مع التعبير النمطي باستخدام قيم الرايات، ويمكن استخدام أكثر من راية وذلك بفصلها بعامل OR الخاص بالأعداد الثنائية (العامل |). يمكن استخدام المتغيرات التالية كقيم للمعامل flags: re.A re.ASCII يؤدي استخدام هذه الراية إلى جعل عملية المطابقة الخاصة بالتسلسلات ‎\w ،\W ،\b ،\B ،\d ،\D ،\s ...

التعبير البرمجي import يُستخدَم لاستيراد ما صُدِّر من وحدة (module) أخرى. لاحظ أنَّ دعم هذه الميزة ما يزال محدودًا، لذا انظر إلى قسم «دعم المتصفحات» قبل استخدامها. البنية العامة import defaultExport from "module-name"; import * as name from "module-name"; import { export } from "module-name"; import { export as alias } from "module-name"; import { export1 , export2 } from "module-name"; import { export1 , export2 as alias2 , [...] } from "module-name"; import defaultExport, { export [ , [...] ] } from "module-name"; import defaultExport, * ...

يعيد التابع nesting قائمة من الوحدات المتشعبة (Modules nested) لحظة الاستدعاء. البنية العامة nesting → array‎ القيمة المعادة تعاد مصفوفة تحوي قائمة من الوحدات المتشعبة لحظة الاستدعاء. أمثلة مثال على استخدام التابع nesting‎: module M1 module M2 $a = Module.nesting end end $a #=> [M1::M2, M1] $a[0].name #=> "M1::M2"‎ انظر أيضا التابع constants: يعيد مصفوفة مكونة أسماء كل الثوابت التي يمكن الوصول إليها لحظة الاستدعاء. التابع new: ينشئ وحدة مجهولة ...

يكافئ التابع extended التابع included إلا أنه يُستخدم مع الوحدات الموسعة (extended modules). البنية العامة extended(othermod)‎ المعاملات othermod‎ وحدة من النوع Module. أمثلة مثال على استخدام التابع extended‎: module A def self.extended(mod) puts "#{self} extended in #{mod}" end end module Enumerable extend A end # => prints "A extended in Enumerable"‎ انظر أيضا التابع included: يمثِّل رد نداء يُستدعَى في كل مرة يتم تضمين المستقبل (receiver) في وحدة أو صنف آخر. التابع extend_object: يوسع الكائن المعطى بإضافة ثوابت ...

يعيد التابع used_modules مصفوفة تحتوي جميع الوحدات (modules) المستخدمة في النطاق الحالي. ترتيب الوحدات في المصفوفة الناتجة غير محدد. البنية العامة used_modules → array‎ القيمة المعادة تعاد مصفوفة تحتوي جميع الوحدات (modules) المستخدمة في النطاق الحالي. أمثلة مثال على استخدام التابع used_modules‎: module A refine Object do end end module B refine Object do end end using A using B p Module.used_modules‎ ناتج تنفيذ الشيفرة هو: [B, A] انظر أيضا التابع using: يستورد الأصناف المهذبة (class refinements) من الوحدة في التعريف الحالي للصنف أو الوحدة. ...

يكافئ التابع prepended التابع included باستثناء أنَّه مخصص للوحدات المُرفقة (prepended modules). البنية العامة prepended(othermod)‎ المعاملات othermod‎ الوحدة الأخرى. أمثلة مثال على استخدام التابع prepended‎: module A def self.prepended(mod) puts "#{self} prepended to #{mod}" end end module Enumerable prepend A end # => prints "A prepended to Enumerable"‎ انظر أيضا التابع prepend_features: يُستدعَى في الوحدة المعطاة عندما تُرفَق هذه الوحدة في أخرى، وتُمرَّر إليها الوحدة المُستقبِلة (receiving module) في الوحدة التي مُمرِّرت إليه.  التابع prepend: يستدعي التابع Module.prepend_features على كل المعاملات ...

تطبّق وحدة pickle بروتوكولات ثنائية لغرض سَلسلَة وإلغاء سَلسَلَة بنية كائنات بايثون. تطلق تسمية Pickling على العملية التي يتحوّل فيها تسلسل هرمي لكائن بايثون إلى تدفق بايتات byte stream، وتطلق تسمية Unpickling على العملية العكسية والتي يتحوّل فيها تدفّق بايتات (من ملف ثنائي أو كائن شبيه بالبايتات) إلى تسلسل هرمي لكائن بايثون. تحمل هاتان العمليتان (Pickling و Unpickling) أسماءً أخرى مثل السَلسَلَة "serialization"، والترتيب "marshalling" (ليس المقصود هنا وحدة marshal) والتسطيح "falttening". سنستخدم مصطلحي السلسلة وإلغاء السلسلة في هذا التوثيق ...

enumeration هو مجموعة من الأسماء الرمزية (العناصر) المرتبطة بقيم ثابتة وفريدة. يمكن مقارنة عناصر enumeration عن طريق هويتها، ويمكن المرور على عناصر enumeration بواسطة حلقة تكرارية. وحدة enum تقدّم وحدة enum أربعة أصناف enumeration يمكن استخدامها لتعريف مجموعة فريدة من الأسماء والقيم، وهذه الأصناف هي: Enum و IntEnum و Flag و IntFlag. وإلى جانب ما سبق تقدّم الوحدة مزخرفًا واحدًا هو unique()‎، وصنفًا مساعدًا واحدًا هو auto. الصنف enum.Enum هو الصنف الأساسي والذي يستخدم لإنشاء ثوابت معدّدة enumerated constants. راجع ...

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

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

يُستدعَى التابع prepend_features في الوحدة المعطاة عندما تُرفق هذه الوحدة في أخرى، وتُمرَّر إليها الوحدة المُستقبِلة (receiving module) في الوحدة التي مُمرِّرت إليه. الإعداد الافتراضي هو إحلال (overlay) ثوابت وتوابع ومتغيرات الوحدة الخاصة بهذه الوحدة في المعامل mod المُمرَّر إن لم تكن هذه الوحدة مضافةً إليه سلفًا أو إلى أحد أسلافه (ancestors). البنية العامة prepend_features(mod)→ mod‎ المعاملات mod‎ كائن من النوع Module. القيمة المعادة تعاد وحدة من النوع Module. انظر أيضا التابع prepend: يستدعي التابع Module.prepend_features على كل المعاملات المعطاة بترتيب ...

يسجل التابع autoload اسم الملف المعطى لكي يُحمّل (باستخدام Kernel::require) في المرة الأولى التي يتم الوصول فيها إلى وحدة محدَّدة. البنية العامة autoload(module, filename)→ nil‎ المعاملات module سلسلةٌ نصيةٌ أو رمزٌ (symbol) يمثِّل اسم الوحدة. filename اسم الملف. المراد تحميله عن الوصول إلى الوحدة module. القيمة المعادة تعاد القيمة nil عند نجاح العملية. أمثلة مثال على استخدام التابع autoload‎: autoload(:MyModule, "/usr/local/lib/modules/my_module.rb") ‎ انظر أيضا التابع autoload?‎: يعيد اسم الملف المراد تحميله إذا سُجّل للتحميل عند الوصول إلى وحدة محدَّدة عبر التابع autoload. ...

هذه ملفّات تصريحاتٍ ستساعدك كبدايةٍ لكتابة ملفّاتك الخاصّة، انظر صفحة هياكل المكتبات للتعرف على الملفّ الذي يجب عليك استخدامه. ‎ module.d.ts ‎ module-class.d.ts ‎ module-function.d.ts global.d.ts ‎module-plugin.d.ts‎ ‎global-plugin.d.ts‎ global-modifying-module.d.ts‎ مصادر صفحة Templates في توثيق TypeScript الرسمي.

يستدعي التابع prepend التابع prepend_features على كل المعاملات المعطاة بترتيب عكسي. البنية العامة prepend(module, ...) → self‎ المعاملات module‎ يمثل وحدةً من النوع Module. القيمة المعادة يعاد الكائن المعطى. انظر أيضا التابع prepend_features: يُستدعَى في الوحدة المعطاة عندما تُرفَق هذه الوحدة في أخرى، وتُمرَّر إليها الوحدة المُستقبِلة (receiving module) في الوحدة التي مُمرِّرت إليه.  مصادر قسم التابع prepend‎ في الصنف Module‎ في توثيق روبي الرسمي.

ينشئ التابع module_function دوال وحدة (module functions) للتوابع المعطاة. يمكن استدعاء هذه الدوال مع الوحدة كمُستقبِلات (receiver)، كما يمكن أن تصبح متاحةً كتوابع نسخة (instance methods) للأصناف التي تُمزج (mix) في الوحدة. دوال النوع Module هي نسخ من الدوال الأصلية، وبالتالي يمكن تغييرها بشكل مستقل. توابع النسخة (instance-method) ستتحول إلى خاصة. وإذا تم استدعاء التابع module_function دون معاملات، فستصبح التوابع التي ستُعرَّف لاحقًا دوال وحدة (module functions). تُحوّل الوسائط النصية إلى رموز. البنية العامة module_function(symbol, ...) → self module_function(string, ...) → self‎ المعاملات ...

الوحدات تخدم الوحدات (Modules) غايتين اثنتين في لغة روبي وهما: ميّزة نطاقات الأسماء (namespace)، والخلط الضمني (mix-in) التي سنوضّحها لاحقًا. يستخدم نطاق الأسماء لتنظيم الشيفرة البرمجية ضمن مجموعات مستقلّة تمنع تداخل التوابع والمتغيّرات ذات الأسماء المتشابهة فيما بينها. فعلى سبيل المثال، نطاق الأسماء IRB يوفّر عمليات irb والتي تمنع التصادم مع الاسم الشائع "Context". وظيفة الخلط الضمني (Mix-in) تسمح بمشاركة توابع مشتركة عبر عدد من الأصناف أو الوحدات، إذ يأتي مع لغة روبي على سبيل المثال الوحدة Enumerable التي توفّر ...

مجال الأسماء هو رابط بين الأسماء والكائنات، وتستخدم معظم مجالات الأسماء في الوقت الحاضر كقواميس. ومن الأمثلة على مجالات الأسماء: مجموعة الأسماء الداخلية (وتتضمن الدوال مثل abs()‎، وأسماء الاستثناءات الداخلية)، والأسماء العامة (global) في وحدة معينة، والأسماء المحلية (local) في بنية دالّة ما. إضافة إلى ما سبق، يمكننا أن نعدّ مجموعة خاصيات (attributes) كائن معيّن مجالًا للأسماء أيضًا. والمقصود بالخاصيات هنا كل ما يأتي بعد النقطة، فعلى سبيل المثال في التعبير z.real تعدّ real خاصية للكائن z. كذلك تعدّ الإشارات ...

يستدعي التابع each_object كتلةً محدَّدةً مرةً لكل كائنٍ نشطٍ (living object) أو غير مباشرٍ (nonimmediate object) في هذه العملية الحالية في روبي. إذا حُدِّدت الوحدة (module) المراد تنفيذ الكتلة عليها، فسيستدعي التابع الكتلة للأصناف أو الوحدات المماثلة لهذه الوحدة (أو لتلك التي تكون صنفًا فرعيًا منها). يُعيد التابع each_object عدد الكائنات التي عُثر عليها. لا تُعاد الكائنات المباشرة (مثل Fixnums، و Symbols، و true، و false، و nil) أبدًا. إذا لم تُعطَ أي كتلة إلى التابع each_object، فستُعاد نسخةٌ من ...

تقدّم بايثون عبارة 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', ...

يفحص هذا التابع السلسلة النصية المعطاة بحثًا عن أول موقع يحصل فيه تطابق مع التعبير النمطي المصرّف، ويعيد كائن التطابق المقابل. البنية العامة regex.search(string[, pos[, endpos]]) المعاملات string السلسلة النصية التي ستبحث فيها الدالة عن حالات التطابق. pos يحدّد هذا المعامل الاختياري الموقع الذي يبدأ منه التابع البحث في السلسلة النصية، ويأخذ القيمة الافتراضية 0. إن تحديد موقع بدء عملية البحث ليس مطابقًا تمامًا لعملية تقطيع السلسلة النصية، فالمحرف '^' يطابق في بداية السلسلة النصية وفي المواقع التي تأتي بعد ...

يقسم التابع السلسلة النصية عند كل مكان تحدث فيه عملية مطابقة للنمط المصرّف. هذا التابع مطابق تمامًا للدالة re.split()‎. البنية العامة regex.split(string, maxsplit=0) المعاملات string السلسلة النصية التي سيبحث فيها التابع عن حالات التطابق. maxsplit العدد الأقصى من التقسيمات التي سيجريها التابع على السلسلة النصية. في حال كان العدد الأقصى من التقسيمات أقل من عدد حالات المطابقة فإنّ التابع يعيد ما يبقى من السلسلة النصية ليكون العنصر الأخير في القائمة المعادة. يأخذ هذا المعامل القيمة الافتراضية 0. القيمة المعادة يقسم ...

التعبير البرمجي export يمكن أن يُستخدَم عند إنشاء وحدات JavaScript (أي JavaScript modules) لتصدير الدوال أو الكائنات أو القيم الأوليّة (primitive values) من وحدة (module) لكي يمكن استخدامها من برنامج آخر باستخدام التعبير البرمجي import. لاحظ أنَّ دعم هذه الميزة ما يزال محدودًا، لذا انظر إلى قسم «دعم المتصفحات» قبل استخدامها. البنية العامة export { name1, name2, …, nameN }; export { variable1 as name1, variable2 as name2, …, nameN }; export let name1, name2, …, nameN; // also var, function export let ...

ملاحظة حول المصطلحات تغيّرت طريقة استخدام المصطلحات في النسخة TypeScript 1.5، إذ كانت مجالات الأسماء (namespaces) تُسمّى قديمًا بمصطلح "الوحدات الداخليّة (internal modules)"، وما كان يُسمّى بالوحدات الخارجيّة (External modules) أصبح يُسمّى ببساطة بمصطلح "الوحدات (modules)" وهو ما سنغطّيه في هذه الصفحة. ويجب استخدام الكلمة المفتاحية ‎namespace‎ في الأماكن التي كانت تُستخدَم فيها الكلمة المفتاحية ‎module‎ للتصريح عن وحدة داخليّة في النسخ التي سبقت TypeScript 1.5، أي أنّ عليك استخدام ‎namespace X {‎ عوضًا عن ‎module X {‎ (انظر صفحة ...

يمثِّل التابع included رد نداء يُستدعَى في كل مرة يتم تضمين المستقبل (receiver) في وحدة أو صنف آخر. يُفضل استخدام هذا التابع على استخدام التابع append_features إن كنت تريد تنفيذ بعض الإجراءات عند تضمين وحدة في أخرى. البنية العامة included(othermod)‎ المعاملات othermod‎ وحدة من النوع Module. أمثلة مثال على استخدام التابع included‎: module A def A.included(mod) puts "#{self} included in #{mod}" end end module Enumerable include A end # => prints "A included in Enumerable"‎ انظر أيضا التابع include?‎: ...

يتحقق التابع include?‎ إن كانت الوحدة المعطاة مُضمّنة في الوحدة التي استُدعي معها أو أحد أسلافها (ancestors). البنية العامة include?(module) → true or false‎ المعاملات module‎ الوحدة المراد التحقق منها. القيمة المعادة تعاد القيمة true إن كانت الوحدة module المعطاة مُضمّنة في الوحدة التي استُدعي معها أو أحد أسلافها (ancestors)، وإلا فستُعاد القيمة false. أمثلة مثال على استخدام التابع include?‎: module A end class B include A end class C < B end B.include?(A) #=> true C.include?(A) #=> true A.include?(A) #=> false‎ ...

ينشئ التابع new وحدة مجهولة (anonymous module) جديدة. في حال إعطاء كتلة، فسيٌمرر إليها الوحدة (module)، وستُقيم الكتلة في سياق هذه الوحدة مثل module_eval. اضبط الوحدة وأسند إليها قيمةً ثابتةً (يبدأ اسمها بحرف كبير) إذا كنت تريد معاملتها كأنها وحدة عادية. البنية العامة new→ mod new {|mod| block }→ mod‎ القيمة المعادة تعاد وحدة مجهولة (anonymous module) جديدة. أمثلة مثال على استخدام التابع new‎: fred = Module.new do def meth1 "hello" end def meth2 ...

يتحقّق هذا التابع من تطابق التعبير النمطي المصرّف مع السلسلة النصية المعطاة كاملة، ويعيد كائن التطابق المقابل. البنية العامة regex.fullmatch(string[, pos[, endpos]]) المعاملات string السلسلة النصية التي ستبحث فيها الدالة عن حالات التطابق. pos يحدّد هذا المعامل الاختياري الموقع الذي يبدأ منه التابع البحث في السلسلة النصية، ويأخذ القيمة الافتراضية 0. إن تحديد موقع بدء عملية البحث ليس مطابقًا تمامًا لعملية تقطيع السلسلة النصية، فالمحرف '^' يطابق في بداية السلسلة النصية وفي المواقع التي تأتي بعد محرف السطر الجديد، ولكن ...

يعيد التابع جميع حالات التطابق غير المتداخلة للنمط المصرّف والمطبّق على السلسلة النصية المعطاة على هيئة قائمة من السلاسل النصية. البنية العامة regex.findall(string[, pos[, endpos]]) المعاملات string السلسلة النصية التي سيبحث فيها التابع عن حالات التطابق. pos يحدّد هذا المعامل الاختياري الموقع الذي يبدأ منه التابع البحث في السلسلة النصية، ويأخذ القيمة الافتراضية 0. إن تحديد موقع بدء عملية البحث ليس مطابقًا تمامًا لعملية تقطيع السلسلة النصية، فالمحرف '^' يطابق في بداية السلسلة النصية وفي المواقع التي تأتي بعد محرف ...

يعيد التابع name اسم الوحدة، أو يعيد القيمة nil إن كانت الوحدة مجهولة (anonymous modules). البنية العامة name → string‎ القيمة المعادة يعاد اسم الوحدة، أو القيمة nil إن كانت الوحدة مجهولة. انظر أيضا التابع module_function: ينشئ دوال وحدة (module functions) للتابع المعطى. مصادر قسم التابع name‎ في الصنف Module‎ في توثيق روبي الرسمي.

يُضيف التابع extend توابع النسخة (instance) من كُلِّ وحدةٍ مُرِّرت إليه إلى الكائن الذي استدعي معه. البنية العامة extend(module, ...) → obj المعاملات module الوحدة المراد إضافة توابع النسخة منها. القيم المعادة يُعاد الكائن المعطى مضافًا إليه توابع النسخة من الوحدات المُمرَّرة. أمثلة مثالٌ عن استخدام التابع extend: module Mod def hello "Hello from Mod.\n" end end class Klass def hello "Hello from Klass.\n" end end k = Klass.new k.hello ...

يعيد التابع owner الصنف أو الوحدة (module) التي تعرف التابع الحر الذي استدعي معه. البنية العامة owner → class_or_module‎ القيمة المعادة يعاد الصنف أو الوحدة (module) التي تعرف التابع الحر. انظر أيضًا التابع original_name: يعيد الاسم الأصلي للتابع الحر الذي استُدعي معه. التابع parameters: يعيد معلومات عن معاملات التابع الحر الذي استُدعي معه. مصادر قسم التابع owner‎ في الصنف UnboundMethod‎ في توثيق روبي الرسمي.

يفحص هذا التابع بداية السلسلة النصية المعطاة بحثًا عن حالة تطابق مع التعبير النمطي المصرّف، ويعيد كائن التطابق المقابل. البنية العامة regex.match(string[, pos[, endpos]]) المعاملات string السلسلة النصية التي ستبحث فيها الدالة عن حالات التطابق. pos يحدّد هذا المعامل الاختياري الموقع الذي يبدأ منه التابع البحث في السلسلة النصية، ويأخذ القيمة الافتراضية 0. إن تحديد موقع بدء عملية البحث ليس مطابقًا تمامًا لعملية تقطيع السلسلة النصية، فالمحرف '^' يطابق في بداية السلسلة النصية وفي المواقع التي تأتي بعد محرف السطر ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة session_module_name()‎ أو تضبط الوحدة البرمجية المستخدمة للجلسة الحالية. الوصف string session_module_name ([ string $module ] ) تعيد  هذه الدالة أو تضبط الوحدة البرمجية المستخدمة للجلسة الحالية. المعاملات   module إذا تَم تحديد قيمة للمعامل، سيُستعمل بدلًا من الوحدة البرمجية المستخدمة للجلسة الحالية. القيم المعادة تُعيد الدالة الوحدة البرمجية المستخدمة للجلسة الحالية. مصادر صفحة الدالة ()session_module_name في توثيق PHP الرسمي.

يستورد التابع using الأصناف المحسَّنة (class refinements) من الوحدة المٌمررة إليه إلى التعريف الحالي للصنف أو الوحدة. البنية العامة using(module) → self‎ المعاملات module‎ الوحدة التي سيُستورد منها الأصناف المحسَّنة. القيمة المعادة يعاد الكائن المعطى نفسه. انظر أيضا التابع refine: يحسِّن الوحدة المستقبلة (receiver) ثم يعيد الوحدة التي عُرِّفت فيها التوابع المحسَّنة. التابع used_modules: يعيد مصفوفة تحتوي جميع الوحدات (modules) المستخدمة في النطاق الحالي. مصادر قسم التابع using‎ في الصنف Module‎ في توثيق روبي الرسمي.

يعيد التابع كائنًا قابلًا للتكرار iterator ينتج عنه كائنات match لجميع حالات التطابق غير المتداخلة والناتجة من تطبيق التعبير النمطي المصرّف على السلسلة النصية المعطاة. البنية العامة regex.finditer(string[, pos[, endpos]]) المعاملات string السلسلة النصية التي سيبحث فيها التابع عن حالات التطابق. pos يحدّد هذا المعامل الاختياري الموقع الذي يبدأ منه التابع البحث في السلسلة النصية، ويأخذ القيمة الافتراضية 0. إن تحديد موقع بدء عملية البحث ليس مطابقًا تمامًا لعملية تقطيع السلسلة النصية، فالمحرف '^' يطابق في بداية السلسلة النصية وفي ...

تؤدي هذه الدالة نفس عمل الدالة re.sub()‎ ولكنّها تعيد الناتج على هيئة صفّ (السلسلة الجديدة، عدد الاستبدالات المجراة). البنية العامة re.subn(pattern, repl, string, count=0, flags=0) المعاملات pattern التعبير النمطي المستخدم لإجراء عملية المطابقة. يمكن للنمط أن يكون سلسلة نصية أو كائن نمط (pattern object). repl يمكن للبديل repl أن يكون سلسلة نصية أو دالة، وإن كان سلسلة نصية، فإنّ الدالة تعالج جميع المحارف المهرّبة فيها. بمعنى أنّ ‎\n تحوّل إلى محرف سطر جديد مفرد، و ‎\r تحوّل إلى حرف إرجاع، ...

يعيد التابع included_modules قائمة بالوحدات المضمنة في الوحدة التي استُدعي معها. البنية العامة included_modules → array‎ القيمة المعادة تعاد مصفوفة تحوي الوحدات المضمنة في الوحدة التي استُدعي معها. أمثلة مثال على استخدام التابع included_modules‎: module Mixin end module Outer include Mixin end Mixin.included_modules #=> [] Outer.included_modules #=> [Mixin]‎ انظر أيضا التابع include: يستدعي التابع Module.append_features على كل المعاملات الممررة بترتيب عكسي. التابع included: يُستدعى في كل مرة يتم تضمين المستقبل (receiver) في وحدة أو صنف آخر. التابع include?‎: يتحقق إن كانت الوحدة المعطاة مُضمّنةً ...

هذه الكائنات متوفرة في جميع الوحدات (modules). قد تبدو المتغيرات التالية عامة ولكنها ليست كذلك. وهي موجودة فقط داخل نطاق الوحدات، راجع صفحة توثيق نظام الوحدات: ‎__dirname ‎__filename exports module require()‎‎‎ الكائنات المذكورة هنا خاصة ببيئة تشغيل Node.js. هناك عدد من الكائنات المضمنة التي تعد جزءًا من لغة JavaScript نفسها، والتي يمكن الوصول إليها عمومًا أيضًا. الصنف Buffer أُضيف مع الإصدار: v0.1.103. <function> يستخدم لمعالجة البيانات الثنائية. راجع صفحة توثيق buffer. ‎__dirname قد يبدو هذا المتغير عامًا ولكنه ليس كذلك. ...

يُُسجل التابع autoload اسم الملف المراد تحميله (باستخدام Kernel::require) في أول مرة يتم فيها الوصول إلى الوحدة الممررة (والتي قد تكون سلسلةً نصيةً أو رمزًا) في مجال أسماء الوحدة التي استُدعيت معه. البنية العامة autoload(module, filename)→ nil‎ المعاملات module‎ سلسلة نصية أو رمز يمثل الوحدة. filename‎ اسم الملف. القيمة المعادة تعاد القيمة nil. أمثلة مثال على استخدام التابع autoload‎: module A end A.autoload(:B, "b") A::B.doit # autoloads "b"‎ انظر أيضا التابع autoload?‎: يعيد اسم ...

يتحقق التابع const_get من وجود ثابت باسم محدد في الوحدة التي استُدعي معها. في حال تعيين المعامل inherit، فسيشمل البحث الأسلاف أيضًا (وكذلك Object إن كانت الوحدة من النوع Module). تُعاد قيمة الثابت إذا عُثر على تعريف له؛ خلا ذلك، سيُطلق الخطأ NameError. Math.const_get(:PI) #=> 3.14159265358979 سيبحث التابع const_get بشكل تكراري (recursively) عن أسماء الثوابت إذا تم توفير اسم صنف من مجال أسماء (namespaced class name). اطلع مثلًا على المثال التالي: module Foo; class Bar; end end Object.const_get 'Foo::Bar' تؤخذ الراية inherit بالحسبان ...

يضيف التابع كائن TarInfo المعطى إلى ملف الأرشيف. البنية العامة TarFile.addfile(tarinfo, fileobj=None) ‎المعاملات ‎fileobj معامل اختياري يجب أن تكون قيمته ملفًّا ثنائيًا، وتُقرأ عدد البايتات في tarinfo.size من هذا الملف وتضاف إلى الأرشيف. يمكن إنشاء كائنات TarInfo مباشرة، أو باستخدام التابع gettarinfo()‎. القيمة المعادة يعيد التابع القيمة None. أمثلة يبين المثال التالي آلية عمل التابع: >>> import tarfile >>> tar = tarfile.open('files.tar', 'w') >>> tar_info = tar.gettarinfo('file5.js') >>> tar.addfile(tar_info) انظر أيضًا التابع TarFile.add()‎: يضيف التابع الملف المعطى إلى ملف الأرشيف. التابع TarFile.gettarinfo()‎: ينشئ ...

يعيد التابع قائمة بأسماء الأعضاء في الأرشيف. البنية العامة TarFile.getnames() القيمة المعادة يعيد التابع قائمة بأسماء الأعضاء في الأرشيف، وتأخذ القائمة المعادة نفس ترتيب القائمة المعادة من التابع getmembers()‎. أمثلة يبين المثال التالي آلية عمل التابع: >>> import tarfile >>> tar = tarfile.open('files.tar') >>> tar.getnames() ['file1.txt', 'file2.html', 'file3.py'] انظر أيضًا التابع TarFile.getmember()‎: يعيد التابع كائن TarInfo لعضو ملف الأرشيف المعطى. التابع TarFile.getmembers()‎: يعيد التابع أعضاء الأرشيف على هيئة قائمة من كائنات TarInfo. مصادر صفحة Read and write tar archive files في توثيق بايثون ...

ينشئ التابع نسخة سطحية من كائن deque. البنية العامة d.‎copy() القيمة المعادة يعيد التابع كائن deque جديد يمثّل نسخة سطحية عن كائن dequeالأصلي. أمثلة يبين المثال التالي آلية عمل التابع. يلاحظ أنّ كائني deque أدناه يمتلكان معرّفين مختلفين، ولكنّ عناصرهما تمتلك المعرّفات نفسها: >>> import collections >>> t1 = (1, 2, 3, 4, 5) >>> d1 = collections.deque(t1) >>> d2 = d1.copy() >>> print (d1) deque([1, 2, 3, 4, 5]) >>> print(d2) deque([1, 2, 3, 4, 5]) >>> print(id(d1)) 140310509291624 >>> print(id(d2)) 140310509291520 >>> print(id(d1[0])) 140310800147520 >>> print(id(d2[0])) 140310800147520 انظر أيضًا التابع clear()‎:  :يحذف جميع ...

يحذف التابع الخيار المحدّد من القسم المحدّد. البنية العامة remove_option(section, option) ‎المعاملات section القسم الذي يحتوي على الخيار المراد حذفه. option الخيار المراد حذفه. القيمة المعادة إن لم يكن القسم المحدّد موجودًا، سيطلق التابع الاستثناء NoSectionError. يعيد التابع القيمة True إن كان الخيار المراد حذفه موجودًا، ويعيد القيمة False فيما عدا ذلك. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import configparser >>> config = configparser.ConfigParser() >>> config.read('config.cfg') ['config.cfg'] >>> config.remove_option('topsecret.server.com', 'php_version') True انظر أيضًا التابع remove_section()‎: يحذف التابع القسم المعطى من ملف الإعدادات. مصادر ...

يستدعي هذا التابعُ التابعَ Cursor.executemany()‎ مع تمرير المعاملات المعطاة. البنية العامة executemany(sql[, parameters]) ‎المعاملات sql سلسلة نصية تتضمن جملة SQL المراد تنفيذها. القيمة المعادة هذا التابع هو طريقة مختصرة لإنشاء كائن مؤشر عن طريق استدعاء التابع cursor()‎، حيث يستدعي التابع executemany()‎ في كائن المؤشر مع تمرير المعاملات المعطاة، ثم يعيد كائن المؤشر. أمثلة يبين المثال التالي آلية عمل التابع: import sqlite3 conn = sqlite3.connect('example.db') purchases = [('2006-03-28', 'BUY', 'IBM', 1000, 45.00), ...

يفتح التابع ملف FTP المحدّد في الطلب المعطى. يجري تسجيل الدخول دائمًا باستخدام حقلي اسم المستخدم وكلمة المرور فارغين. البنية العامة FTPHandler.ftp_open(req) المعاملات req طلب HTTP المراد إرساله. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

يتيح التابع القدرة على تحديد ما إذا كان التوقيت الصيفي مستخدمًا أم لا. البنية العامة ‎time.dst() القيمة المعادة إن أخذ الكائن tzinfo القيمة None، فإنّ التابع يعيد القيمة ذاتها، وإلاّ فإنّه يعيد self.tzinfo.dst(None)‎‎، ويطلق التابع استثناءً إن لم تُعِد العبارة السابقة القيمة None أو كائن timedelta بفارق زمني لا يتجاوز اليوم الواحد. ملاحظة: في الإصدار 3.7 من بايثون، لم يعد مقدار الإزاحة عن نظام التوقيت الصيفي مقيّدًا بعدد صحيح من الدقائق. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from ...

تابع مساعد وظيفته تحويل الخيار المعطى في القسم المحدّد إلى عدد صحيح. البنية العامة getint(section, option, *, raw=False, vars=None[, fallback]) ‎المعاملات ‎راجع التابع get()‎ للمزيد من التفاصيل حول المعاملات raw و vars و fallback. القيمة المعادة يعيد التابع قيمة الخيار الذي يجلبه بعد تحويله إلى عدد صحيح. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import configparser >>> config = configparser.ConfigParser() >>> config.read('config.cfg') ['config.cfg'] >>> config.getint('topsecret.server.com', 'Port') 50022 انظر أيضًا التابع get()‎: يجلب التابع الخيار المحدّد من القسم المعطى. التابع getfloat()‎: تابع مساعد وظيفته تحويل ...

تحول الدالة متغيرات CGI من os.environ إلى سلاسل (bytes in unicode) النصية ضمن المعيار PEP 3333، وتعيد قاموسًا جديدًا. يستخدم المعالجان CGIHandler و IISCGIHandler هذه الدالة عوضًا عن استخدام os.environ مباشرة، والذي يمكن أن لا يكون متوافقًا مع معايير WSGI في جميع المنصات ومخدّمات الويب التي تستخدم الإصدار 3 من بايثون، وعلى وجه الخصوص الأنظمة التي تكون Unicode فيها هي البيئة الفعلية (مثل نظام ويندوز) أو الأنظمة التي تكون البيئة فيها هي البايتات ولكن بايثون لا تستخدم الترميز ISO-8859-1 لفكّ ...

يتمّ التابع عملية الضغط، ويعيد البيانات المضغوطة المتبقية في ذاكرة التخزين الداخلية internal buffer. البنية العامة flush() لا يمكن استخدام كائن compressor بعد استدعاء هذا التابع. مصادر صفحة Support for bzip2 compression في توثيق بايثون الرسمي.

هذا التابع غير معرّف في الصنف BaseHandler، ولكن يجب على الأصناف المتفرّعة منه أن تعرّف هذا التابع إن كان المطلوب التقاط جميع عناوين URL دون تحديد أيّ معالج مسجّل لفتح هذه العناوين. يُستدعى هذا التابع، في حال استخدامه، من قبل كائن OpenerDirector الأب. يُستدعى هذا التابع قبل أي تابع open خاصّ بالبروتوكول. البنية العامة BaseHandler.unknown_open(req) القيمة المعادة يجب أن تكون القيم المعادة مشابهة للقيم المعادة من التابع default_open()‎. مصادر صفحة Extensible library for opening URLs في توثيق بايثون الرسمي.

يعيد التابع كائن time يتضمّن نفس الساعة والدقيقة والثانية وأجزاء الثانية وfold في كائن datetime. البنية العامة ‎‎datetime.time() القيمة المعادة يعيد التابع كائن time يتضمّن نفس الساعة والدقيقة والثانية وأجزاء الثانية وحالة التوقيت المحلي (fold) في كائن datetime. يُعيد التابِع أيضًا المُعامِل tzinfo بالقيمة None. أمثلة يُبيّن المثال التالي آلية عمل التابع: ‎‎‎>>> from datetime import datetime >>> dt = datetime(2018, 6, 7, 22, 45, 6) >>> dt.time() datetime.time(22, 45, 6) >>> type(dt.time().tzinfo) <class 'NoneType'> انظر أيضًا التابع datetime.date()‎‎: يعيد التابع كائن date يتضمّن نفس ...

تعيد الدالة قائمة بكل الإشارات الضعيفة وكائنات الوسيط المرتبطة بالكائن المعطى. البنية العامة weakref.getweakrefcount(object) المعاملات object الكائن المراد معرفة الإشارات الضعيفة والوسائط المرتبطة به. القيمة المعادة تعيد الدالة قائمة بكل الإشارات الضعيفة وكائنات الوسيط المرتبطة بالكائن المعطى. مصادر صفحة Weak references في توثيق بايثون الرسمي.

يؤدّي استدعاء هذه الدالة إلى تولّي وحدة cgitb مسؤولية معالجة الاستثناءات عوضًا عن أداة المعالجة الافتراضية في مفسّر بايثون وذلك بتعيين قيمة للدالة sys.excepthook()‎. البنية العامة cgitb.enable(display=1, logdir=None, context=5, format="html") ‎المعاملات ‎display معامل اختياري، يأخذ القيمة الافتراضية 1، ويمكن أن يأخذ القيمة 0 وبذلك تُمنع الدالة من إرسال رسالة الخطأ إلى متصفّح الويب. logdir إن كان المعامل logdir موجودًا، فإنّ رسالة الخطأ ستُكتب إلى ملف، وقيمة هذا المعامل هو المجلّد الذي سيحتوي على هذه الملفات. context معامل اختياري، يحدّد عدد ...

يستبدل التابع القيم المعطاة في المعاملات بالقيم الأصلية في كائن datetime. البنية العامة datetime.replace(year=self.year, month=self.month, day=self.day, hour=self.hour, minute=self.minute, second=self.second, microsecond=self.microsecond, tzinfo=self.tzinfo, * fold=0) المعاملات يأخذ التابع مجموعة من المعاملات المفتاحية هي year و month و day و hour و minute و second و microsecond (السنة والشهر واليوم والساعة والدقيقة والثانية وأجزاء الثانية). إضافة إلى المعاملين tzinfo و fold. تحلّ القيمة المحدّدة لأيّ من هذه المعاملات محلّ القيمة المقابلة في كائن datetime. تأخذ هذه المعاملات قيمًا افتراضية تساوي القيم المحدّدة في ...

تعيد موقع الإدراج الذي يأتي بعد (إلى الجانب الأيمن) العناصر المماثلة للعنصر المضاف في المصفوفة المعطاة. البنية العامة bisect.bisect(a, x, lo=0, hi=len(a)) المعاملات يمكن استخدام المعاملين lo و hi لتحديد جزء من القائمة، ولكن السلوك الافتراضي لهذه الدالة هو التعامل مع القائمة بأكملها. إن كان العنصر x موجودًا من قبل في القائمة a، فإنّ موقع الإدراج سيكون بعد (إلى يمين) العناصر الموجودة أصلًا. يمكن استخدام القيمة المعادة كأول معامل في التابع list.insert()‎ على افتراض أنّ القائمة a مفروزة أصلًا. القيمة ...

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

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

تدرج العنصر المحدّد في المصفوفة المعطاة بعد العناصر المماثلة للعنصر المعطى والموجودة أصلًا في المصفوفة. البنية العامة bisect.insort(a, x, lo=0, hi=len(a)) المعاملات يمكن استخدام المعاملين lo و hi لتحديد جزء من القائمة، ولكن السلوك الافتراضي لهذه الدالة هو التعامل مع القائمة بأكملها. هذه الدالة مشابهة في عملها للدالة insort_left()‎ ولكنّها تدرج العنصر x في المصفوفة a بعد العناصر المماثلة للعنصر x والموجودة أصلًا في المصفوفة. أمثلة يبين المثال التالي آلية عمل التابع: >>> import bisect >>> l = [1, 3, 4, ...

يعيد التابع العضو التالي في الأرشيف على هيئة كائن TarInfo وذلك عند فتح كائن TarFile للقراءة. البنية العامة TarFile.next() القيمة المعادة يعيد التابع العضو التالي في الأرشيف على هيئة كائن TarInfo وذلك عند فتح كائن TarFile للقراءة. ويعيد التابع القيمة None إن لم يتوفّر المزيد من الأعضاء. أمثلة يبين المثال التالي آلية عمل التابع: >>> import tarfile >>> tar = tarfile.open('files.tar', 'r') >>> tar.next() <TarInfo 'file1.txt' at 0x7f486610b110> >>> tar.next() <TarInfo 'file2.html' at 0x7f486610b2a0> >>> tar.next() <TarInfo 'file3.py' at 0x7f486610b048> >>> tar.next() >>> print(tar.next()) None انظر أيضًا التابع TarFile.getmember()‎: يعيد ...

تعيد الدالة قائمة باللهجات المسجّلة. البنية العامة csv.list_dialects()‎ ‎ القيمة المعادة تعيد الدالة قائمة باللهجات المسجّلة. أمثلة يبين المثال التالي آلية عمل الدالة: >>> import csv >>> csv.list_dialects() ['excel', 'excel-tab', 'unix'] انظر أيضًا الدالة csv.register_dialect()‎: تربط الدالة اللهجة المعطاة بالاسم المحدّد.. الدالة csv.unregister_dialect()‎: تحذف الدالة اللهجة المرتبطة بالاسم المعطى من سجلّ اللهجات. الدالة csv.get_dialect()‎: تعيد الدالة اللهجة المرتبطة بالاسم المعطى. الصنف Dialect. مصادر صفحة CSV File Reading and Writing في توثيق بايثون الرسمي.

يلحق التابع عناصر القائمة المعطاة بالمصفوفة. يؤدي هذا التابع نفس عمل التعبير for x in list: a.append(x)‎ باستثناء أنّه في حال وجود خطأ في النوع فإنّ المصفوفة لن تتغير. البنية العامة ‎array.fromlist(list) المعاملات list القائمة المراد إلحاقها بنهاية المصفوفة. القيمة المعادة يعيد التابع القيمة None. أمثلة يبين المثال التالي آلية عمل التابع: >>> import array >>> l1 = [1, 2, 3, 4, 5] >>> a1 = array.array('l') >>> a1.fromlist(l1) >>> a1 array('l', [1, 2, 3, 4, 5]) انظر أيضًا التابع array.frombytes()‎: يلحق التابع عناصر السلسلة ...

تعيد الدالة كائن كتابة وظيفته تحويل بيانات المستخدم إلى سلاسل نصية مفصولة عن بعضها البعض وكتابتها في الكائن المعطى وهو كائن شبيه بالملفات، ويمكن كذلك استخدام أيّ كائن يمتلك التابع write()‎. إن كانت قيمة هذا المعامل كائن ملف، فيجب أن يكون مفتوحًا مع المعامل newline=''‎. ملاحظة: إن لم تحدد القيمة newline=''‎ لن تُفسّر الأسطر الجديدة في الحقول المحاطة بعلامات اقتباس بطريقة صحيحة، وسيضاف رمز ‎\r إضافي إلى الأسطر المنتهية بالرمز ‎\r\n في المنصّات التي تستخدم الرمز الأخير في نهايات الأسطر. ...

يحذف التابع أول ظهور للقيمة المعطاة من المصفوفة. البنية العامة ‎array.remove(x) المعاملات x القيمة المراد حذفها من المصفوفة. القيمة المعادة يعيد التابع القيمة None. أمثلة يبين المثال التالي آلية عمل التابع: >>> import array >>> a1 = array.array('l', [1, 2, 3, 4, 5]) >>> a1.remove(3) انظر أيضًا التابع array.append()‎: يضيف التابع عنصرًا جديدًا يحمل القيمة المعطاة إلى نهاية المصفوفة. التابع array.extend()‎: يلحق التابع عناصر كائن التكرار المعطى إلى نهاية المصفوفة. التابع array.insert()‎: يدرج التابع عنصرًا جديدًا يحمل القيمة المعطاة في المصفوفة قبل ...

يعيد التابع التمثيل المنسّق للكائن المعطى على هيئة سلسلة نصية. ويأخذ هذا التابع بنظر الاعتبار المعاملات الممرّرة إلى الدالة البانية للصنف PrettyPrinter. البنية العامة PrettyPrinter.pformat(object) المعاملات object الكائن المراد طباعته. القيمة المعادة يعيد التابع التمثيل المنسّق للكائن المعطى على هيئة سلسلة نصية. أمثلة يبين المثال التالي آلية عمل الدالة: >>> import pprint >>> stuff = ['spam', 'eggs', 'lumberjack', 'knights', 'ni'] >>> stuff.insert(0, stuff[:]) >>> pp = pprint.PrettyPrinter(indent=4) >>> pp.pformat(stuff) "[ ['spam', 'eggs', 'lumberjack', 'knights', 'ni'],\n 'spam',\n 'eggs',\n ...

يحدّد التابع ما إذا كان التمثيل المنسّق للكائن المعطى "قابلًا للقراءة" أو يمكن استخدامه لإعادة بناء القيمة باستخدام الدالة eval()‎. البنية العامة PrettyPrinter.isreadable(object) المعاملات object الكائن المراد معرفة ما إذا كان قابلًا للقراءة أو يمكن استخدامه لإعادة بناء القيمة باستخدام الدالة eval()‎. القيمة المعادة يعيد التابع القيمة False دائمًا مع الكائنات التعاودية. إن عُيّنت قيمة للمعامل depth في كائن PrettyPrinter وكان الكائن أعمق ممّا هو مسموح به، فسيعيد التابع القيمة False. أمثلة يبين المثال التالي آلية عمل الدالة: >>> import ...

تفتح الدالة عنوان URL المعطى. البنية العامة urllib.request.urlopen(url, data=None, [timeout, ]*, cafile=None, capath=None, cadefault=False, context=None) ‎المعاملات ‎url سلسلة نصية أو كائن Request، ويتضمّن عنوان URL الذي ستفتحه الدالة. data يجب أن تكون قيمة هذا المعامل كائنًا يحدّد البيانات الإضافية التي ستُرسل إلى المخدّم، أو يأخذ المعامل القيمة None إن لم تكن هناك حاجة لمثل هذه البيانات. (راجع كائنات Request للمزيد من التفاصيل). تستخدم وحدة urllib.request البروتوكول HTTP/1.1 وتُدرج الترويسة Connection:close في طلبات HTTP الخاصّة بها. timeout معامل اختياري يحدّد الفترة ...

صنف متفرّع من الصنف Sh4elf ويقدّم التوابع first()‎ و next()‎ و previous()‎ و last()‎ و set_location()‎ وهي متوفّرة في الوحدة bsddb من pybsddb ولكن ليس في وحدات قواعد البيانات الأخرى. البنية العامة class shelve.BsdDbShelf(dict, protocol=None, writeback=False, keyencoding='utf-8') المعاملات dict يجب أن يدعم كائن dict الممرّر في الدالة البانية هذه التوابع، ويتحقّق ذلك -عامّةً- باستدعاء أحد التوابع bsddbp.hashopen()‎ أو bsddb.btopen()‎ أو bsddb.rnopen()‎. تحمل المعاملات الاختيارية protocol و writeback و keyencoding المعاني نفسها التي تحملها في الصنف Shelf. انظر أيضًا الصنف shelve.Shelf: ...

تعيد الدالة ترويسة تتضمن أسماء أيام الأسبوع بصيغة مختصرة. البنية العامة 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) ' ...

يمدّد الجانب الأيمن من كائن deque بإضافة العناصر المعطاة. البنية العامة d.extend(iterable) المعاملات iterable كائن مكرِّر تضاف عناصره إلى كائن deque. القيمة المعادة يعيد التابع كائن deque جديد يمثّل نسخة سطحية عن كائن dequeالأصلي. أمثلة يبين المثال التالي آلية عمل التابع. >>> from collections import deque >>> d = deque('ghi') >>> d.extend('jkl') >>> d deque(['g', 'h', 'i', 'j', 'k', 'l']) انظر أيضًا التابع extendleft()‎:  :يمدّد الجانب الأيسر من كائن deque بإضافة العناصر المعطاة. التابع append()‎:  :يضيف التابع العنصر المعطى إلى الجانب الأيمن من كائن ...

ينسّق التابع التاريخ والوقت باستخدام سلسلة التنسيق النصية المعطاة. البنية العامة ‎datetime.strftime(format) المعاملات format سلسلة التنسيق النصية التي يستخدمها التابع لتنسيق السلسلة النصية المعادة. راجع قسم (التابعان strftime()‎ و strptime()‎ ). القيمة المعادة يعيد التابع سلسلة نصية تمثّل الوقت والتاريخ، ويمكن التحكّم بطريقة التمثيل هذه باستخدام سلسلة تنسيق نصية. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import date >>> dt = datetime(2018, 7, 8, 23, 9, 19) >>> dt.strftime("%d/%m/%y") '08/07/18' >>> dt.strftime("%d %b, %Y") '08 Jul, 2018' >>> dt.strftime("%d %b, %Y - %H:%M:%S") '08 ...

صنف ربط ينشئ إشارات ضعيفة إلى القيم. يجري تجاهل عناصر القاموس عند عدم وجود إشارات قوية إلى القيم. البنية العامة weakref.WeakKeyDictionary([dict]) المعاملات dict القاموس الذي سينشئ هذا الصنف إشارات ضعيفة إلى قيمه. تنبيه: لما كان WeakValueDictionary مبنيًا على قواميس بايثون، فيجب أن لا يتغير حجمه عند المرور على عناصره، وهذا الأمر قد يصبح صعبًا مع WeakValueDictionary لأنّ الأحداث التي تُنفّذ بواسطة البرنامج أثناء عملية المرور على العناصر قد تتسبّب في اختفاء العناصر من القاموس (كتأثير جانبي لمجموعة garbage). التابع valuerefs()‎ ...

يعيد التابع كائن Request أو القيمة None استجابةً لعملية إعادة توجيه. البنية العامة HTTPRedirectHandler.redirect_request(req, fp, code, msg, hdrs, newurl) يُستدعى التابع عند استخدام التوابع http_error_30*()‎ بالطريقة الافتراضية عند استقبال عملية إعادة توجيه من المخدّم. إن أجريت عملية إعادة التوجيه، فإنّ التابع سيعيد كائن Request جديدًا وذلك للسماح لتوابع http_error_30*()‎ بإعادة التوجيه إلى العنوان الجديد newurl. إن لم يحدث ما سبق فحاول إطلاق الاستثناء HTTPError إن لم يُعالج هذا العنوان من قبل أيّ معالج آخر، أو أعد القيمة None إن لم تتمكن ...

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

يحذف التابع ويعيد عنصرًا واحدًا من الجانب الأيمن في الكائن deque. البنية العامة d.pop() القيمة المعادة يعيد التابع العنصر المحذوف من كائن deque. وفي حال عدم وجود أي عنصر، يطلق التابع الخطأ IndexError. أمثلة يبين المثال التالي آلية عمل التابع. >>> from collections import deque >>> d = deque(['a', 'b', 'c', 'd', 'e', 'f']) >>> d.pop() 'f' >>> d deque(['a', 'b', 'c', 'd', 'e']) >>> d.pop() 'e' >>> d deque(['a', 'b', 'c', 'd']) انظر أيضًا التابع popleft()‎:  :يحذف التابع ويعيد عنصرًا واحدًا من الجانب الأيسر في الكائن deque. التابع ...

يبحث التابع عن الملفات ذات الامتداد ‎*.py ويضيف الملف المقابل إلى الأرشيف. إن لم تتوفر قيمة للمعامل optimize في الدالة البانية للصنف PyZipFile أو أعطيت القيمة ‎-1، فإنّ الملف المقابل يكون من الامتداد ‎*.pyc ويجري تصريفه إن دعت الحاجة إلى ذلك. أما إن أعطيت إحدى القيم 0 أو 1 أو 2 فستضاف الملفات التي تمتلك مستويات التحسين هذه فقط (راجع الدالة compile()‎) إلى الأرشيف، وستُصرّف إن دعت الحاجة إلى ذلك. البنية العامة writepy(pathname, basename='', filterfunc=None) ‎المعاملات ‎pathname إن كانت قيمة ...

ينسّق التابع الوقت باستخدام سلسلة التنسيق النصية المعطاة. البنية العامة ‎time.strftime(format) المعاملات format سلسلة التنسيق النصية التي يستخدمها التابع لتنسيق السلسلة النصية المعادة. راجع قسم (التابعان strftime()‎ و strptime()‎ ). القيمة المعادة يعيد التابع سلسلة نصية تمثّل الوقت، ويمكن التحكّم بطريقة التمثيل هذه باستخدام سلسلة تنسيق نصية. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import time >>> t = time(12, 10, 30) >>> t.strftime("%H:%M:%S") '12:10:30' انظر أيضًا التابعان strftime()‎ و strptime()‎ . التابع time.__format__()‎: يسمح هذا التابع بتعيين سلسلسة تنسيق ...

تدعم كائنات Headers العمليات الخاصة بالقواميس مثل ‎__getitem__()‎ و get()‎ و ‎__setitem__()‎ و setdefault()‎ و ‎__delitem__()‎ و ‎__contains__()‎. يكون المفتاح في كل هذه العمليات هو اسم الترويسة (ليست حساسة لحالة الأحرف) وتكون القيمة هي أول قيمة مرتبطة باسم الترويسة ذاك. يؤدي تعيين ترويسة إلى حذف أي قيمة موجودة في تلك الترويسة، ثم تضاف القمية الجديدة إلى نهاية قائمة الترويسات. تضاف الترويسات الجديدة إلى نهاية القائمة وبذلك يتم المحافظة على ترتيب الترويسات الموجودة أصلًا. تختلف كائنات Headers عن القواميس في أنّها ...

يعيد التابع صفًّا يضمّ ثلاثة عناصر هي (ISO year, ISO week number, ISO weekday). البنية العامة ‎datetime.isocalendar() القيمة المعادة يعيد التابع صفًّا يضمّ ثلاثة عناصر هي (ISO year, ISO week number, ISO weekday). وهي نفس القيمة المعادة من التابع self.date().isocalendar()‎‎. أمثلة يبين المثال التالي آلية عمل التابع: ‎>>> from datetime import datetime >>> dt = datetime(2018, 6, 26, 20, 55) >>> dt.isocalendar() (2018, 26, 2) انظر أيضًا التابع datetime.isoweekday()‎: يعيد التابع اليوم في الأسبوع على هيئة عدد صحيح، حيث يأخذ يوم الاثنين الرقم ...

تنسّق الدالة المجلّد الحالي بصيغة HTML. البنية العامة cgi.print_directory() ‎انظر أيضًا الدالة cgi.print_environ()‎: تنسّق الدالة بيئة الصدفة بصيغة HTML. الدالة cgi.print_form()‎: تنسّق الدالة النموذج بصيغة HTML. الدالة cgi.print_environ_usage()‎: تطبع الدالة قائمة من متغيرات البيئة المفيدة (المستخدمة من قبل CGI) بصيغة HTML. مصادر صفحة Common Gateway Interface support في توثيق بايثون الرسمي.

يضيف التابع العنصر المعطى إلى الجانب الأيمن من كائن deque. البنية العامة d.‎append(x) المعاملات x العنصر المراد إضافته إلى الجانب الأيمن من كائن deque. أمثلة يبين المثال التالي آلية عمل التابع: >>> from collections import deque >>> d = deque('ghi') >>> d.append('j') >>> d deque(['g', 'h', 'i', 'j']) انظر أيضًا التابع appendleft()‎:  :يضيف التابع العنصر المعطى إلى الجانب الأيسر من كائن deque. مصادر قسم deque Objects في صفحة Container Datatypes في توثيق بايثون الرسمي.

يعيد التابع كائن تكرار 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()‎: يعيد التابع كائن تكرار للشهر المعطى في السنة المعطاة. التابع ...

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

الصنف timezone هو صنف فرعي من الصنف tzinfo، وتمثّل كل نسخة من منه منطقة زمنية محدّدة بمقدار إزاحة ثابت عن التوقيت العالمي المنسّق. يجب الانتباه إلى أنه لا يمكن استخدام كائنات هذا الصنف لتمثيل معلومات المناطق الزمنية في المواقع التي تستخدم فيها مقادير إزاحة مختلفة خلال السنة، أو المناطق التي حدث فيها تغييرات تاريخية على الأوقات المدنية. البنية العامة class datetime.timezone(offset, name=None) المعاملات offset كائن timedelta يمثّل الفارق بين التوقيت المحلي والتوقيت العالمي المنسّق، ويجب أن يأخذ قيمة تكون ضمن ...

يستند هذا المعالج على sys.stdin و sys.stdout و sys.stderr و os.environ. يمكن الاستفادة من هذا الصنف عند الحاجة إلى تشغيل تطبيق WSGI كشيفرة CGI، حيث يمكن ببساطة تنفيذ التعبير CGIHandler().run(app)‎، إذ يمثل المعامل app كائن تطبيق WSGI الذي ترغب في تنفيذه. يتفرّع هذا الصنف من الصنف BaseCGIHandler والذي يعين القيمة True للمتغير wsgi.run_once والقيمة False للمتغير wsgi.multithreadto، والقيمة True للمتغير wsgi.multiprocess ويستخدم الوحدتين sys و os دائمًا للحصول على تدفقات وبيئة CGI التي يحتاج إليها في عمله. انظر أيضًا الصنف ...

الدالة البانية للصنف GzipFile، والذي يقدّم محاكاة لمعظم توابع كائن الملف باستثناء التابع truncate()‎. البنية العامة gzip.GzipFile(filename=None, mode=None, compresslevel=9, fileobj=None, mtime=None) المعاملات filename و fileobj يجب أن يأخذ أحد المعاملين fileobj و filename على الأقل قيمة غير بسيطة non-trivial value. تستند النسخة الجديدة من الصنف على الكائن fileobj، والذي يمكن أن يكون ملفًّا عاديًا، أو كائن io.BytesIO أو اي كائن آخر يحاكي الملفات. يأخذ هذا المعامل القيمة None، وفي مثل هذه الحالة يُفتح filename لتوفير كائن ملف. عندما لا تكون ...

هذا التابع غير معرّف في الصنف BaseHandler، ولكن يجب على الأصناف المتفرّعة منه أن تعيد تعريفه إن كانت معدّة لالتقاط جميع أخطاء HTTP غير المعالجة. يُستدعى هذا التابع تلقائيًا بواسطة كائن OpenerDirector الذي يتلقّى الخطأ، ويجب عدم استدعائه في الظروف الأخرى. يُستدعى هذا التابع، في حال استخدامه، من قبل كائن OpenerDirector الأب. يُستدعى هذا التابع قبل أي تابع open خاصّ بالبروتوكول. البنية العامة BaseHandler.http_error_default(req, fp, code, msg, hdrs) المعاملات req سيكون كائن Request. fp سيكون كائنًا شبيهًا بالملفات مع متن ...