نتائج البحث

المشكلة يستخدم العديد من العملاء نفس الجزء من واجهة الصنف. حالة أخرى: عندما يوجد نفس الجزء من الواجهة في صنفين. الحل نقل هذا الجزء المتطابق إلى الواجهة الخاصة به. مثال قبل إعادة التصميم استخدام التابعين ()getRate و ()hasSpecialSkill في الصنف Employee بكثرة: يستخدم العديد من العملاء نفس الجزء من واجهة الصنف. بعد إعادة التصميم استخراج هذين التابعين إلى واجهة خاصة بهما تدعى Billable: تقل هذا الجزء المتطابق إلى الواجهة الخاصة به. لم إعادة التصميم؟ تكون الواجهات مناسبة جدًا عندما تلعب ...

الخاصية الوصف caret-color تُحدِّد ما هو لون مؤشر الإدخال النصي (وهي الإشارة التي تظهر للإشارة إلى موضع الحرف النصي الذي سيدخله المستخدم) ضمن عنصر مثل <input> أو أي عنصر آخر له الخاصية contenteditable. الشكل الافتراضي لمؤشر الإدخال هو خطٌ رأسيٌ يومض لتسهيل ملاحظته، ويكون لونه الافتراضي هو الأسود، لكن يمكن تعديله باستخدام هذه الخاصية. cursor تُحدِّد ما هو شكل مؤشر الفأرة الذي سيُعرَض عندما تمر الفأرة فوق العنصر. outline الخاصية outline في CSS هي خاصية مختصرة تُستخدَم لضبط خاصية أو أكثر من الخاصيات outline-style و outline-width و outline-color في آنٍ واحد. ...

توصيف المشكلة التطابق بالمهام (function) ما بين صنفين (classes) ولكن بأسماءٍ مختلفةٍ لتوابعهما (methods). أسبابها عدم دراية المبرمج بوجود صنفٍ آخر يكافِئ بمهامّه مهامّ الصنف الحالي الذي ينشِئه. وما الحل؟ حذف أحد الصنفين بعد تنفيذ إحدى الحلول الآتية: إعادة تسمية التوابع (methods) لتصبح متطابقةً بكافّة الأصناف البديلة (alternative) (أي الأصناف المتكافئة بالمهام). توحيد التوقيع (signature) وتعريف الاستخدام ما بين التوابع، وذلك إمّا بنقل التابع (move method) أو إضافة المعاملات (add parameters) أو دمج التوابع عبر المعاملات (parameterize method). إن كان ...

يضيف التابع قسمًا يحمل الاسم المعطى إلى نسخة الصنف ConfigParser. البنية العامة add_section(section) ‎المعاملات section سلسلة نصية تتضمن اسم القسم المراد إضافته إلى نسخة الصنف ConfigParser. القيمة المعادة إن كان هناك قسم يحمل الاسم ذاته فإنّ التابع يطلق الاستثناء DuplicateSectionError. وإن كان الاسم المعطى مطابقًا لاسم قسم الإعدادات الافتراضية فإنّ التابع يطلق الاستثناء ValueError. يجب أن يكون الاسم المعطى سلسلة نصية وإلّا فإنّ التابع يطلق الاستثناء TypeError. ملاحظة: يطلق التابع الاستثناء TypeError عند استخدام الأسماء غير النصية في الإصدار 3.2 ...

مقدّمة تركيز التحقق من الأنواع (type-checking) على شكل (shape) القيم من مبادئ TypeScript الأساسية. يُصطلَح عليه أحيانًا بالتعبير duck typing أو التحقق من الأنواع الفرعيّة هيكليًّا (structural subtyping). تعمل الواجهات في TypeScript على تسمية هذه الأنواع، وهي طريقة قويّة لتعريف عقود (contracts) داخل شيفرتك أو عقود مع شيفرةٍ خارج مشروعك. واجهة بسيطة لنبدأ بمثال بسيط لنفهم كيفيّة عمل الواجهات: function printLabel(labelledObj: { label: string }) { console.log(labelledObj.label); } let myObj = {size: 10, label: "Size 10 Object"}; printLabel(myObj); سيتحقّق مدقّق ...

مقدمة تصِف بعض المبادئ الفريدة الموجودة في لغة TypeScript شكل كائنات JavaScript على مستوى الأنواع. مبدأ دمج التصريحات (declaration merging) من المزايا التي تنفرد بها TypeScript. سيُساعد فهم هذا المبدأ على العمل مع شيفرة JavaScript الموجودة مسبقًا. إضافة إلى أنّها توفّر قدرة على إعمال مبادئ تجريد (abstraction concepts) أكثر تقدّمًا. نعني بدمج التصريحات في هذه الصفحة بأنّ المترجم يدمج تصريحين مختلفين لهما نفس الاسم في تعريف واحد. يمتلك هذا التعريف المندمج مزايا التصريحين الأصليّين. يُمكن دمج أي عدد من التصريحات، ...

هي الواجهة الأساسيّة التي يُعرَّف استخدامها (implemented) ضمنيًا في جميع واجهات التوصيفات (annotation interfaces)، وللمزيد من التفاصيل راجع التوصيفات (annotations) في لغة Kotlin. interface Annotation الدوال المورثة (Inherited Functions) equals تتحقق الدالة equals()‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معه. hashCode تعيد الدالة hashCode()‎ الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. toString تحول الدالة toString()‎ الكائن الذي يُستدعى معه إلى سلسلة نصية (String). الخاصيات الإضافية (Extension Properties) annotationClass تُستخدَم هذه الخاصيّة للحصول على نسخةٍ (instance) من الصنف KClass بحسب نوع التوصيف الحاليّ. ...

تتيح واجهات الكائنات إنشاء شيفرة تحدّد التوابع التي يجب أن يتضمّنها الصنف دون الحاجة إلى تعريف آلية التحكّم في هذه التوابع. تعرّف الواجهات بنفس طريقة تعريف الأصناف، ولكن باستخدام الكلمة المفتاحية interface بدل الكلمة المفتاحية class ودون تعريف محتوى أيّ تابعٍ في الواجهة. يجب أن تكون جميع التوابع المصرّح عنها في الواجهة من النوع public وهذه هي طبيعة الواجهة. يمكن التصريح عن تابع بانٍ في الواجهة، وهو أمر مفيد في بعض الحالات، كاستخدام التابع من قبل المعامل factories. العامل implements ...

تتيح واجهات الكائنات إنشاء شيفرة تحدّد التوابع التي يجب أن يتضمّنها الصنف دون الحاجة إلى تعريف آلية التحكّم في هذه التوابع. تعرّف الواجهات بنفس طريقة تعريف الأصناف، ولكن باستخدام الكلمة المفتاحية interface بدل الكلمة المفتاحية class ودون تعريف محتوى أيّ تابعٍ في الواجهة. يجب أن تكون جميع التوابع المصرّح عنها في الواجهة من النوع public وهذه هي طبيعة الواجهة. يمكن التصريح عن تابع بانٍ في الواجهة، وهو أمر مفيد في بعض الحالات، كاستخدام التابع من قبل المعامل factories. العامل implements ...

توصيف المشكلة احتواء الصنف (class) العديدَ من الحقول (fields) والتوابع (methods) وشيفرةً بأسطرَ كثيرةٍ. أسبابها تبدأ الأصناف صغيرةً ليزداد حجمها مع استمرار تطوُّر البرنامج (كما الحال بالتوابع الطويلة) لأنَّ المبرمج يرى أنَّ إضافة ميِّزاتٍ (features) جديدةٍ في صنفٍ موجودٍ مسبقًا أكثر سهولةً من إنشاء أصنافٍ جديدةٍ مخصَّصةٍ لها. وما الحل؟ الحل بسيطٌ جدًا؛ وهو تقسيم الصنف، وذلك بإحدى الوسائل الآتية: إنشاء صنفٍ جديدٍ (Extract Class) إن كان من الممكن فصلُ بعض مهامّ الصنف الحاليّ ونقلها للصنف الجديد. إنشاء صنفٍ فرعيٍّ ...

التعمق في نظرية ملفّات التعريف (Definition File Theory) هيكلة الوحدات لتحمل نفس شكل الواجهة البرمجية (API) الذي تريده بالضبطِ صعبٌ نوعًا ما. على سبيل المثال، قد نرغب من وحدةٍ قد تُستدعى بالكلمة المفتاحية ‎new‎ أو بدونها أن تنتج أنواعًا مختلفة، مع امتلاك عدّة أنواعٍ مسمّاةٍ موجودة في تسلسلٍ ما، وبعض الخاصيات على كائن الوحدة كذلك. عبر قراءة هذا الدليل، ستحصل على الأدوات اللازمة لكتابة ملفّات تعريفات معقّدة ذات واجهة برمجيّة سهلة الاستخدام. يركّز هذا الدليل على مكتبات الوحدات أو مكتبات ...

مقدمة JSX بنيةٌ (syntax) مشابهةٌ للغة XML يُمكن تضمينها وتحويلها إلى شيفرة JavaScript صالحة، لكن آلية عملية التحويل تختلف من تطبيق (implementation) إلى آخر. اشتهرت JSX باستخدامها مع مكتبة React، لكنها تملك تطبيقات أخرى غير React. تدعم لغة TypeScript تضمين JSX، وتدقيق الأنواع فيها، وكذا ترجمة JSX إلى JavaScript مباشرةً. ملاحظة حول المصطلحات: نستخدم في هذه الصّفحة كلمة "صِفَة" للإشارة إلى الكلمة الإنجليزيّة "attribute" وكلمة "خاصيّة" للإشارة إلى كلمة "property"، كلاهما يُترجَم إلى كلمة "خاصيّة" ولهما نفس المعنى في معظم ...

مقدمة الهدف من هذا الدليل هو تعليمك كيفيّة كتابة ملف تعريف عالي الجودة. هذا الدليل يريك أولًا توثيق واجهة برمجية (API) معيّنة مع طريقة استعمالها، ثم يشرح كيفية كتابة التصريح الملائم. هذه الأمثلة مرتبة تصاعديا حسب التعقيد، من الأبسط إلى الأعقد: المتغيرات العامة (Global Variables). الدوال العامة (Global Functions). الكائنات ذات الخاصيات. الدوال ذات الأحمال الزائدة (Overloaded Functions). الأنواع القابلة لإعادة الاستخدام (الواجهات). الأنواع القابلة لإعادة الاستخدام (أسماء الأنواع البديلة [Type Aliases]). تنظيم الأنواع. الأصناف. الأمثلة المتغيرات العامة التوثيق: يحتوي ...

تقدّم وحدة dbm.ndbm واجهة برمجية لمكتبة ‎"(n)dbm"‎ في يونكس. تسلك كائنات dbm سلوك كائنات الربط (القواميس) باستثناء أنّ المفاتيح والقيم تخزّن دائمًا كبايتات. لا تؤدي طباعة كائنات dbm إلى طباعة المفاتيح والقيم، ولا تدعم هذه الكائنات التابعين items()‎ و values()‎. يمكن استخدام هذه الوحدة مع واجهة ndbm الكلاسيكية أو مع واجهة GNU GDBM التوافقية. ستحاول شيفرة configure في يونكس أن تحدد موقع ملف الترويسة header file المناسب لتبسيط عملية بناء هذه الوحدة. الاستثناءات الاستثناء dbm.ndbm.error يطلق هذا الاستثناء عند حدوث ...

يلغي التابع جميع التعديلات التي أجريت على قاعدة البيانات بعد آخر استدعاء للتابع commit()‎. البنية العامة rollback() مصادر صفحة DB-API 2.0 interface for SQLite databases في توثيق بايثون الرسمي.

الأنواع العامة ‎Number‎، و‎String‎، و‎Boolean‎، و‎Object‎ لا تستعمل أبدًا الأنواع ‎Number‎، و‎String‎، و‎Boolean‎، و‎Object‎. هذه الأنواع تشير إلى الكائنات غير الأوليّة المحاطة (non-primitive boxed objects) التي لا تُستعمَل في أغلب الأحيان بطريقة صحيحة في شيفرة JavaScript: /* خطأ */ function reverse(s: String): String; استعمل بدلًا منها الأنواع ‎number‎، و‎string‎، و‎boolean‎: /* صحيح */ function reverse(s: string): string; استعمل النوع غير الأولي ‎object‎ (الذي أُضِيفَ في TypeScript 2.2) عوضًا عن النوع ‎Object‎. الأنواع المعممة (Generics) لا تُعرِّف أبدًا نوعًا معمّمًا لا يستخدم معامل ...

سكربت اختبار CGI، يمكن استخدامه كبرنامج رئيسي. تكتب الدالة ترويسة HTTP مصغّرة وتنسّق جميع المعلومات المقدّمة إلى السكربت في نموذج HTML. البنية العامة cgi.test() مصادر صفحة Common Gateway Interface support في توثيق بايثون الرسمي.

يمكن استدعاء هذا التابع من خيط آخر لتجاهل أي استعلامات قد تكون قيد التنفيذ عبر الاتصال الحالي. سيتم تجاهل الاستعلام وسيتلقى صاحب الاستعلام استثناءً. البنية العامة interrupt() مصادر صفحة DB-API 2.0 interface for SQLite databases في توثيق بايثون الرسمي.

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

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

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

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

يكتب التابع تمثيلًا مُسلسَلًا للكائن المُعطى في كائن الملف المفتوح والمحدّد في الدالة البانية للصنف. البنية العامة dump(obj) ‎المعاملات obj الكائن المراد كتابة تمثيله المسَلسَل في الملف المفتوح. أمثلة يبين المثال التالي طريقة استخدام التابع: >>> import pickle >>> data = [1, 2.0, 4, 4+2j] >>> f = open('file1.dat', 'wb') >>> mypickler = pickle.Pickler(f, pickle.HIGHEST_PROTOCOL) >>> mypickler.dump(data) مصادر صفحة DB-API 2.0 interface for SQLite databases في توثيق بايثون الرسمي.

يعيد التابع نسخة من صنف Cursor أو أحد أصنافه الفرعية. البنية العامة cursor(factory=Cursor) ‎المعاملات factory يأخذ هذا التابع معاملًا اختياريًا واحدًا، وعند تعيينه يجب أن يكون كائنًا قابلًا للاستدعاء callable يعيد نسخة من صنف Cursor أو أحد أصنافه الفرعية. القيمة المعادة يعيد التابع نسخة من صنف Cursor أو أحد أصنافه الفرعية. أمثلة يبين المثال التالي آلية عمل التابع: import sqlite3 conn = sqlite3.connect('example.db') c = conn.cursor() مصادر صفحة DB-API 2.0 interface for SQLite databases في توثيق بايثون الرسمي.

يعيد التابع نسخة من صنف Cursor أو أحد أصنافه الفرعية. البنية العامة cursor(factory=Cursor) ‎المعاملات factory يأخذ هذا التابع معاملًا اختياريًا واحدًا، وعند تعيينه يجب أن يكون كائنًا قابلًا للاستدعاء callable يعيد نسخة من صنف Cursor أو أحد أصنافه الفرعية. القيمة المعادة يعيد التابع نسخة من صنف Cursor أو أحد أصنافه الفرعية. أمثلة يبين المثال التالي آلية عمل التابع: import sqlite3 conn = sqlite3.connect('example.db') c = conn.cursor() مصادر صفحة DB-API 2.0 interface for SQLite databases في توثيق بايثون الرسمي.

تحاول هذه الدالة تخمين الوحدة التي يجب استخدامها لفتح الملف المعطى من بين وحدات قواعد البيانات المتعددة (dbm.gnu أو dbm.ndbm أو dbm.dumb). البنية العامة dbm.whichdb(filename) ‎المعاملات filename اسم ملف قاعدة البيانات. القيمة المعادة تعيد الدالة إحدى القيم التالية: None إن لم يكن بمقدور الدالة فتح الملف لكونه غير قابل للقراءة أو لعدم وجوده أصلًا. سلسلة نصية فارغة ("") إن لم تتمكن الدالة من تخمين صيغة الملف. سلسلة نصية تتضمن اسم الوحدة المطلوبة، مثل: 'dbm.dbm' أو 'dbm.gnu'. مصادر صفحة Interfaces to ...

التصريح عن التوصيف (Annotation Declaration) تُعدُّ التوصيفات إحدى الوسائل لإضافة بياناتٍ توصيفيّةٍ (metadata) إلى الشيفرة، وللتصريح عن التوصيف يُضاف المُحدِّد annotation قبل اسم الصنف، مثل: annotation class Fancy وقد تُحدَّد بعض خواصّ التوصيفات (annotation attributes) باستخدام التوصيفات الآتية (meta-annotations) لتوصيفات الصنف: ‎@Target لتحديد نوع العناصر التي يمكن توصيفها مثل الأصناف (classes) والدوال (functions) والخاصّيّات (properties) والتعابير (expressions) و... إلخ. ‎@Retention لتحديد فيما إن كان التوصيف مُخزَّنًا في ملفات الأصناف المُترجَمة، أو مرئيًا عبر انعكاسٍ (reflection) أثناء التنفيذ (runtime) (وكلاهما محقُّق بالحالة ...

مقدمة توافقيّة الأنواع في TypeScript مبنيّةٌ على التحقق من الأنواع الفرعيّة هيكليًّا (structural subtyping). والتحقّق من الأنواع هيكليًّا طريقةٌ للربط بين الأنواع حسب عناصرها فقط لا غير. وهذا مُعاكسٌ للتحقق من الأنواع اسميًّا (nominal typing). انظر الشيفرة التالية: interface Named { name: string; } class Person { name: string; } let p: Named; // هذا مسموح به بسبب التحقق من الأنواع هيكليًّا p = new Person(); في اللغات المعتمدة على التحقق من الأنواع اسميًّا مثل لغة C#‎ أو Java، فالشيفرة ...

actual typealias Appendable = Appendable المنصة والإصدار المطلوبان: Kotlin 1.1، JVM. actual interface Appendable المنصة المطلوبة: JS. الدوال append تضيف هذه الدالة المحرف الممرر إليها أو كامل محتوى الكائن المُمرّر إليها أو جزءًا منه إلى الكائن المستدعى معها.  الدوال الموروثة equals تتحقق هذه الدالة إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعي معها. hashCode تعيد هذه الدالة الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. toString تحول هذه الدالة الكائن الذي يُستدعى معه إلى سلسلة نصية (String). مصادر صفحة الواجهة Appendable في التوثيق ...

يضيف التابع ترويسة جديدة إلى الطلب. تتجاهل جميع معالجات الطلبات -باستثناء معالجات HTTP- في الوقت الحاضر الترويسات، حيث تُضاف إلى قائمة الترويسات المُرسلة إلى المخدّم. يجدر الانتباه إلى أنّه لا يُسمح بوجود ترويستين تحملان الاسم نفسه، وسيلغي الاستدعاءُ المتأخّر الاستدعاءات السابقة في حال وجود تضارب في المفتاح المعطى. لا يؤثّر هذا حاليًّا على عمل HTTP، لأنّ جميع الترويسات التي تحمل معنًى معيّنًا عند استخدامها لأكثر من مرّة تمتلك طريقة خاصّة بالترويسات للحصول على نفس الوظيفة باستخدام ترويسة واحدة فقط. البنية ...

actual typealias Appendable = Appendable المنصة والإصدار المطلوبان: Kotlin 1.1، JVM. actual interface Appendable المنصة المطلوبة: JS. الدوال append تضيف هذه الدالة المحرف الممرر إليها أو كامل محتوى الكائن المُمرّر إليها أو جزءًا منه إلى الكائن المستدعى معها.  الدوال الموروثة equals تتحقق هذه الدالة إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعي معها. hashCode تعيد هذه الدالة الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. toString تحول هذه الدالة الكائن الذي يُستدعى معه إلى سلسلة نصية (String). مصادر صفحة الواجهة Appendable في التوثيق ...

تُستخدَم هذه الخاصيّة للحصول على نسخةٍ (instance) من الصنف KClass بحسب نوع التوصيف الحاليّ. البنية العامة val <T : Annotation> T.annotationClass: KClass<out T> القيم المعادة نسخةٌ من الصنف KClass متوافقةٌ مع نوع التوصيف (annotation) الحاليّ. انظر أيضًا التوصيفات (annotations) في لغة Kotlin. الصنف KClass  : أحد أصناف لغة Kotlin والمُستخدَم لإجراء عمليّات التحقُّق الداخليّة (introspection) مثل: isAbstract ومرئية الوصول (visibility) وغيرها. الواجهة Annotation: الواجهة الأساسيّة التي يُعرَّف استخدامها (implemented) ضمنيًا في جميع واجهات التوصيفات (annotation interfaces). مصادر صفحة الخاصيّة annotationClass في ...

يطلق هذا التابع افتراضيًا الاستثناء UnpicklingError. البنية العامة persistent_load(pid) المعاملات pid في حال تعريف هذا التابع فإنّه يعيد الكائن المحدّد بواسطة المعرّف المستمر pid، وإذا كان المعرّف المستمّر غير صالحٍ فإنّ التابع يُطلق الاستثناء UnpicklingError. راجع قسم "استمرارية الكائنات الخارجية" في وحدة pickle للاطلاع على المزيد من التفاصيل والأمثلة حول هذا الموضوع. انظر أيضًا التابع Unpickler.persistent_id()‎ : لا يؤدي هذا التابع افتراضيًا أي وظيفة، والهدف من وجوده هو إمكانية إعادة تعريفه override بواسطة صنف فرعي. مصادر صفحة DB-API 2.0 interface for ...

يطلق هذا التابع افتراضيًا الاستثناء UnpicklingError. البنية العامة persistent_load(pid) المعاملات pid في حال تعريف هذا التابع فإنّه يعيد الكائن المحدّد بواسطة المعرّف المستمر pid، وإذا كان المعرّف المستمّر غير صالحٍ فإنّ التابع يُطلق الاستثناء UnpicklingError. راجع قسم "استمرارية الكائنات الخارجية" في وحدة pickle للاطلاع على المزيد من التفاصيل والأمثلة حول هذا الموضوع. انظر أيضًا التابع Unpickler.persistent_id()‎ : لا يؤدي هذا التابع افتراضيًا أي وظيفة، والهدف من وجوده هو إمكانية إعادة تعريفه override بواسطة صنف فرعي. مصادر صفحة DB-API 2.0 interface for ...

تُستخدَم هذه الخاصيّة للحصول على نسخةٍ (instance) من الصنف KClass بحسب نوع التوصيف الحاليّ. البنية العامة val <T : Annotation> T.annotationClass: KClass<out T> القيم المعادة نسخةٌ من الصنف KClass متوافقةٌ مع نوع التوصيف (annotation) الحاليّ. انظر أيضًا التوصيفات (annotations) في لغة Kotlin. الصنف KClass  : أحد أصناف لغة Kotlin والمُستخدَم لإجراء عمليّات التحقُّق الداخليّة (introspection) مثل: isAbstract ومرئية الوصول (visibility) وغيرها. الواجهة Annotation: الواجهة الأساسيّة التي يُعرَّف استخدامها (implemented) ضمنيًا في جميع واجهات التوصيفات (annotation interfaces). مصادر صفحة الخاصيّة annotationClass في ...

تتيح هذه الدالة عرض الأخطاء tracebacks الناتجة عن الدوال والمجاميع aggregates والمحوّلات converters والاستدعاءات الخلفية authorizer callbacks المفوِّضة المعرّفة من قبل المستخدم. البنية العامة sqlite3.enable_callback_tracebacks(flag) ‎المعاملات لا تعرض اللغة -بصورة افتراضية- الأخطاء tracebacks في الدوال والمجاميع aggregates والمحوّلات converters والاستدعاءات الخلفية المفوِّضة authorizer callbacks المعرّفة من قبل المستخدم. ولتنقيح بنى التحكم هذه يمكن استدعاء هذه الدالة مع تعيين القيمة True للمعامل flag. بعد ذلك ستعرض اللغة الأخطاء الناتجة من الاستدعاءات الخلفية في sys.stderr. يمكن استخدام القيمة False لإلغاء هذه الخاصية ...

هذه الدالة مهملة في هذه الوحدة، وهي موجودة لغرض التوافق مع الإصدارات السابقة من بايثون. استخدم الدالة urllib.parse.parse_qs()‎ عوضًا عنها.  البنية العامة cgi.parse_qs(qs, keep_blank_values=False, strict_parsing=False) انظر أيضًا الدالة cgi.parse()‎: تحلّل الدالة الاستعلام الموجود في بيئة معينة أو في ملف معيّن. الدالة cgi.parse_qsl()‎: هذه الدالة مهملة في هذه الوحدة، وهي موجودة لغرض التوافق مع الإصدارات السابقة من بايثون. استخدم الدالة urllib.parse.parse_qsl()‎‎ عوضًا عنها. الدالة cgi.parse_multipart()‎: تحلّل الدالة المدخلات من نوع multipart/form-data (للملفات المرفوعة). الدالة cgi.parse_header()‎: تحلّل الدالة ترويسة MIME (مثل Content-Type) إلى قيمة ...

نسخة من الصنف Row وتعدّ صورة محسّنة من الخاصية row_factory في كائنات الاتصال. تحاول نسخة الصنف هذه محاكاة الصفوف tuples في معظم خصائصها، وتدعم الوصول إلى العناصر بواسطة اسم العمود وموقعه، وتدعم كذلك المرور على العناصر، وتمثيلها، واختبار المساواة ومعرفة الطول بواسطة الدالة len()‎. إن امتلك كائنا Row نفس عدد الأعمدة وكان عدد العناصر فيهما متساويًا، فإنّ الكائنين متساويان. توابع كائنات Row التابع keys()‎ يعيد التابع قائمة بأسماء الأعمدة. انظر أيضًا كائنات Connection في بايثون. كائنات Cursor في بايثون. مصادر ...

تحلّل الدالة ترويسة MIME (مثل Content-Type) إلى قيمة رئيسة وقاموسٍ من المعاملات. البنية العامة cgi.parse_header(string) المعاملات string ترويسة MIME. انظر أيضًا الدالة cgi.parse()‎: تحلّل الدالة الاستعلام الموجود في بيئة معينة أو في ملف معيّن. الدالة cgi.parse_qs()‎: هذه الدالة مهملة في هذه الوحدة، وهي موجودة لغرض التوافق مع الإصدارات السابقة من بايثون. استخدم الدالة urllib.parse.parse_qs()‎ عوضًا عنها.  الدالة cgi.parse_qsl()‎: هذه الدالة مهملة في هذه الوحدة، وهي موجودة لغرض التوافق مع الإصدارات السابقة من بايثون. استخدم الدالة urllib.parse.parse_qsl()‎‎ عوضًا عنها. الدالة cgi.parse_multipart()‎: ...

هذه الدالة مهملة في هذه الوحدة، وهي موجودة لغرض التوافق مع الإصدارات السابقة من بايثون. استخدم الدالة urllib.parse.parse_qsl()‎ عوضًا عنها.  البنية العامة cgi.parse_qsl(qs, keep_blank_values=False, strict_parsing=False) انظر أيضًا الدالة cgi.parse()‎: تحلّل الدالة الاستعلام الموجود في بيئة معينة أو في ملف معيّن. الدالة cgi.parse_qs()‎: هذه الدالة مهملة في هذه الوحدة، وهي موجودة لغرض التوافق مع الإصدارات السابقة من بايثون. استخدم الدالة urllib.parse.parse_qs()‎ عوضًا عنها. الدالة cgi.parse_multipart()‎: تحلّل الدالة المدخلات من نوع multipart/form-data (للملفات المرفوعة). الدالة cgi.parse_header()‎: تحلّل الدالة ترويسة MIME (مثل Content-Type) إلى قيمة ...

يغلق التابع الاتصال بقاعدة البيانات. يجدر الانتباه إلى أنّ إغلاق الاتصال لا يستدعي التابع commit()‎ على نحو تلقائي. فإن أغلقت الاتصال بقاعدة البيانات دون استدعاء التابع commit()‎ أولًا، ستفقد جميع التعديلات التي أجريتها على قاعدة البيانات. البنية العامة close() أمثلة يبين المثال التالي طريقة استخدام التابع: import sqlite3 conn = sqlite3.connect('example.db') c.execute('''CREATE TABLE stocks (date text, trans text, symbol text, qty real, price real)''') c.execute("INSERT INTO stocks VALUES ('2006-01-05','BUY','RHAT',100,35.14)") conn.commit() conn.close() مصادر صفحة ...

تسجّل الدالة كائنًا قابلًا للاستدعاء callable لتحويل سلسلة بايتات نصية من قاعدة البيانات إلى نوع خاص من أنواع بيانات بايثون. البنية العامة sqlite3.register_adapter(type, callable) المعاملات type نوع بيانات بايثون الذي ستحوّله الدالة إلى إحدى الأنواع التي تدعمها قواعد بيانات SQLite. callable كائن قابل للاستدعاء يأخذ معاملًا واحدًا هو نوع بيانات بايثون، ويجب أن يعيد إحدى الأنواع التالية: int أو float أو str أو bytes. انظر أيضًا الدالة register_converter()‎: تسجّل الدالة كائنًا قابلًا للاستدعاء callable لتحويل سلسلة بايتات نصية من قاعدة ...

لا يؤدي هذا التابع افتراضيًا أي وظيفة، والهدف من وجوده هو إمكانية إعادة تعريفه override بواسطة صنف فرعي. البنية العامة persistent_id(obj) إن أعاد هذا التابع القيمة None، فإنّ الكائن يُسلسَل كالمعتاد، أما القيم الأخرى فتسبّب في إطلاق المسلسل Pickler القيمة المعادة كمعرّف مستمر للكائن المعطى. يجب تحديد معنى هذه المعرّف المستمر بواسطة التابع Unpickler.persistent_load()‎. لاحظ أنّه لا يمكن للقيمة التي يعيدها التابع persistent_id()‎ أن تمتلك معرّفًا مستمرًا. راجع قسم "استمرارية الكائنات الخارجية" للاطلاع على المزيد من التفاصيل والأمثلة حول هذا ...

يعيد هذا التابع دائمًا قائمة بالقيم المرتبطة بالحقل المعطى. البنية العامة FieldStorage.getlist(name) ‎المعاملات name اسم الحقل المراد جلب القيمة المرتبطة به. القيمة المعادة يعيد هذا التابع دائمًا قائمة بالقيم المرتبطة بالحقل المعطى، ويعيد قائمة فارغة إن لم يكن هناك حقل أو قيمة النموذج تحمل الاسم المعطى، ويعيد قائمة تحتوي على عنصر واحد فقط إن كانت هناك قيمة واحدة فقط. أمثلة يبين المثال التالي كيفية استخدام التابع: import cgi form = cgi.FieldStorage() for item in form.getlist("item"): do_something(item) انظر أيضًا التابع ...

يستورد التابع الوحدة المعطاة إذا اقتضت الحاجة ويعيد الكائن الذي يحمل الاسم المحدّد. تجدر الإشارة إلى أنّه وعلى خلاف ما يشير إليه اسم هذا التابع، فبالإمكان استخدام find_class()‎ للعثور على الدوال. يمكن للأصناف الفرعية أن تعيد تعريف override هذا التابع للتحكم بأنواع الكائنات المستوردة وطريقة تحميلها، وقد يساهم هذا في تقليل الأخطار الأمنية. راجع قسم تقييد المتغيرات العامة للمزيد من التفاصيل. البنية العامة find_class(module, name) ‎المعاملات module سلسلة نصية تتضمن اسم الوحدة التي يستوردها التابع. name سلسلة نصية تتضمن اسم ...

يعيد التابع مكرِّرًا iterator يمكن استخدامه لعرض (dump) قاعدة البيانات بصيغة SQL النصية. البنية العامة iterdump() ‎القيمة المعادة يعيد التابع مكرِّرًا iterator يمكن استخدامه لعرض (dump) قاعدة البيانات بصيغة SQL النصية. هذا التابع مفيد عند التعامل مع قواعد البيانات المخزّنة في الذاكرة. يقدّم هذا التابع نفس الإمكانات التي يقدّمها الأمر ‎.dumb في صدفة sqlite3. أمثلة يعرض المثال التالي كيفية تحويل الملف existing_db.db إلى ملف عرض SQL يحمل الاسم dump.sql: import sqlite3 con = sqlite3.connect('existing_db.db') with open('dump.sql', 'w') as f: ...

يحفظ التابع التعديلات التي أجريت على قاعدة البيانات. البنية العامة commit() ‎في حال عدم استدعاء هذا التابع ستكون جميع التعديلات التي أجريت بعد آخر استدعاء للتابع commit()‎ غير مرئية بالنسبة إلى الاتصالات الأخرى المفتوحة مع قاعدة البيانات؛ لذا إن لم تتمكن من رؤية البيانات التي أضفتها إلى قاعدة البيانات، فتأكّد من أنّك لم تنس استدعاء هذا التابع. أمثلة يبين المثال التالي آلية عمل التابع: import sqlite3 conn = sqlite3.connect('example.db') c.execute('''CREATE TABLE stocks ...

(PHP 5 >= 5.0.2, PHP 7) تتحقق الدالة interface_exists()‎‎‎‎‎ فيما إذا كانت الواجهة (interface) مُعرّفة. الوصف bool interface_exists (string $interface_name [, bool $autoload = TRUE ]) تتحقق الدالة interface_exists()‎‎‎‎‎ فيما إذا كانت الواجهة المُعطاة مُعرّفة. المعاملات interface_name اسم الواجهة. autoload يُحدِّد هذا المعامل فيما إذا كانت ستُستدعى الدالة ‎__autoload‎‎ أم لا. القيم المعادة تُعيد الدالة interface_exists()‎‎‎‎‎ القيمة TRUE إذا كانت الواجهة المُعطاة بالمعامل interface_nam مُعرّفة، وإلا فإنها ستُعيد القيمة FALSE. أمثلة المثال 1: مثال عن استخدام الدالة interface_exists()‎‎‎ <?php // التحقق ...

يعيد التابع سلسلة نصية تحدّد الطريقة المتّبعة في إرسال طلب HTTP. البنية العامة Request.get_method() ‎القيمة المعادة يعيد التابع سلسلة نصية تحدّد الطريقة المتّبعة في إرسال طلب HTTP. يعيد التابع قيمة الخاصية Request.method إن لم تكن قيمتها None، أما إن كانت قيمة الخاصية هي None فإنّ التابع سيعيد 'GET'، ويعيد القيمة 'POST' إن لم تكن قيمة الخاصية هي None، وهذا السلوك مفيد في طلبات HTTP فقط. ملاحظة: ينظر التابع في قيمة الخاصية Request.method في الإصدار 3.3 وما بعده من بايثون. أمثلة ...

تحوّل الدالة الحروف '&' و '>' و '<' في السلسلة النصية المعطاة إلى تسلسل حروف آمن في HTML. تُستخدم هذه الدالة لعرض النصوص التي قد تحتوي على مثل هذه المحارف. ملاحظة: هذه الدالة مهملة منذ الإصدار 3.2 من بايثون. هذه الدالة غير آمنة لأنّ المعامل quote يحمل قيمة خاطئة افتراضيًا. استخدم الدالة html.escape()‎ عوضًا عنها. البنية العامة cgi.escape(s, quote=False) المعاملات s السلسلة النصية التي ستحول الدالة حروفها إلى تسلسل حروف آمن في HTML. ‎quote معامل اختياري، إن أخذ قيمة صحيحة ...

تحلّل الدالة الاستعلام الموجود في بيئة معينة أو في ملف معيّن (القيمة الافتراضية للملف هي sys.stdin). البنية العامة cgi.parse(fp=None, environ=os.environ, keep_blank_values=False, strict_parsing=False) ‎المعاملات ‎يمرّر المعاملان keep_blank_values و strict_parsing إلى الدالة urllib.parse.parse_qs()‎ دون تغيير. انظر أيضًا الدالة cgi.parse_qs()‎: هذه الدالة مهملة في هذه الوحدة، وهي موجودة لغرض التوافق مع الإصدارات السابقة من بايثون. استخدم الدالة urllib.parse.parse_qs()‎ عوضًا عنها.  الدالة cgi.parse_qsl()‎: هذه الدالة مهملة في هذه الوحدة، وهي موجودة لغرض التوافق مع الإصدارات السابقة من بايثون. استخدم الدالة urllib.parse.parse_qsl()‎‎ عوضًا عنها. الدالة ...

(PHP 5, PHP 7) تُعيد الدالة get_declared_interfaces()‎‎ مصفوفة  بكل الواجهات (interfaces) المُصرّح عنها. الوصف array get_declared_interfaces ( void ) تحصل الدالة get_declared_interfaces()‎‎ على الواجهات المُصرّح عنها. المعاملات لا تملك الدالة get_declared_interfaces()‎ أيّة معاملات. القيم المعادة تُعيد الدالة get_declared_interfaces()‎‎ مصفوفة بأسماء الواجهات المُصرّح عنها في السكربت الحالي. أمثلة المثال 1: مثال عن استخدام الدالّة get_declared_interfaces()‎ <?php print_r(get_declared_interfaces()); ?> سينتج المثال السابق الناتج الآتي: Array ( [0] => Traversable [1] => IteratorAggregate [2] => Iterator ...

الخاصية text-overflow في CSS تُحدِّد ماذا سيحدث عند عدم عرض المحتوى الزائد عن صندوقه، فيمكن أن يتم اقتصاص المحتوى، أو عرض ثلاث نقط (المحرف … رمزه U+2026)، أو عرض سلسلة نصية خاصة. بطاقة الخاصية القيمة الابتدائية clip تُطبَّق على الحاويات الكتلية (block container elements). قابلة للوراثة لا قابلة للحركة لا القيمة المحسوبة كما حُدِّدَت. /* الكلمات المحجوزة */ text-overflow: clip; text-overflow: ellipsis; /* <string> سلسلة نصية */ text-overflow: "…"; /* القيم العامة */ text-overflow: inherit; text-overflow: initial; text-overflow: unset; الخاصية text-overflow لا تؤدي إلى خروج المحتوى من صندوقه، ولجعل ...

قد تحتاج في بعض الأحيان لإنشاء كائنٍ بإجراء تعديلاتٍ طفيفةٍ على أحد الأصناف (classes) بدون التصريح عن صنفٍ فرعيٍّ (subclass) له؛ تعالج لغة Java مثل هذه الحالات بالاعتماد على الأصناف الداخليّة المجهولة (anonymous inner classes)، وتُعمِّمها لغة Kotlin من خلال طرح مفهوم التصريح عن الكائنات وتعابيرها. تعابير الكائنات (Object Expressions) لإنشاء كائنٍ من صنفٍ مجهولٍ (anonymous) يرِث من نوعٍ أو أكثر تكون الشيفرة بالشكل: window.addMouseListener(object : MouseAdapter() { override fun mouseClicked(e: MouseEvent) { ...

يستدعي هذا التابعُ التابعَ Cursor.execute()‎ مع تمرير المعاملات المعطاة. البنية العامة execute(sql[, parameters]) ‎ المعاملات sql سلسلة نصية تتضمن جملة SQL المراد تنفيذها. القيمة المعادة هذا التابع طريقة مختصرة لإنشاء كائن مؤشر عن طريق استدعاء التابع cursor()‎، حيث يستدعي التابع execute()‎ في كائن المؤشر مع تمرير المعاملات المعطاة، ثم يعيد كائن المؤشر. أمثلة يبين المثال التالي آلية عمل التابع: import sqlite3 conn = sqlite3.connect('example.db') c = conn.cursor() symbol = 'RHAT' c.execute("SELECT * FROM stocks WHERE symbol = '%s'" % symbol) انظر أيضًا التابع Connection.excutemany()‎: ...

يسجّل هذا التابع استدعاءً خلفيًا يجري تنفيذه لكل n من تعليمات SQLite في الجهاز الافتراضي virtual machine. هذا التابع مفيد عند الحاجة إلى اجراء استدعاء من SQLite أثناء عملية طويلة، كتحديث واجهة رسومية مثلًا. البنية العامة set_progress_handler(handler, n) المعاملات handler يمكن استدعاء التابع مع تمرير القيمة None للمعامل handler للتخلص من أي استدعاء خلفي معدّ مسبقًا. تؤدي إعادة قيمة غير الصفر من الاستدعاء الخلفي إلى إنهاء الاستعلام الحالي وإطلاق الاستثناء OperationalError. n عدد تعليمات SQLite. انظر أيضًا التابع Connection.set_authorizer()‎:يسجّل هذا ...

يجلب التابع الصفّ row التالي من نتيجة الاستعلام، ويعيد تسلسلًا واحدًا فقط، أو يعيد القيمة None في حال عدم توفّر المزيد من البيانات. البنية العامة fetchone() ‎القيمة المعادة يعيد التابع تسلسلًا واحدًا فقط، أو يعيد القيمة None في حال عدم توفّر المزيد من البيانات. أمثلة يبين المثال التالي آلية عمل التابع: >>> import sqlite3 >>> conn = sqlite3.connect(":memory:") >>> cur = conn.cursor() >>> cur.execute("create table people (name, age)") <sqlite3.Cursor object at 0x7f0ea62989d0> >>> name = "Mohammed" >>> age = 30 >>> cur.execute("insert into people values (?, ?)", ...

تمثّل وحدة dbm واجهة عامّة للأشكال المختلفة من قواعد بيانات DBM، مثل dbm.gnu و dbm.ndbm. في حال عدم تثبيت أيّ من هذه الوحدات، فإنّ اللغة ستستخدم الأداة البطيئة والبسيطة في وحدة dbm.dumb. وهناك واجهة تقدّمها جهة خارجية للتعامل مع قواعد بيانات Oracle Berkeley. الاستثناءات الاستثناء dbm.error صفّ يتضمن الاستثناءات التي يمكن أن تُطلق بواسطة الوحدات المدعومة، ويكون العنصر الأول في هذا الصفّ هو استثناء فريد يحمل الاسم dbm.error والذي يُستخدم عند إطلاق الاستثناء dbm.error. الدوال الدالة whichdb()‎ تحاول هذه الدالة ...

يقرأ التابع تمثيل كائن مسلسل من كائن الملف المفتوح في الدالة البانية للصنف، ويعيد هيكل الكائن المعاد بناؤها والموصوفة في هذا الملف، ويتجاهل التابع البايتات التي تسبق تمثيل الكائن المسَلسَل. البنية العامة load() ‎القيمة المعادة يعيد التابع هيكل الكائن المعاد بناؤها والموصوفة في هذا الملف، ويتجاهل التابع البايتات التي تسبق تمثيل الكائن المسَلسَل. أمثلة يبين المثال التالي طريقة عمل التابع (راجع المثال في صفحة التابع Pickler.dump()‎ للاطلاع على الكائن المسَلسَل في الملف file1.dat): >>> import pickle >>> f = open('file1.dat', 'rb') >>> ...

يقرأ التابع تمثيل كائن مسلسل من كائن الملف المفتوح في الدالة البانية للصنف، ويعيد هيكل الكائن المعاد بناؤها والموصوفة في هذا الملف، ويتجاهل التابع البايتات التي تسبق تمثيل الكائن المسَلسَل. البنية العامة load() ‎القيمة المعادة يعيد التابع هيكل الكائن المعاد بناؤها والموصوفة في هذا الملف، ويتجاهل التابع البايتات التي تسبق تمثيل الكائن المسَلسَل. أمثلة يبين المثال التالي طريقة عمل التابع (راجع المثال في صفحة التابع Pickler.dump()‎ للاطلاع على الكائن المسَلسَل في الملف file1.dat): >>> import pickle >>> f = open('file1.dat', 'rb') >>> ...

تسجّل الدالة كائنًا قابلًا للاستدعاء callable لتحويل سلسلة بايتات نصية من قاعدة البيانات إلى نوع خاص من أنواع بيانات بايثون. البنية العامة sqlite3.register_converter(typename, callable) ‎المعاملات typename يستدعى الكائن الذي تسجّله الدالة لجميع القيم الموجودة في قاعدة البيانات والتي تكون من النوع المحدد بواسطة المعامل typename. يمكنك الرجوع إلى المعامل detect_types في دالة connect()‎ للاطلاع على طريقة الكشف عن الأنواع. يجدر التنبيه إلى أنّ المطابقة بين النوع المعطى والنوع المحدد في جملة الاستعلام تكون غير حساسة لحالة الأحرف. callable كائن قابل ...

يغلق التابع المؤشر فورًا (عوضًا عن إغلاقه عند استدعاء التابع ‎__del__‎)، وبعدها لن يكون بالإمكان استخدام المؤشر، وستطلق اللغة الاستثناء ProgrammingError عند تنفيذ أي عملية باستخدام المؤشر. البنية العامة close() أمثلة يبين المثال التالي طريقة استخدام التابع: >>> import sqlite3 >>> conn = sqlite3.connect('example.db') >>> c = conn.cursor() >>> c.execute('''CREATE TABLE stocks ... (date text, trans text, symbol text, qty real, price real)''') <sqlite3.Cursor object at 0x7f0ea62989d0> >>> c.execute("INSERT INTO stocks VALUES ('2006-01-05','BUY','RHAT',100,35.14)") <sqlite3.Cursor ...

الصنف الزائف ‎:required‎ في CSS (أي pseudo-class) يُمثِّل أيّة عناصر <input> أو <select> أو <textarea> التي ضُبِطَت الخاصية required عليها. input:required { border: 1px dashed red; } هذا الصنف الزائف مفيدٌ لتنسيق الحقول الضرورية لإرسال النموذج. ملاحظة: الصنف الزائف ‎:optional هو الصنف الذي يُطابِق الحقول الضرورية في النموذج. :required أمثلة راجع صفحة الصنف الزائف ‎:invalid للأمثلة. دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari الدعم الأساسي 10.0 4.0 10 10.0 5.0 انظر أيضًا صفحة الصنف الزائف optional: الذي يُمثِّل أيّة عناصر <input> أو <select> أو <textarea> التي لم ...

هذا التابع من التوابع غير المعيارية والذي يسهل عملية تنفيذ جمل SQL متعددة دفعة واحدة. ينفّذ هذا التابع جملة COMMIT في البداية، ثم ينفّذ بعدها شيفرة SQL المعطاة في المعاملات. البنية العامة executescript(sql_script) ‎المعاملات sql_script يمكن لهذا المعامل أن يكون نسخة من الكائن str. أمثلة يبين المثال التالي آلية عمل التابع: import sqlite3 con = sqlite3.connect(":memory:") cur = con.cursor() cur.executescript(""" create table person( firstname, lastname, ...

يسجل التابع trace_callback يجري استدعاؤه لكل جملة SQL تنفّذ بواسطة SQLite. البنية العامة set_trace_callback(trace_callback) المعاملات trace_callback يأخذ الاستدعاء الخلفي وسيطًا واحدًا وهو عبارة الاستعلام (كسلسلة نصية) التي سيجري تنفيذها، وتتجاهل اللغة القيمة المعادة من الاستدعاء الخلفي. يجدر الانتباه إلى أنّ محرّك SQLite لا ينفّذ العبارات الممرّة إلى توابع Cursor.execute()‎ وحسب، بل هناك مصادر أخرى منها عملية إدارة الإجراءات في وحدة بايثون، وعملية تنفيذ المشغّلات triggers المعرّفة في قاعدة البيانات الحالية. يؤدي تمرير القيمة None إلى المعامل trace_callback إلى تعطيل الاستدعاء ...

تمثل الواجهة Function قيمةً لنوع وظيفي (functional type) -مثل تعبير lambda-، أو دالة مجهولة، أو مرجع دالة. interface Function<out R> إذ يعيد المعامل R نوع الدالة. الدوال الموروثة equals تتحقق الدالة equals()‎ إذا ما كان الكائن المُمرّر إليها يساوي الكائن الذي استدعيت معه. وأيُّ تعريف لاستخدام هذه الدالة يجب أن يكون: hashCode تعيد الدالة hashCode()‎ الشيفرة Hash الخاصّة بالكائن الذي استُدعي معها. تُحقِّق هذه الدالة الشرطين الآتيين دائمًا: toString تحول الدالة toString()‎ الكائن الذي يُستدعى معه إلى سلسلة نصية (String). الدوال الإضافية (Extension Functions) reflect ...

الصنف الزائف ‎:optional‎ في CSS (أي pseudo-class) يُمثِّل أيّة عناصر <input> أو <select> أو <textarea> التي لم تُضبَط الخاصية required عليها. input:optional { border: 1px dashed black; } هذا الصنف الزائف مفيدٌ لتنسيق الحقول التي ليست ضروريةً لإرسال النموذج. ملاحظة: الصنف الزائف ‎:required هو الصنف الذي يُطابِق الحقول الضرورية في النموذج. :optional أمثلة راجع صفحة الصنف الزائف ‎:invalid للأمثلة. دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari الدعم الأساسي 10.0 4.0 10 10.0 5.0 انظر أيضًا صفحة الصنف الزائف required: الذي يُمثِّل ...

أنواع التقاطع (Intersection Types) يجمعُ نوعُ تقاطعٍ عدّة أنواع في نوع واحد. يسمح هذا بجمع الأنواع الموجودة في نوع واحد يملك جميع الميّزات التي تحتاج إليها. مثلًا، النوعُ ‎Person & Serializable & Loggable‎ هو من النّوع ‎Person‎ والنّوع ‎Serializable‎ والنّوع ‎Serializable‎، كلّها مجموعة في نفس النّوع. هذا يعني أنّ كائنًا ما من هذا النوع سيحتوي على جميع عناصر الأنواع الثلاثة. تُستعمل أنواع التّقاطع عادةً في المخاليط (mixins) والمبادئ الأخرى التي قد تكون غريبة على البرمجة كائنيّة التوجه العاديّة (وهي متواجدة ...

توضّح هذه الصفحة كيفيّة استخدام أدوات البناء (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 ...

يستدعي هذا التابعُ التابعَ 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), ...

يحمل هذا التابع إحدى ملحقات SQlite من المكتبة المشتركة. يجب تفعيل خاصية تحميل الملحقات بواسطة التابع enable_load_extension()‎ قبل استخدام هذا التابع. يجدر التنبيه إلى أنّ الملحقات القابلة للتحميل معطّلة بصورة افتراضية، وذلك لأنّ بعض المنصّات (وبالخصوص Mac OS X) تمتلك مكتبات SQLite مصرّفة دون تضمين هذه الميزة. لتفعيل ميزة الملحقات القابلة للتحميل يجب تمرير ‎-enable-loadable-sqlite-extensions إلى الإعدادات. ملاحظة: هذا التابع جديد في الإصدار 3.2. البنية العامة load_extension(path) المعاملات path المسار المؤدي إلى الملحقة المطلوب تحميلها. أمثلة يبين المثال التالي طريقة ...

يستدعي هذا التابعُ التابعَ 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), ...

(PHP 4, PHP 5, PHP 7) تُعيد الدالة get_declared_classes()‎ مصفوفةً فيها أسماء الأصناف المُصرّح عنها. الوصف array get_declared_classes ( void ) تحصل الدالة get_declared_classes()‎  على الأصناف المُصرّح عنها. المعاملات لا تملك الدالة get_declared_classes()‎ أيّة معاملات. القيم المعادة تُعيد الدالة get_declared_classes()‎ مصفوفة بأسماء الأصناف المُصرّح عنها في السكربت الحالي. ملاحظة: يمكن أن توجد أصناف إضافية في PHP  اعتمادًا على الإضافات المجمّعة (compiled) والمحملة إليها. وهذا يعني أنك لن تكون قادرًا على استخدام أسماء هذه الأصناف في تعريف أصنافك الخاصّة. ستجد قائمة بالأصناف ...

(PHP 4, PHP 5, PHP 7) تتحقق الدالّة class_exists()‎‎‎ من أنّ الصنف الممرّر مُعرّف. الوصف bool class_exists ( string $class_name [, bool $autoload = TRUE ] ) تتحقق الدالة class_exists()‎ من أن الصنف الممرّر إليها مُعرّف أم لا. المعاملات class_name اسم الصف المراد التحقق منه. يتم مطابقة الاسم بشكل غير حساس لحالة الأحرف. autoload ضبط إذا كانت ستُستدعى دالة ‎__autoload‎‎ افتراضيًا أم لا. القيم المعادة تُعيد الدالّة class_exists()‎ القيمة TRUE إذا كان الصنف class_name معرّفًا، وإلاّ فستُعيد FALSE. سجل التغييرات ...

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

معاملات الأنواع (Type Parameters) قد تحتوي الأصناف (classes) -كما هو الحال في لغة Java- على معاملات للأنواع (type parameters) مثل: class Box<T>(t: T) { var value = t } ولإنشاء كائنٍ (instance) من هذا الصنف يجب تحديد النوع كما في الشيفرة الآتية: val box: Box<Int> = Box<Int>(1) أمّا إن كان بالإمكان معرفة (infer) المعاملات إمّا من خلال معاملات الباني (constructor arguments) أو بأيّ وسيلةٍ أخرى فيمكن حينئذٍ حذف نوع المعاملات، مثل: val box = Box(1) // القيمة 1 لها ...

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

تتحقّق الدالة ممّا إذا كانت السلسلة النصية المعطاة تتضمن جملة SQL واحدة أو أكثر تنتهي بالفاصلة المنقوطة. البنية العامة sqlite3.complete_statement(sql) المعاملات sql سلسلة نصية تتضمن جملة SQL المراد التحقق ممّا إذا كانت تنتهي بفاصلة منقوطة أو لا. القيمة المعادة تعيد الدالة القيمة True إن كانت السلسلة النصية المعطاة تتضمن جملة SQL واحدة أو أكثر تنتهي بالفاصلة المنقوطة. أمثلة يمكن استخدام هذه الدالة لتوفير طبقة حماية لقاعدة بيانات SQLite، وكما هو موضح في المثال التالي: import sqlite3 con = sqlite3.connect(":memory:") con.isolation_level = None cur ...

الصنف الزائف ‎:enabled في CSS (أي pseudo-class) يُمثِّل أي عنصر مُفعّل، أي يمكن اختياره أو النقر عليه أو الكتابة فيه أو يمكن التركيز عليه (focus): input:enabled { color: blue; } الشكل العام لهذا المحدد: :enabled أمثلة سنجعل عناصر <input> المُفعّلة بلونٍ أخضر، وبلونٍ فضي عندما تكون معطلةً، وذلك كي يتمكن المستخدم من التفريق بصريًا بين العناصر التي يستطيع التفاعل معها وتلك التي لا يستطيع التفريق بينها: <form action="url_of_form"> <label for="FirstField">الحقل الأول (enabled):</label> <input type="text" id="FirstField" value="Lorem"><br> <label for="SecondField">الحقل ...

يستدعي هذا التابعُ التابعَ Cursor.executescript()‎ مع تمرير المعاملات المعطاة. البنية العامة executescript(sql_script) ‎المعاملات sql_script سلسلة نصية تتضمن شيفرة SQL المراد تنفيذها. القيمة المعادة هذا التابع هو طريقة مختصرة لإنشاء كائن مؤشر عن طريق استدعاء التابع cursor()‎، حيث يستدعي التابع executescript()‎ في كائن المؤشر مع تمرير قيمة المعامل sql_script، ثم يعيد كائن المؤشر. أمثلة يبين المثال التالي آلية عمل التابع: import sqlite3 conn = sqlite3.connect('example.db') conn.executescript(""" insert into recipe (name, ingredients) values ('broccoli stew', 'broccoli peppers cheese tomatoes'); ...

يعيد التابع قائمة بأسماء الأعمدة. البنية العامة keys() القيمة المعادة يعيد التابع قائمة بأسماء الأعمدة، وتكون هذه القائمة العنصر الأول في كلّ صفّ tuple في قيمة الخاصية Cursor.description بعد إجراء الاستعلام مباشرة. ملاحظة: أضيف دعم عملية التقطيع في الإصدار 3.5 من اللغة. أمثلة لنفترض أنّنا هيّأنا جدولًا على النحو التالي: conn = sqlite3.connect(":memory:") c = conn.cursor() c.execute('''create table stocks (date text, trans text, symbol text, qty real, price real)''') c.execute("""insert into stocks values ('2006-01-05','BUY','RHAT',100,35.14)""") conn.commit() c.close() يمكننا ...

تفتح الدالة قاعدة بيانات ndbm وتعيد كائن ndbm. البنية العامة dbm.ndbm.open(filename[, flag[, mode]]) المعاملات filename اسم ملف قاعدة البيانات (مع حذف اللاحقة ‎.dir‎ أو ‎.pag). flag يأخذ المعامل الاختياري flag إحدى القيم التالية: القيمة الوصف 'r' فتح قاعدة البيانات للقراءة فقط (القيمة الافتراضية). 'w' فتح قاعدة البيانات للكتابة والقراءة. 'c' فتح قاعدة البيانات للكتابة والقراءة، وإنشائها في حال عدم وجودها. 'n' تنشئ الدالة قاعدة بيانات جديدة وفارغة، وتفتحها للكتابة والقراءة. mode المعامل الاختياري mode هو وضع يونكس Unix mode للملف ...

تمثل الواجهة MatchResult نتائج مطابقة واحدة لتعبير نمطي. interface MatchResult الأنواع Destructured يوفر هذا الصنف مركبات الإسناد بالتفكيك (destructuring assignment) لمجموعة من القيم. الخاصيات destructured‎ تمثل هذه الخاصية نسخةً من الصنف Destructured توفّر مكونات عملية الإسناد بالتفكيك (destructuring assignment) التي تطبق على قيم المجموعة المُطابقة. groupValues تمثل هذه الخاصية قائمة بقيم المجموعة المفهرسة المتطابقة. groups تمثل هذه الخاصية مجموعةً (collection) تضم جميع المجموعات (groups) المتطابقة باستعمال تعبير نمطي محدد. range تمثل هذه الخاصية مجال الفهارس الذي يحدد مكان مُطابقة تعبير نمطي محدد في السلسلة النصية الأصلية. value تمثل هذه الخاصية السلسلة النصية المُدخلة، أو ...

تمثل الواجهة MatchResult نتائج مطابقة واحدة لتعبير نمطي. interface MatchResult الأنواع Destructured يوفر هذا الصنف مركبات الإسناد بالتفكيك (destructuring assignment) لمجموعة من القيم. الخاصيات destructured‎ تمثل هذه الخاصية نسخةً من الصنف Destructured توفّر مكونات عملية الإسناد بالتفكيك (destructuring assignment) التي تطبق على قيم المجموعة المُطابقة. groupValues تمثل هذه الخاصية قائمة بقيم المجموعة المفهرسة المتطابقة. groups تمثل هذه الخاصية مجموعةً (collection) تضم جميع المجموعات (groups) المتطابقة باستعمال تعبير نمطي محدد. range تمثل هذه الخاصية مجال الفهارس الذي يحدد مكان مُطابقة تعبير نمطي محدد في السلسلة النصية الأصلية. value تمثل هذه الخاصية السلسلة النصية المُدخلة، أو ...

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

تقدّم وحدة dbm.dumb واجهة برمجية مستمرة persistent شبيهة بالقواميس مكتوبة بواسطة لغة بايثون بالكامل. وعلى عكس الوحدات الأخرى مثل dbm.gnu لا حاجة لاستخدام أي مكتبات خارجية، ولكن تخزّن المفاتيح والقيم كبايتات كما هو الحال مع كائنات الربط المستمرّة الأخرى. ملاحظة: أعدت وحدة dbm.dumb لتوفّر الدعم التراجعي الأخير لوحدة dbm عند عدم توفّر أي وحدة ذات أداء أقوى. لم تكتب وحدة dbm.dumb لتقدّم أداءً سريعًا ولا تستخدم بكثرة مقارنة بالوحدات الأخرى الخاصة بقواعد البيانات. الاستثناءات الاستثناء dbm.dumb.error يطلق هذا الاستثناء عند ...

الصنف الزائف ‎:indeterminate في CSS (أي pseudo-class) يُمثِّل أيّة نماذج تكون حالتها غير معروفة (indeterminate): input:indeterminate { background: lime; } يمكن أن يُطابِق هذا المُحدَّد العناصر الآتية: صندوق تأشير checkbox الذي ضُبِطَت الخاصية indeterminate فيه إلى true عبر JavaScript. أزرار الانتقاء radio عندما تكون جميع الأزرار التي لها نفس القيمة للخاصية name غير منتقاةً. عناصر <progress> في الحالة غير المعروفة. الشكل العام لهذا المحدد: :indeterminate أمثلة سنُطبِّق في المثال الآتي أنماط خاصة لعناصر <label> المرتبطة بحقول النموذج ذات الحالة غير المعروفة: ...

أثبت نموذج الانتقال الفرعيّ فعّاليته كبديلٍ جيّدٍ عن وراثة تعريف الاستخدام (implementation inheritance) إذ تدعم لغة Kotlin هذه الميّزة بشكلٍ طبيعيّ دون الحاجة إلى أيّ نوع قياسيّ من الشيفرات، وبالتالي فإنّ الصنف المُشتقّ (Derived) يرِث من الواجهة (Base) وينقل فرعيًا (delegate) كلَّ توابعه العامّة (public methods) إلى كائنٍ مُحدَّدٍ، كما في الشيفرة الآتية: interface Base { fun print() } class BaseImpl(val x: Int) : Base { override fun print() { print(x) } } class Derived(b: Base) : Base ...

الصنف الزائف ‎:default في CSS (أي pseudo-class) يُمثِّل أي عنصر مُختار افتراضيًا بين مجموعة من العناصر المتعلقة به؛ ويمكن استخدام هذا الصنف الزائف على أيّة أزرار عادية <button> أو أزرار انتقاء (radio button) أو صناديق تأشير (checkbox) أو خيارات <option> في عنصر <select> تم تحديدها أو انتقاؤها. input:default { background-color: lime; } العناصر التي تسمح باختيار أكثر من عنصر يمكن أن يكون لها أكثر من عنصر مُختار افتراضيًا، ففي هذه الحالة ستُحدَّد جميع الخيارات الافتراضية باستخدام الصنف الزائف ‎:default. الشكل العام ...

يجلب التابع جميع الصفوف (المتبقّية) في نتيجة الاستعلام، ويعيد النتيجة على هيئة قائمة. البنية العامة fetchall() ‎القيمة المعادة يجلب التابع جميع الصفوف (المتبقّية) في نتيجة الاستعلام، ويعيد النتيجة على هيئة قائمة. يجدر التنبيه هنا إلى إمكانية تأثير خاصية arraysize في كائن المؤشر على أداء هذا التابع. يعيد التابع قائمة فارغة في حال عدم توفر الصفوف المطلوبة. أمثلة يبين المثال التالي طريقة عمل التابع: >>> import sqlite3 >>> conn = sqlite3.connect(":memory:") >>> cur = conn.cursor() >>> cur.execute("CREATE TABLE stocks (date text, trans text, symbol ...

يُشار إلى TypeScript على أنّها مجموعة عليا (superset) من JavaScript وتُترجم (compile) إليها. وهذا يعني بأن البرامج المكتوبة بلغة JavaScript هي برامج TypeScript صالحة كذلك، ولأنّها تُترجم إلى لغة JavaScript عاديّة، فيُمكن كتابة برامج بلغة TypeScript وترجمتها وتشغيلها في أي مكان يقبل تشغيل برمجيات JavaScript مثل المتصفّح، أو منصّة Node.js، أو أي مُحرّكٍ (engine) يدعم الإصدار ECMAScript 3 من لغة JavaScript أو أي إصدار أحدث منه. تدعم TypeScript مزايا JavaScript الجديدة والتي قيد التطوير، ما يشمل مزايا الإصدار ECMAScript 2015 ...

ينفّذ التابع جملة SQL المعطاة. البنية العامة execute(sql[, parameters]) ‎المعاملات sql سلسلة نصية تتضمن جملة SQL المراد تنفيذها. يمكن استخدام جمل تتضمن معاملات (أي استخدام محتوى نائب placeholder عوضًا عن الحروف). تدعم وحدة sqlite3 نوعين من المحتويات النائبة، هما: علامة الاستفهام (نمط qmark) ومحتوى نائب مسمّى (نمط التسمية). ينفّذ تابع execute()‎ جملة SQL واحدة، ويطلق التابع تحذيرًا في حال استخدام أكثر من جملة واحدة. يمكن استخدام التابع executescript()‎ لتنفيذ جمل متعددة في استدعاء واحد. أمثلة يبين المثال التالي طريقة استخدام ...

الخاصية outline-color في CSS تضبط لون حدود outline العنصر، التي هي الخطوط التي تُرسَم خارج إطار العنصر border. من المستحسن استخدام الخاصية المختصرة outline عند ضبط مظهر حدود العنصر، لأنها تضبط عدِّة خاصيات في آنٍ واحد. بطاقة الخاصية القيمة الابتدائية currentColor تُطبَّق على جميع العناصر. قابلة للوراثة لا قابلة للحركة نعم القيمة المحسوبة قيمة لونية <color>. /* <color> القيم اللونية */ outline-color: #f92525; outline-color: rgb(30,222,121); outline-color: blue; /* القيم العامة */ outline-color: inherit; outline-color: initial; outline-color: unset; أمثلة سنجعل لون حدود الفقرة <p> الآتية أزرق: <p>لون حدود ...

تحلّل الدالة المدخلات من نوع multipart/form-data (للملفات المرفوعة). البنية العامة cgi.parse_multipart(fp, pdict, encoding="utf-8", errors="replace") المعاملات fp الملف المُدخل. pdict قاموس يحتوي على المعاملات في ترويسة Content-Type. encoding ترميز الطلب. ملاحظة: أضيف المعاملان encoding و errors في الإصدار 3.7 من بايثون. كذلك أصبحت القيمة المعادة للحقول التي لا تتضمن ملفّات قائمة من السلاسل النصية وليس من كائنات bytes. القيمة المعادة تعيد الدالة قاموسًا مشابهًا للقاموس الذي تعيده الدالة urllib.parse.parse_qs()‎. مفاتيح هذا القاموس هي أسماء الحقول في النموذج، وكلّ قيمة في القاموس ...

إن المتغير التكراري Iterable هو شبه نوع (نوع زائف، pseudo-type) عُرِّفَ في الإصدار 7.1 من PHP وهو يقبل أية مصفوفة أو كائن يستخدم واجهة Traversable (أي Traversable interface)، كلا النوعين يمكن تكراره باستخدام حلقة foreach ويمكن أن يُستخدم مع تعبير yield داخل دالة مولِّدة (generator). استخدام Iterables يمكن استخدام Iterable كنوع لمعاملات الدالة (function parameter type) للإشارة إلى الدالة تتطلب مجموعةً من القيم، لكن دون أن تهتم لصيغة القيمة لأنها ستُستخدَم مع حلقة foreach، إذا لم تكن القيم مصفوفة أو ...

إن المتغير التكراري Iterable هو شبه نوع (نوع زائف، pseudo-type) عُرِّفَ في الإصدار 7.1 من PHP وهو يقبل أية مصفوفة أو كائن يستخدم واجهة Traversable (أي Traversable interface)، كلا النوعين يمكن تكراره باستخدام حلقة foreach ويمكن أن يُستخدم مع تعبير yield داخل دالة مولِّدة (generator). استخدام Iterables يمكن استخدام Iterable كنوع لمعاملات الدالة (function parameter type) للإشارة إلى الدالة تتطلب مجموعةً من القيم، لكن دون أن تهتم لصيغة القيمة لأنها ستُستخدَم مع حلقة foreach، إذا لم تكن القيم مصفوفة أو ...

مقدمة بناء مكونات ذات واجهات برمجية متناسقة وثابتة من أسس هندسة البرمجيات، وجعل هذه المكونات قابلةً لإعادة الاستعمال من أحد أكبر أسُسِها كذلك. المكونات التي يُمكنها العمل مع بيانات اليوم كما بيانات المُستقبل ستُعطي إمكانيات مرنةً جدًّا لبناء نظم برمجيات كبيرة. الأنواع المُعمّمة (generics) من الأدوات الرئيسية التي تُساعد على بناء مكوّنات قابلة لإعادة الاستعمال في لغات مثل C#‎ وJava، إذ تُعطي القُدرة على إنشاء مكوّنات يُمكن لها العمل مع عدّة أنواعٍ من البيانات عوضًا عن نوع واحد فقط. ما ...

تسمح لك هذه الدوال بالحصول على معلومات حول الأصناف ونسخ الكائنات. إذ تستطيع الحصول على اسم الصنف الذي ينتمي إليه الكائن. بالإضافة إلى خصائص أعضائه والدوال التابعة له، لا يُمَكّنك استخدام هذه الدوال فقط من اكتشاف عضوية كائن في الصنف، ولكن أيضًا يمكّنك من اكتشاف أصله (أي ما هو الصنف الذي يرثه صنف الكائن). الرجاء الاطلاع على قسم البرمجة كائنية التوجه (OOP) في الموسوعة للحصول على شرح مفصّل لكيفيّة تنفيذ واستخدام الصفوف والكائنات في PHP. أمثلة نُعرّف في هذا المثال ...

الصنف الزائف ‎:disabled في CSS (أي pseudo-class) يُمثِّل أي عنصر مُعطَّل، ولا يمكن اختيار أو النقر على العنصر المعطَّل ولا الكتابة فيه، ولا يقبل التركيز (focus)، ويمكن أن يكون العنصر مُفعَّلًا (enabled) أي يمكن اختياره أو النقر عليه أو الكتابة فيه. input:disabled { background: #ccc; } الشكل العام لهذا المحدد: :disabled أمثلة هذا المثال يستعرض نموذجًا بسيطًا لشحن المشتريات، ويستخدم الحدث change في JavaScript للسماح للمستخدم بتفعيل أو تعطيل بعض حقول النموذج: <form action="#"> <fieldset id="shipping"> <legend>عنوان ...

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