نتائج البحث

مقدمة عند بدء مشروع Laravel جديد تكون معالجة الأخطاء والاستثناءات مُعدّة لك مُسبقا. تُسجّل كافة الاستثناءات التي يطلقها تطبيقك في الصنف App\Exceptions\Handler ثم تُرجع للمُستخدم. سنتعمّق في هذا الصنف أكثر من خلال هذا التوثيق. الضبط يحدد الخيار debug في ملف إعداداتك config/app.php مقدار المعلومات الفعلية التي تُعرض عن الخطأ للمستخدم. يُعد هذا الاختيار إفتراضيًّا ليحترم قيمة متغيّر البيئة APP_DEBUG التي تُخزّن في ملفك env. . عليك وضع قيمة متغير البيئة APP_DEBUG على true عند التطوير المحلّي. يجب أن توضع هذه ...

ما هو DOM الافتراضي (Virtual DOM)؟ DOM الافتراضي (أو اختصارًا VDOM) هو مفهوم برمجي نحتفظ فيه بالتمثيل المثالي أو الافتراضي لواجهة المستخدم ضمن الذاكرة مع مزامنته مع DOM الحقيقي عن طريق مكتبة مثل React DOM. تُدعى هذه العمليّة بالمطابقة (reconciliation). تُمكِّن هذه الطريقة واجهة برمجة التطبيق التصريحية في React، حيث تُخبِر React الحالة التي تريد أن تكون بها واجهة المستخدم لديك، فتحرص React على مطابقة DOM مع تلك الحالة. يُجرِّد هذا التعامل مع الخاصيّات، ومعالجة الأحداث، وتحديث DOM اليدوي الذي ...

التطبيق وحيد الصفحة التطبيق وحيد الصفحة (Single-page Application) هو التطبيق الذي يُحمِّل صفحة HTML واحدة وكل ملحقاتها الضرورية (مثل CSS و JavaScript) المطلوبة لكي يعمل التطبيق. لا تتطلّب أيّة تفاعلات مع الصفحة أو الصفحات اللاحقة أي عودة للخادم مرّة أخرى، ممّا يعني عدم إعادة تحميل الصفحة. بالرغم من قدرتك على بناء تطبيق وحيد الصفحة في React فهو ليس أمرًا ضروريًّا. يُمكِن أيضًا استخدام React لتحسين أجزاء صغيرة من الموقع مع الحصول على تفاعليّة أكبر. يُمكِن للشيفرة المكتوبة باستخدام React أن ...

ماذا يفعل التابع setState؟ يُجدوِل التابع setState()‎ تحديثًا لكائن حالة المكوّن state. عندما تتغير الحالة يستجب المكوّن بإعادة التصيير. ما الفرق بين الحالة state والخاصيّات props؟ الخاصيّات props (اختصارًا للكلمة properties) والحالة state كلاهما عبارة عن كائنات JavaScript مجرّدة. وفي حين أنّ كلاهما يحمل معلومات تؤثر في ناتج التصيير، فهما مختلفان بطريقة واحدة هامة، حيث تُمرَّر الخاصيّات إلى المكوّن (بشكل مماثل لمُعاملات الدالة) بينما تُدار الحالة state ضمن المكوّن (بشكل مشابه للمتغيرات المعرفة بداخل الدالة). هنا تجد مصادر جيدة لقراءة ...

نُفضِّل في معظم الحالات استخدام المُكوّنات المضبوطة من أجل حقول الإدخال، ففي المُكوّنات المضبوطة يتعامل مُكوّن React مع بيانات الحقول. البديل لها هو المُكوّنات غير المضبوطة والتي يتعامل فيها DOM مع بيانات الحقول. لكتابة مُكوّن غير مضبوط بدلًا من كتابة معالج أحداث لكل تحديث للحالة، فبإمكانك استخدام المراجع للحصول على قيم الحقول من DOM. مثلًا تقبل هذه الشيفرة اسمًا واحدًا في المُكوّن غير المضبوط: class NameForm extends React.Component { constructor(props) { super(props); this.handleSubmit ...

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

فلننظر إلى تعريف هذا المتغير: const element = <h1>!أهلًا بالعالم</h1>; إنّ الصّياغة الغريبة السّابقة التي تحتوي على وسم هي ليست سلسلة نصيّة ولا حتى HTML. تُدعى الصّياغة السّابقة JSX وهي عبارة عن امتداد لصياغة JavaScript، نوصي باستخدامها مع React لوصف المظهر الذي ينبغي أن تكون عليه واجهة المستخدم. قد تُذكِّرك JSX بلغات القوالب، ولكنها تمتلك قوة JavaScript الكاملة. تُنتِج JSX عناصر React. سنستعرض إظهار هذه العناصر في DOM في قسم تصيير العناصر (Rendering Elements). سنتحدّث في الفقرات التالية عن أساسيّات JSX ...

تُزوّدنا React بواجهة برمجة تطبيقات (API) صريحة بحيث لا نقلق بشأن التغييرات التي تطرأ في كل تحديث. يجعل هذا من كتابة التطبيقات أمرًا أسهل بكثير، ولكن قد لا يكون من الواضح كثيرًا كيفيّة تطبيق هذا في React. تشرح هذه الصفحة الخيارات التي وضعناها في خوارزمية المقارنة (diffing) بحيث تكون تحديثات المُكوّنات متوقعة وفي نفس الوقت سريعة كفاية لأجل التطبيقات عالية الأداء. البداية عندما تستخدم React في نقطة زمنية محدّدة بإمكانك التفكير في التابع render()‎ كأنّه يُنشِئ شجرة من عناصر React، ...

تُشبه معالجة الأحداث لعناصر React معالجة الأحداث لعناصر DOM، ولكن هنالك فروق تتعلّق بالصياغة: تُسمَّى أحداث React باستخدام حالة الأحرف camelCase (أي عند وجود اسم مؤلف من عدة كلمات نجعل الحرف الأول من الكلمة الأولى بالشكل الصغير أمّا باقي الكلمات نجعل حرفها الأول بالشكل الكبير) بدلًا من استخدام الشكل الصغير للأحرف. نُمرِّر في JSX دالة كمُعالِج للأحداث، بدلًا من سلسلة نصيّة. على سبيل المثال لنأخذ شيفرة HTML التالية: <button onclick="activateLasers()"> تفعيل الليزر </button> تكون الشيفرة السابقة مختلفة قليلًا في React: <button ...

تُشكِّل العناصر أصغر بنية لتطبيقات React. يصف العنصر ما الذي تود رؤيته على الشّاشة: const element = <h1>أهلًا بالعالم</h1>; على عكس عناصر DOM الخاصّة بالمتصفّح، تكون عناصر React عبارة عن كائنات مُجرّدة سهلة الإنشاء، ويعتني React DOM بتحديث DOM لمُطابقة عناصر React. ملاحظة: قد يخلط المرء العناصر مع مفهوم أكثر انتشارًا وهو المُكوِّنات (components)، سنتحدّث عن المُكوِّنات بالتفصيل في القسم الخاص بها. إنّ العناصر هي الشيء الذي تُصنَع منه المُكوِّنات، ومن المُفضَّل أن تقرأ ذلك القسم قبل المتابعة. تصيير العنصر إلى ...

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

إنّ الكائن React هو نقطة الدخول إلى مكتبة React. إن حمّلت React عن طريق العنصر ‎<script>‎ فستكون هذه الواجهة ذات المستوى الأعلى متوفرة عبر الكائن العام React. وإن استخدمت ES6 مع npm فتستطيع كتابة ‎import React from 'react'‎. إن استخدمت ES5 مع npm فتستطيع كتابة ‎var React = require('react')‎. لمحة عامة المكوّنات تُتيح لك مكوّنات React تقسيم واجهة المستخدم إلى قطع مستقلة قابلة لإعادة الاستخدام والتفكير بكل قطعة لوحدها. يُمكِن تعريف مكوّنات React عن طريق أخذ صنف فرعي من React.Component ...

الاستيراد import ShallowRenderer from 'react-test-renderer/shallow'; // ES6 var ShallowRenderer = require('react-test-renderer/shallow'); // ES5 with npm لمحة عامة عند كتابة وحدات اختبار لمكتبة React يكون التصيير السطحي مفيدًا لك. يُتيح لك التصيير السطحي تصيير مكوّن على عمق مستوى واحد وتوضيح الحقائق حول ما يُعيده تابع التصيير، بدون القلق حول سلوك المكوّنات الأبناء والتي لم تُصيَّر أو ينشأ عنها نسخة. لا يحتاج ذلك إلى DOM. على سبيل المثال إن كان لديك المكوّن التالي: function MyComponent() { return ( <div> ...

الدالة البانية Error تُنشِئ كائن خطأ، والنسخ الكائنات من النوع Error ستُرمى عند حدوث أخطاء في وقت التنفيذ (runtime errors)؛ لاحظ أنَّ الكائن Error يُستخدَم أيضًا ككائن أساس للاستثناءات التي يُعرَّفها المستخدم. انظر أدناه للحصول على قائمة بأنواع الأخطاء القياسية المُضمَّنة في اللغة. البنية العامة new Error([message]) message وسيط اختياري، وهو وصفٌ نصيٌّ للخطأ موجَّهٌ للبشر. الوصف الأخطاء التي تحدث في وقت التنفيذ (runtime errors) تؤدي إلى إنشاء ورمي كائنات Error جديدة. أنواع الأخطاء بجانب الدالة البانية Error العامة، هنالك ...

‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎‎.error( handler )‎ القيمة المعادة يُعيد كائنًا من النوع jQuery. أُهمل مع الإصدار: 1.8، وأُزيل مع الإصدار: 3.0. الوصف ربط معالج الحدث بحدث الخطأ "error" في JavaScript. error( handler )‎ أُضيف مع الإصدار: 1.0. handler دالة تنفذ عند تشغيل الحدث وهي على الشكل Function( Event eventObject )‎. ‎.error( [eventData ], handler )‎ أُضيف مع الإصدار: 1.4.3. eventData كائن يحتوي على البيانات التي ستُمرر إلى معالج الحدث، ويمكن أن يكون من أي نوع من أنواع JavaScript. handler دالة تنفذ عند تشغيل ...

تشير القيمة ERROR إلى وجود خطأٍ تولد نتيجة استعمال عنصر مهمل (deprecated element). انظر أيضًا القيمة WARNING: تشير إلى وجود تحذير تولد نتيجة استعمال عنصر مهمل (deprecated element). القيمة HIDDEN: تشير إلى أن العنصر المهمل (deprecated elements) غير متاح للاستخدام ضمن الشيفرة. مصادر صفحة ERROR في التوثيق الرسميّ للمكتبة القياسيّة في لغة Kotlin.

تتيح لغة Kotlin إمكانيّة استهداف لغة JavaScript من خلال تحويل (transpiling) شيفرات Kotlin إلى ما يماثلها في JavaScript ؛ إذ تستهدف بالوقت الحاليّ معيارECMAScript 5.1، ومن المُخطَّط له أيضًا التوافق مع معيار ECMAScript 2015 لاحقًا. عند استخدام لغة Kotlin بهدف كتابة شيفرات JavaScript فستُحوَّل الشيفرات المكتوبة بلغة Kotlin (بعدِّها جزءًا من المشروع والمكتبة القياسيّة في Kotlin) إلى شيفرة JavaScript، ولكنّ هذا لا يشمل أيًّا ممّا يتعلَّق ببيئة JDK أو JVM أو Java أو أيّ من منصّاتها أو مكتباتها المُستخدَمة، ويُستبعَد ...

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

مقدمة لا يفرض Laravel عليك استخدام أي معالج JavaScript و CSS، إلّا إنّه يوفّر نقطة انطلاق بسيطة باستخدام Bootstrap و Vue ممّا سيساعد العديد من التطبيقات. بصفة عامّة، يستخدم Laravel أوامر npm لتنصيب حزم الواجهات الأمامية هذه. CSS يوفّر Laravel Mix واجهة برمجية (API) سهلة ومعبّرة لترجمة Sass أو Less، وهي إضافات للغة CSS الأساسية التي تضيف المتغيّرات والمخاليط (mixins) والعديد من الخصائص الأخرى التي تجعل العمل بلغة CSS أكثر متعة. في هذه الصفحة، سنناقش باختصار ترجمة CSS بصفة عامّة ...

يعيد التابع next_float العدد العشري الذي يلي العدد العشري الذي استُدعي معه. استدعاء التابع next_float مع القيمة الثابتة Float::MAX و Float::INFINITY يعيد القيمة Float::INFINITY الثابتة. استدعاء التابع بالشكل Float::NAN.next_float يعيد القيمة Float::NAN. البنية العامة next_float → float القيمة المعادة يعاد العدد العشري الذي يلي العدد العشري المعطى. أمثلة مثال على استخدام التابع next_float: 0.01.next_float #=> 0.010000000000000002 1.0.next_float #=> 1.0000000000000002 100.0.next_float #=> 100.00000000000001 0.01.next_float - 0.01 #=> 1.734723475976807e-18 1.0.next_float - 1.0 ...

مقدمة Artisan هي واجهة الأوامر المُرفقة ب Laravel. وهي تُوفّر عددًا من الأوامر المفيدة والتي ستساعدك في بناء التطبيق. لإظهار جميع الأوامر التي يوفّرها Artisan، يمكنك استعمال الأمر list php artisan list يحتوي كل أمر على صفحة مساعدة "help" تعرّف وتوضّح الأمر كما تُقدّم قائمة المعاملات والخيارات لكل أمر. يُستعمل الأمر مسبوقًا بالكلمة help لإظهار صفحة المساعدة: php artisan help migrate Laravel REPL تأتي كل تطبيقات Laravel مُرفَقَةً ب Tinker، وهي REPL مشغّلة بواسطة حُزمة PsySH. يسمح Tinker بالتفاعل مع ...

قد تكون التعابير البرمجية في الشيفرة صحيحة من ناحية الصيغة، لكن قد يؤدي تنفيذ تلك الشيفرة إلى التسبب في حدوث الأخطاء. تسمّى الأخطاء المُكتشفة أثناء تنفيذ الشيفرة بالاستثناءات (exceptions) وقد تتسبب في إيقاف عمل البرنامج (fatal) في بعض الأحيان. صيغة الاستثناءات تُنشئ الاستثناءات رسائل خطإٍ مماثلة لما يلي: >>> 10 * (1/0) Traceback (most recent call last):   File "<stdin>", line 1, in <module> ZeroDivisionError: division by zero >>> 4 + spam*3 Traceback (most recent call last):   File "<stdin>", line 1, in <module> NameError: name 'spam' ...

يًطللق الاستثناء SignalException عند تلقي إشارة ما. begin Process.kill('HUP',Process.pid) sleep # wait for receiver to handle signal sent by Process.kill rescue SignalException => e puts "received Exception #{e}" end ‎ سيُنتج عن تنفيذ هذه الشيفرة ما يلي: received Exception SIGHUP توابع الصنف العامة new ينشئ كائنًا جديدًا من النوع SignalException. توابع النسخة العامة signo يعيد رقم إشارة. مصادر صفحة الصنف SignalException في توثيق روبي الرسمي.

يوضح الجدول التالي جميع الخيارات التي يمكن استعمالها مع مترجم TypeScript للتحكم بسير عمله والتعديل على سلوكه أثناء ترجمة الشيفرات. الخيار النوع القيمة الافتراضية الوصف ‎--allowJs‎ ‎boolean‎ ‎false‎ السماح بترجمة ملفّات JavaScript. ‎--allowSyntheticDefaultImports‎ ‎boolean‎ ‎module === "system" ‎ أو أنّ الخيار ‎--esModuleInterop‎ مضبوط وقيمة ‎module‎ ليست ‎es2015‎ أو ‎esnext‎ السماح للاستيرادات الافتراضية من الوحدات التي لا تحتوي على تصديرات افتراضيّة. هذا لا يؤثر على الشيفرة المولَّدة، ويؤثر فقط على آلية التحقق من الأنواع. ‎--allowUnreachableCode‎ ‎boolean‎ ‎false‎ لا تُخبِر عن الأخطاء ...

المشكلة يعيد التابع قيمة خاصة تشير إلى خطأ. الحل إطلاق استثناء بدلًا من ذلك. مثال قبل إعادة التصميم يعيد التابع ()withdraw القيمة 1- التي تمثِّل خطأً إن تحقق شرط محدَّد: في لغة Java: int withdraw(int amount) { if (amount > _balance) { return -1; } else { balance -= amount; return 0; } } في لغة C#‎: int Withdraw(int amount) { if (amount > _balance) { ...

(PHP 5 >= 5.3.0, PHP 7) تُعيد الدالة json_last_error()‎ آخر خطأ حاصل. الوصف int json_last_error ( void )‎ تُعيد آخر خطأ حاصل (إن كان هنالك خطأ) خلال آخر عمليّة ترميز أو فك ترميز لصيغة JSON. المعاملات لا تملك هذه الدالة أي مُعامِلات. القيم المعادة تُعيد عدد صحيح. يُمكن للقيمة أن تكون أحد الثوابت الموجودة في الجدول الآتي، الذي يعرض رموز أخطاء JSON: الثابت المعنى التوافر JSON_ERROR_NONE لم يحصل أي خطأ. JSON_ERROR_DEPTH تم تجاوز القيمة القصوى للعمق. JSON_ERROR_STATE_MISMATCH صيغة JSON غير صالحة. ...

(PHP 4, PHP 5, PHP 7) تَجلُب الدالة fgetss()‎ سطرًا واحدًا من ملف معيَّن وتزيل وسوم HTML من النصِّ الذي تقرؤه. الوصف string fgetss ( resource $handle [, int $length [, string$allowable_tags ]] ) تشبه هذه الدالة تمامًا الدالة fgets()‎ باستثناء أنَّها تحاول إزالة بايتات العدم (NULL)، ووسوم HTML، ووسوم PHP التي تعثر عليها أثناء قراءتها للنص. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎ أو الدالة fsockopen()‎ ولم ...

(PHP 4 >= 4.0.2, PHP 5, PHP 7) تُعيد الدالة get_resource_type()‎‎‎ نوع المورد المُعطى لها. الوصف string get_resource_type ( resource $handle ) تُعطي هذه الدالة نوع المورد المُعطى لها. المعاملات handle مقبض للمورد المطلوب تقييمه. القيم المعادة عندما يكون المقبض handle عبارة عن مورد، فستُعيد هذه الدالة سلسلة نصّيّة تُمثِّل نوعه. وإن لم تتعرّف هذه الدالة على النّوع تكون القيمة المُعادة هي السلسلة النصّيّة Unknown. إن لم يكن المقبض handle موردًا ستولِّد هذه الدالة خطأً وتُعيد القيمة NULL. سجل التغييرات الإصدار ...

(PHP 4, PHP 5, PHP 7) تغلق الدالة fclose()‎ ملفًا مفتوحًا. الوصف bool fclose ( resource $handle ) تغلق هذه الدالة الملف المفتوح الذي يشير إليه المؤشر handle. المعاملات handle مؤشر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎ أو الدالة fsockopen()‎. القيم المعادة تُعاد القيمة TRUE عند نجاح العمليَّة، أو القيمة FALSE خلاف ذلك. أمثلة المثال 1: استعمال الدالة fclose()‎ <?php $handle = fopen('somefile.txt', 'r'); fclose($handle); ?> انظر أيضًا الدالة fopen()‎: تفتح ملفًا جديدًا ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة ftell()‎ الموقع الحالي لمؤشِّر القراءة من أو الكتابة على الملف. الوصف int ftell ( resource $handle ) تعيد هذه الدالة الموقع الحالي لمؤشِّر الملف المُشار إليه باستعمال المورد handle. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎ أو الدالة popen()‎. ستعيد الدالة نتائج غير متوقَّعة عند فتح الملف باستعمال الوضع 'a' (إضافة البيانات إلى الملف فقط). القيم المعادة يُعاد عدد صحيح ...

(PHP 4, PHP 5, PHP 7) تَجلُب الدالة fgetc()‎ محرفًا من ملف محدَّد ثمَّ تعيده. الوصف string fgetc ( resource $handle ) تجلب هذه الدالة محرفًا واحدًا من الملف الذي يشير إليه المورد handle. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎ أو الدالة fsockopen()‎، ولم يُغلق بعد باستعمال الدالة fclose()‎. القيم المعادة تُعاد سلسلة نصيَّة تحتوي على حرف واحد قُرِءَ من الملف الذي يشير إليه المورد handle، أو ...

(PHP 4 >= 4.0.1, PHP 5, PHP 7) تفرِّغ الدالة fflush()‎ ما في مخزن المخرجات في ملف محدَّد. الوصف bool fflush ( resource $handle ) تفرِّغ هذه الدالة جميع المخرجات المخرَّنة في الملف الذي يشير إليه المورد handle. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎ أو الدالة fsockopen()‎ ولم يُغلق بعد باستعمال الدالة fcolse()‎. القيم المعادة تُعاد القيمة TRUE عند نجاح العمليَّة، أو القيمة FALSE خلاف ذلك. أمثلة ...

تفكّ الدالة الضغط عن البايتات في البيانات المعطاة، وتعيد كائن bytes يحتوي على البيانات التي أزيل الضغط عنها. البنية العامة zlib.decompress(data, wbits=MAX_WBITS, bufsize=DEF_BUF_SIZE) ‎ المعاملات wbits يعتمد هذا المعامل على صيغة البيانات المعطاة، وسنتحدث عنه بتفصيل أكبر أدناه. يتحكّم المعامل wbits بحجم ذاكرة تخزين التاريخ history buffer (أو ما يطلق عليه "حجم النافذة window size") المستخدمة في ضغط البيانات، ويتحكّم كذلك فيما إذا كانت مخرجات الدالة تتضمّن ترويسة وتذييلًا. هذا المعامل يشبه نظيره في الدالة compressobj()‎ ولكنّه يأخذ نطاقات أكثر ...

(PHP 4, PHP 5, PHP 7) تفتح الدالة popen()‎ عمليَّة وتشير إليها بمؤشِّر شبيه بمؤشِّر ملف. الوصف resource popen ( string $command , string $mode ) تفتح هذه الدالة أنبوبًا (pipe) يتصل مع العمليَّة المراد تنفيذها باستعمال الأمر command الفرعي المعطى. المعاملات command الأمر المراد تنفيذه. mode يُحدِّد هذا المعامل نوع الوصول المطلوب إلى المجرى. القيم المعادة يُعاد مؤشِّر ملف مطابق تمامًا للمؤشِّر المعاد بوساطة الدالة fopen()‎ باستثناء أنَّه أحادي الاتجاه (unidirectional) (أي يمكن استعماله إمَّا للقراءة أو للكتابة فقط) ويجب ...

مؤشر الاستقرار: 2 - مستقر HTTPS هو بروتوكول HTTP على TLS/SSL. وهو ينفذ كوحدة منفصلة في Node.js. الصنف https.Agent أُضيف مع الإصدار: v0.4.5. كائن وكيل Agent لبروتوكول HTTPS مشابه للوكيل http.Agent. راجع https.request()‎‎ لمزيد من المعلومات. الصنف https.Server أُضيف مع الإصدار: v0.3.4. هذا الصنف هو صنف فرعي من tls.Server ويُطلق الأحداث نفسها كخادم http.Server. راجع http.Server لمزيد من المعلومات. server.close([callback])‎ أُضيف مع الإصدار: v0.1.90. callback من النوع <Function>. راجع server.close()‎‎ من وحدة HTTP لمزيد من التفاصيل. server.listen()‎‎ يبدأ استماع خادم ...

(PHP 4, PHP 5, PHP 7) تغلق الدالة pclose()‎ عمليَّة مفتوحة. الوصف int pclose ( resource $handle ) تغلق هذه الدالة العمليَّة التي يشير إليها المؤشِّر handle والمفتوحة باستعمال الدالة popen()‎. المعاملات handle مؤشِّر (pointer) شبيه بمؤشِّر الملف يشير إلى عمليَّة. يجب أن يكون سليمًا، وأُعيد بطريقة صحيحة باستدعاء الدالة popen()‎. القيم المعادة تُعاد الحالة ذاتها التي تعيدها العمليَّة التي كانت تعمل عند إنهائها. إن وُجد خطأ ما، فستُعاد القيمة ‎-1. ملاحظة: إن صُرِّف مفسِّر PHP‎ مع تمرير الخيار ‎--enable-sigchild، فستكون ...

(PHP 4, PHP 5, PHP 7) تقلِّص الدالة ftruncate()‎ حجم الملف إلى حجم محدَّد. الوصف bool ftruncate ( resource $handle , int $size ) تقلِّص هذه الدالة حجم الملف الذي يشير إليه المورد handle إلى الحجم size المعطى. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. ملاحظة: يجب أن يُفتح الملف في وضع الكتابة. size الحجم المراد تقليص الملف إليه. ملاحظة: إن كان الحجم size المُعطى أكبر من حجم الملف، فسيُمدَّد حجم الملف إلى الحجم size بإضافة بايتات فارغة (null bytes) إليه. ...

(PHP 4, PHP 5, PHP 7) ترجع الدالة rewind()‎ مؤشِّر الملف إلى موقع بداية الملف. الوصف bool rewind ( resource $handle ) ترجع هذه الدالة موقع المؤشِّر للملف الذي يشير إليه المورد handle إلى بداية مجرى الملف. ملاحظة: إن فتحت الملف في وضع إضافة البيانات (الوضع a أو الوضع a+)، فإنَّ أي بيانات تكتبها على الملف ستضاف إلى نهايته دومًا بغض النظر عن موقع المؤشِّر الحالي. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة fstat()‎ معلومات عن ملف باستعمال مؤشِّر ملف مفتوح يشير إليه. الوصف array fstat ( resource $handle ) تجمع هذه الدالة بعض المعلومات الإحصائيَّة عن الملف المفتوح الذي يشير إليه المورد handle. تشبه هذه الدالة إلى حدٍّ كبير الدالة stat()‎ باستثناء أنَّها تتعامل مع مؤشِّر ملف مفتوح عوضًا عن مسار الملف. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎. القيم المعادة تُعاد ...

(‎(PHP 5, PHP 7 تكتب الدالة ‎fprintf()‎ سلسلةً نصيةً منسقةً إلى مجرى (stream) معيّن. الوصف ‎int fprintf ( resource $handle , string $format [, mixed $args [, mixed $... ]] ) تَكتُب الدالة ‎fprintf()‎ سلسلة نصية منسقة وِفق المعامل format إلى مجرى يُحدَّد من المعامل handle. المعاملات handle مؤشر إلى موارد نظام الملفات، الذي يُنشَأ عادةً عبر الدالة fopen()‎. format اطلع على الدالة sprintf()‎ لتفاصيل أكثر عن المعامل format. args أول وسيط مُمرَّر إلى إلى سلسلة التنسيق. … بقية الوسائط المُمرَّرة ...

(PHP 4, PHP 5, PHP 7) تطبع الدالة vfprintf()‎ سلسلةً نصيَّةً بتنسيق معين على مجرى (stream) محدَّد. الوصف int vfprintf ( resource $handle , string $format , array $args ) تطبع هذه الدالة سلسلة نصيَّة بعد أن تنسِّقها وفقًا للتنسيق format إلى المجرى handle المعطى. عمل هذه الدالة شبيه بالدالة fprintf()‎ باستثناء أنَّها تقبل مصفوفةً من المعاملات بدلًا من عدد من المعاملات المتغيِّرة. المعاملات handle إشارة إلى مورد (resource) من نظام الملفات الذي يُنشَأ عادةً باستخدام الدالة fopen()‎‎. format راجع الدالة ...

(PHP 4, PHP 5, PHP 7) تَجلُب الدالة fgetcsv()‎ سطرًا واحدًا من ملف ذي الصيغة CSV (اختصارًا للعبارة comma-separated values) وتحلِّله ثمَّ تعيد مصفوفة بالقيم التي قرأتها. الوصف array fgetcsv ( resource $handle [, int $length = 0 [, string$delimiter = "," [, string $enclosure = '"' [, string $escape = "\\"]]]] ) تشبه هذه الدالة إلى حدٍّ كبير الدالة fgets()‎ باستثناء أنَّها تحلِّل السطر الذي تجلبه من ملف بصيغة CSV إلى حقول ثمَّ تعيد مصفوفةً تحوي تلك الحقول التي قرأتها ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة dir()‎ نسخةً (instance) من الصنف Directory. الوصف Directory dir ( string $directory [, resource $context ] ) تملك هذه الدالة آلية شبه كائنيَّة التوجه لقراءة المجلَّد. سيُفتح المجلد directory المعطى. المعاملات directory مسار المجلَّد المراد فتحه. context ملاحظة: أُضيف دعم المحتوى منذ إصدار PHP 5.0.0. راجع قسم المجرى (stream) للمزيد من الشرح عن المحتوى (context). القيم المعادة تُعاد نسخةٌ من الصنف Directory عند نجاح العمليَّة، أو القيمة NULL إن كان هنالك خطأ في ...

(PHP 4, PHP 5, PHP 7) تَجلُب الدالة fgets()‎ سطرًا واحدًا من ملف معيَّن. الوصف string fgets ( resource $handle [, int $length ] ) تجلب هذه الدالة سطرًا واحدًا من الملف الذي يشير إليه المورد handle. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎ أو الدالة fsockopen()‎ ولم يُغلق بعد باستعمال الدالة fclose()‎. length إن حُدِّدت قيمة هذا المعامل، فستتوقف عمليَّة القراءة عند البايت length - 1 أو ...

(PHP 4, PHP 5, PHP 7) تتحقَّق الدالة feof()‎ من الوصول إلى نهاية ملف (EOF) بتمرير المقبض الذي يشير إلى الملف. الوصف bool feof ( resource $handle ) تتحقَّق هذه الدالة من الوصول إلى نهاية ملف (EOF) بتمرير المقبض handle الذي يشير إلى الملف. المعاملات handle مقبض (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎ أو الدالة fsockopen()‎، ولم يُغلق بعد باستعمال الدالة fclose()‎. القيم المعادة تُعاد القيمة TRUE إن وصل مقبض ...

مؤشر الاستقرار: 2 - مستقر. توفر الوحدة net واجهة تطبيقات لشبكة اتصال غير متزامن لإنشاء خوادم قائمة على تدفق اتصالات TCP أو IPC أي (net.createServer()‎) والعملاء (net.createConnection()‎). ويمكن الوصول إليه باستخدام: const net = require('net'); دعم اتصالات IPC تدعم وحدة net اتصالات IPC بواسطة الأنابيب المُسماة (named pipes) في ويندوز، أو مقابس مجالات يونكس (UNIX domain sockets) في أنظمة التشغيل الأخرى. تحديد مسارات اتصالات IPC تحتاج التوابع net.connect()‎ و net.createConnection()‎ و server.listen()‎ و socket.connect()‎ المعامل path لتحديد نهايات اتصالات IPC. ...

مقدمة يوفّر Laravel Mix واجهة برمجية (API) واضحة لتعريف خطوات بناء Webpack للتطبيق باستعمال العديد من المعالجات المسبقة (pre-processors) للغتي CSS و Javascript. باستخدام سلسلة بسيطة من استدعاءات التوابع، يمكن تعريف مسار معالجة الأصول (assets) في التطبيق. فمثلًا: mix.js('resources/assets/js/app.js', 'public/js') .sass('resources/assets/sass/app.scss', 'public/css'); إن أصبحت مرتبكا و مشوشا حول البدء مع Webpack وترجمة الأصول، فسوف تحب Laravel Mix. لكنك لست مطالبًا باستعمالها لبناء تطبيقك. طبعًا لك حرية اختيار أي مسار لمعالجة الأصول تريده، أو أن لا تستعمل أيًا منها على ...

هذا الصنف هو صنف أساسي مجرّد يستخدم لتشغيل تطبيقات WSGI. تعالج كل نسخة من هذا الصنف طلب HTTP منفردًا، ولكن يمكن إنشاء صنف فرعي بمقدوره التعامل مع طلبات متعددة. توابع الصنف BaseHandler تمتلك نسخ BaseHandler تابعًا واحدًا فقط وهو معدّ للاستخدام الخارجي: التابع run()‎ يشغّل التابع تطبيق WSGI المعطى. تنفّذ جميع توابع BaseHandler الأخرى بواسطة هذا التابع أثناء عملية تشغيل التطبيق؛ لذا فإنّ الهدف الرئيسي من هذا التابع هو إتاحة القدرة على تخصيص هذه العملية. يجب إعادة تعريف التوابع التالية ...

(PHP 4, PHP 5, PHP 7) مقدمة تُنشأ نُسخ (instances) الصنف Directory باستدعاء الدالة dir()‎ وليس باستعمال الكلمة المفتاحية new. ملخص الصنف Directory { // الخاصِّيات public string $path ; public resource $handle ; // التوابع public void close ([ resource $dir_handle ] ) public string read ([ resource $dir_handle ] ) public void rewind ([ resource $dir_handle ] ...

الخاصية Object.prototype.constructor تُعيد مرجعيةً إلى الدالة البانية Object التي تُنشِئ نسخةً (instance) من الكائن؛ لاحظ أنَّ قيمة هذه الخاصية تُشير إلى الدالة نفسها وليست سلسلةً نصيةً تحتوي على اسم الدالة؛ وتكون هذه القيمة للقراءة فقط في القيم الأوليّة مثل 1 و true و "test". الوصف جميع الكائنات تملك الخاصية constructor، والكائنات المُنشأة دون استخدام الدالة البانية مباشرةً (أي الشكل المختصرة لإنشاء الكائنات والمصفوفات) ستملك الخاصية constructor التي تُشير إلى الدالة البانية الأساسية لنوع الكائنات التي تتبع له. var o = ...

(PHP 4, PHP 5, PHP 7) تطبع الدالة fpassthru()‎ جميع محتويات الملف المتبقِّية على المخزن المؤقت للخرج. الوصف int fpassthru ( resource $handle ) تقرأ هذه الدالة الملف الذي يشير إليه المورد handle من موقع المؤشِّر الحالي وحتى نهاية الملف (EOF) ثمَّ تكتب هذه البيانات المقروءة على المخزن المؤقت للخرج. قد تحتاج إلى استدعاء الدالة rewind()‎ لإعادة موقع المؤشِّر إلى بداية الملف إن أضفت بعض البيانات إلى هذا الملف. إن أردت طباعة كامل محتوى الملف على المخزن المؤقت للخرج دون التعديل ...

(PHP 4, PHP 5, PHP 7) تقرأ الدالة fread()‎ من ملف معيَّن بطريقة آمنة ثنائيًّا. الوصف string fread ( resource $handle , int $length ) تقرأ هذه الدالة عددًا محدودًا من البايتات (التي تحدَّدها قيمة المعامل length) من الملف الذي يشير إليه المورد handle. ستتوقَّف عمليَّة القراءة حال تحقُّق أحد الشروط التالية: إكمال قراءة البايتات التي تحدِّدها قيمة المعامل length. الوصول إلى نهاية الملف (EOF). حزمة من البيانات أًصبحت متاحة أو انتهاء مهلة المقبس (socket، وذلك عند القراءة من مجرى شبكة). ...

(PHP 4 >= 4.0.1, PHP 5, PHP 7) تحلِّل الدالة fscanf()‎ المدخلات من الملف وفقًا لتنسيق محدَّد. الوصف mixed fscanf ( resource $handle , string $format [, mixed &$... ] ) تشبه هذه الدالة الدالة sscanf()‎ باستثناء أنَّها تأخذ مدخلاتها من الملف الذي يشير إليه المورد handle ثمَّ تُفسِّر هذه المدخلات وفقًا للتنسيق format المُعطى الذي شُرح بالتفصيل في صفحة الدالة sprintf()‎. ملاحظة: أيُّ فراغ أبيض (whitespace) موجود في السلسلة النصيَّة format سيتطابق مع أي محرف فراغ أبيض يُعثر عليه في ...

(PHP 4, PHP 5, PHP 7) تنسِّق الدالة fputcsv()‎ سطرًا واحدًا من البيانات بالصيغة CSV (اختصارًا للعبارة comma-separated values) ثمَّ تكتبه على الملف. الوصف int fputcsv ( resource $handle , array $fields [, string $delimiter = "," [, string $enclosure = '"' [, string $escape_char = "\\" ]]] ) تنسق هذه الدالة سطرًا من البيانات المُمرَّرة عبر المصفوفة fields بالصيغة CSV ثمَّ تكتبها على الملف الذي يشير إليه المورد handle (بعد أن تضيف في نهاية ذلك السطر محرف سطر جديد). المعاملات ...

(PHP 4, PHP 5, PHP 7) تكتب الدالة fwrite()‎ على ملف معيَّن بطريقة آمنة ثنائيًّا. الوصف int fwrite ( resource $handle , string $string [, int $length ] ) تكتب هذه الدالة محتوى السلسلة النصيَّة string على الملف الذي يشير إليه المورد handle. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎. string السلسلة النصيَّة المراد كتابتها على الملف. length إن أُعطيت قيمة هذا المعامل، فستتوقف عمليَّة القراءة عند كتابة ...

(PHP 4, PHP 5, PHP 7) تحرِّك الدالة fseek()‎ مؤشِّر الملف الحالي إلى موقع محدَّد. الوصف int fseek ( resource $handle , int $offset [, int $whence = SEEK_SET ] ) تغيِّر هذه الدالة دليل موقع المؤشِّر للملف الذي يشير إليه المورد handle. يُحدَّد الموقع الجديد للمؤشِّر، والذي يقاس بالبايت انطلاقًا من بداية الملف، بإضافة قيمة الإزاحة offset إلى الموقع الذي يُحدِّده المعامل whence. يُسمح عمومًا بالانتقال إلى موقعٍ يأتي بعد نهاية الملف (EOF). إن أُضيفت بيانات إلى ذاك الموقع، فإنَّ ...

مقدمة تُوفِّر البرمجيّات الوسيطة آلية ملائمة لفرز الطلبات HTTP التي تدخل تطبيقك. على سبيل المثال، يحتوي Laravel على برمجيّّة وسيطة تتحقق إن كان مستخدم تطبيقك مصادقا عليه (authenticated). في حالة لم يكن مصادقا عليه، تعيد البرمجيّة الوسيطة توجيهه لصفحة تسجيل الدخول. في حالة كان مصادقا عليه، ستسمح البرمجيّة للطلب بالمرور لسائر التطبيق. يمكن طبعا كتابة برمجيّات وسيطة للقيام بمهام متنوعة عديدة عدا تسجيل الدخول. قد تكون برمجيّة CORS وسيطة مسؤولة عن إضافة الترويسات (headers) المناسبة لكل الردود التي يرسلها تطبيقك. ...

الاستقرار: 2-مستقر تعمل نسخةٌ واحدةٌ من Node.js في خيط (thread) واحد. للاستفادة من الأنظمة ذات الأنوية المتعدِّدة (multi-core)، سيضطر المستخدم حينها إلى تشغيل عنقود من عمليات Node.js لمعالجة الحمل. تسمح الوحدة cluster بإنشاء عمليات أبناء بسهولة تتشارك جميعها منافذ الخادم نفسها. const cluster = require('cluster'); const http = require('http'); const numCPUs = require('os').cpus().length; if (cluster.isMaster) { console.log(`Master ${process.pid} is running`); // (worker) تفريع مسار العمليات العاملة for (let i = 0; i < numCPUs; i++) { cluster.fork(); ...

ستواجه التطبيقات التي تعمل في Node.js عمومًا أربع فئات من الأخطاء هي: أخطاء JavaScript القياسية مثل <EvalError>، و <SyntaxError>، و <RangeError>، و <ReferenceError>، و <TypeError>، و <URIError>. أخطاء النظام التي أُطلقَت بوساطة قيود نظام التشغيل الضمنيَّة (operating system constraints) مثل محاولة فتح ملف غير موجود أو محاولة إرسال بيانات عبر مقبسٍ مغلق. أخطاء محددة من طرف المستخدم تُطلَق عبر شيفرة التطبيق. أخطاء التوكيد AssertionError‎ وهي صنفٌ مخصصٌ من الأخطاء يُطلَق عندما تكتشف Node.js مخالفة منطقية استثنائية لا يجب أن تحدث ...

الدالة Error.prototype.toString()‎ تُعيد سلسلةً نصيةً تُمثِّل كائن Error المُحدَّد. البنية العامة e.toString() القيمة المعادة سلسلة نصيّة تُمثِّل كائن Error المعطي. الوصف يُعيد الكائن Error تعريف الدالة toString الموروثة من الكائن Object؛ وتستخدم هذه الدالة قيمة الخاصيتين name و message لتركيب السلسلة النصية. تكون بنية هذه الدالة البرمجية كما يلي: Error.prototype.toString = function() { 'use strict'; var obj = Object(this); if (obj !== this) { throw new TypeError(); } var name = this.name; ...

يمكن تمرير المعلومات إلى الدوالّ بواسطة قائمة المعاملات argument list، وهي قائمة من التعابير المفصولة بالعلامة (,)، وتُعالج هذه المعاملات من اليسار إلى اليمين. تدعم اللغة تمرير المعاملات بالقيمة (by value، والطريقة الافتراضية) وبالمرجعية وتدعم كذلك تعيين القيمة الافتراضية للمعاملات، إضافة إلى دعم قوائم المعاملات متغيّرة الأطوال. المثال 1: تمرير المصفوفات إلى الدوال <?php function takes_array($input) { echo "$input[0] + $input[1] = ", $input[0]+$input[1]; } ?> تمرير المعاملات بالمرجعية تمرّر معاملات الدوال بصورة افتراضية عن طريق القيمة (بمعنى أنّه لو تغيّرت ...

يمكن تمرير المعلومات إلى الدوالّ بواسطة قائمة المعاملات argument list، وهي قائمة من التعابير المفصولة بالعلامة (,)، وتُعالج هذه المعاملات من اليسار إلى اليمين. تدعم اللغة تمرير المعاملات بالقيمة (by value، والطريقة الافتراضية) وبالمرجعية وتدعم كذلك تعيين القيمة الافتراضية للمعاملات، إضافة إلى دعم قوائم المعاملات متغيّرة الأطوال. المثال 1: تمرير المصفوفات إلى الدوال <?php function takes_array($input) { echo "$input[0] + $input[1] = ", $input[0]+$input[1]; } ?> تمرير المعاملات بالمرجعية تمرّر معاملات الدوال بصورة افتراضية عن طريق القيمة (بمعنى أنّه لو تغيّرت ...

يمكن تمرير المعلومات إلى الدوالّ بواسطة قائمة المعاملات argument list، وهي قائمة من التعابير المفصولة بالعلامة (,)، وتُعالج هذه المعاملات من اليسار إلى اليمين. تدعم اللغة تمرير المعاملات بالقيمة (by value، والطريقة الافتراضية) وبالمرجعية وتدعم كذلك تعيين القيمة الافتراضية للمعاملات، إضافة إلى دعم قوائم المعاملات متغيّرة الأطوال. المثال 1: تمرير المصفوفات إلى الدوال <?php function takes_array($input) { echo "$input[0] + $input[1] = ", $input[0]+$input[1]; } ?> تمرير المعاملات بالمرجعية تمرّر معاملات الدوال بصورة افتراضية عن طريق القيمة (بمعنى أنّه لو تغيّرت ...

urllib هي حزمة تتضمّن مجموعة من الوحدات التي تتعامل مع عناوين URL: الوحدة urllib.request: تقدّم الوحدة عددًا من الدوال والأصناف التي تساعد في فتح عناوين URL‏ (HTTP في الغالب) لاستخدامها في عمليات مختلفة مثل الاستيثاق البسيط وإعادة التوجيه والتعامل مع الكعكات cookies وغيرها. الوحدة urllib.error: تعرّف الوحدة الأصناف الخاصة بالاستثناءات التي تُطلقها الوحدة urllib.request. الوحدة urllib.parse: تعرّف هذه الوحدة واجهة معيارية لتحليل عناوين URL. الوحدة urllib.robotparser: تقدّم الوحدة صنفًا واحدًا يساعد في تحليل ملفات robots.txt. مصادر صفحة URL handling modules ...

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

jQuery.readyException( error )‎ القيم المعادة يعيد مُحدِّدًا (Selector). الوصف يعالج هذا التابع الأخطاء التي رميت في الدوال المُغلَّفَة في jQuery()‎ بشكل متزامن. jQuery.readyException( error )‎ أُضيفت مع الإصدار: 3.1. error خطأٌ رُمِيَ في الدالة المُغلَّفَة في jQuery()‎. يُطلق هذا التابع عدما يُرمَى خطأٌ في الدالة المغلَّفة في jQuery()‎ أو jQuery( document ).ready()‎ أو ما شابههما. يعيد هذا التابع افتراضيًّا رَمْيَ الخطأ عىل شكل timeout وبذلك يُسجل دخولها إلى الطرفيَّة (console) وتمرَّر إلى window.onerror بدلًا من اختفائها دون سدًى. استَبدل هذا ...

jQuery.readyException( error )‎ القيم المعادة يعيد مُحدِّدًا (Selector). الوصف يعالج هذا التابع الأخطاء التي رميت في الدوال المُغلَّفَة في jQuery()‎ بشكل متزامن. jQuery.readyException( error )‎ أُضيفت مع الإصدار: 3.1. error خطأٌ رُمِيَ في الدالة المُغلَّفَة في jQuery()‎. يُطلق هذا التابع عدما يُرمَى خطأٌ في الدالة المغلَّفة في jQuery()‎ أو jQuery( document ).ready()‎ أو ما شابههما. يعيد هذا التابع افتراضيًّا رَمْيَ الخطأ عىل شكل timeout وبذلك يُسجل دخولها إلى الطرفيَّة (console) وتمرَّر إلى window.onerror بدلًا من اختفائها دون سدًى. استَبدل هذا ...

الخاصية Error.prototype.name تُمثِّل اسم نوع الخطأ، والقيمة الابتدائية لها هي "Error". الوصف تُعطى لكائنات Error الخاصية name ولها القيمة "Error". تُستخدَم الخاصية message مع الخاصية name من الدالة Error.prototype.toString()‎ لإنشاء تمثيل نصي للخطأ. أمثلة المثال الآتي يرمي خطأً خاصًا أنشأه المستخدم: var e = new Error('Malformed input'); // e.name: 'Error' e.name = 'ParseError'; throw e; // e.toString(): 'ParseError: Malformed input' دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari الدعم الأساسي نعم نعم 6 نعم نعم مصادر ومواصفات مسودة المعيار ECMAScript Latest Draft. ...

تتحقَّق الدالة feature_exists()‎ ما إذا كانت ميزة معيَّنةٌ موجودةٌ في وقت تشغيل Sass. الميزات المدعومة هي: global-variable-shadowing: تشير إلى أنّ متغيرًا محليًا سيحجب متغيرًا عامًّا ما لم تُستخدم ‎!global. extend-selector-pseudoclass: تشير إلى أنّ ‎@extend ستصل إلى محدِّدات الأصناف الزائفة (pseudoclasses) مثل ‎:not. units-level-3: تشير إلى الدعم الكامل للعمليات الحسابيَّة على الواحدات (unit arithmetic) باستخدام الواحدات المُعرّفة في المواصفة Values and Units Level 3. at-error: تشير إلى أنّ التعليمة ‎@error مدعومة. custom-property: تشير إلى أن مواصفات الخاصِّيَّات المُخصّصة مدعومة. هذا يعني ...

الاستقرار: 2-مستقر توفِّر الوحدة assert مجموعةً من اختبارات التوكيد البسيطة التي يمكن استعمالها للتأكد من الثوابت (invariants). يوجد وضعي توكيد هما: الوضع الصارم (strict mode)، والوضع الإرثي (legacy mode)؛ وينصح باستعمال الوضع الصارم فقط. للمزيد من المعلومات حول موازنات التساوي المستعملة، ارجع إلى دليل MDN حول موازنات التساوي والتشابه. الصنف assert.AssertionError أضيف في الإصدار v0.1.21. يتفرَّع هذا الصنف الفرعي من الصنف Error الذي يشير إلى فشل عمليَّة التوكيد. جميع الأخطاء التي ترميها الوحدة assert هي نسخةٌ من الصنف AssertError. new ...

يأخذ العامل (operator) قيمة واحدة أو أكثر (أو تعابير حسب اصطلاحات البرمجة) ويعطي قيمة أخرى (بحيث تتحول البنية نفسها إلى تعبير). يمكن تصنيف العوامل بحسب عدد القيم التي تأخذها، فالعوامل الأحادية Uanry تأخذ قيمة واحدة فقط مثل العامل (!) (معامل النفي المنطقي) أو (++) (معامل الزيادة). أما العوامل الثنائية فتأخذ قيمتين، وخير مثال عليها هو العوامل الحسابية المعروفة (+) الجمع، و (-) الطرح، إضافة إلى غالبية العوامل التي تقدّمها لغة PHP. وأخيرًا هناك معامل ثلاثي وحيد وهو ? : ويأخذ قيمًا ثلاثة، ...

يغير التابع handle_interrupt توقيت المقاطعة غير المتزامنة (asynchronous interrupt timing). المقاطعة (interrupt) يعني الحدث غير المتزامن (asynchronous event) والإجراء المقابل raise و kill وإشارة المسك (signal trap، غير مدعومة حاليًا) وعملية إنهاء المهمة الفرعية الرئيسية (عند إنهاء المهمة الفرعية الرئيسية، فسيتم إنهاء كل المهام الفرعية الأخرى). البنية العامة handle_interrupt(hash) { ... } → result of the block‎ يحتوي المعامل hash المعطى على أزواج على شاكلة ExceptionClass => :TimingSymbol إذ ExceptionClass هو مقاطعة (interrupt) المٌعالج من قبل الكتلة المعطاة. أما TimingSymbol فيمكن أن يكون ...

الثوابت المعرَّفة مسبقًا الثوابت المعرَّفة مسبقًا الخاصَّة بهذا الملحق. chdir()‎ تغيِّر مجلَّد PHP الحالي إلى مجلَّد آخر معطى. chroot()‎ تغيِّر مجلَّد الجذر (root directory) الحالي. closedir()‎ تغلق مجلَّدًا مفتوحًا. dir()‎ تعيد نسخةً (instance) من الصنف Directory. getcwd()‎ تعيد مجلَّد العمل الحالي. opendir()‎ تفتح مجلَّدًا محدَّدًا. readdir()‎ تقرأ عنصرًا واحدًا من محتويات المجلَّد وتعيده. rewinddir()‎ ترجع مؤشِّر مجرى المجلَّد إلى موقع بداية المجلَّد. scandir()‎ تعيد أسماء جميع الملفات والمجلَّدات الموجودة في مجلَّد محدَّد. الصنف Directory تُنشأ نُسخ (instances) الصنف Directory باستدعاء ...

مؤشر الاستقرار: 2 - مستقر. توفر وحدة dgram تطبيق مقابس مخطط البيانات UDP. const dgram = require('dgram'); const server = dgram.createSocket('udp4'); server.on('error', (err) => { console.log(`server error:\n${err.stack}`); server.close(); }); server.on('message', (msg, rinfo) => { console.log(`server got: ${msg} from ${rinfo.address}:${rinfo.port}`); }); server.on('listening', () => { const address = server.address(); console.log(`server listening ${address.address}:${address.port}`); }); server.bind(41234); // الخادم يستمع 0.0.0.0:41234 الصنف: dgram.Socket أُضيف مع الإصدار: v0.1.99. كائن dgram.Socket هو EventEmitter يغلف وظيفة مخطط البيانات. وتُنشأ حالات جديدة من dgram.Socket باستخدام التابع dgram.createSocket()‎. ولا يمكن استخدام الكلمات الرئيسية ...

الاستقرار: 2-مستقر توفِّر الوحدة child_process القدرة على توليد (spawn) عمليات أبناء بطريقةٍ مشابهةٍ  -وليست مماثلة- للدالة popen(3)‎، إذ يمكن للدالة child_process.spawn()‎ أن توفِّر هذه الإمكانيَّة في المقام الأول: const { spawn } = require('child_process'); const ls = spawn('ls', ['-lh', '/usr']); ls.stdout.on('data', (data) => { console.log(`stdout: ${data}`); }); ls.stderr.on('data', (data) => { console.log(`stderr: ${data}`); }); ls.on('close', (code) => { console.log(`child process exited with code ${code}`); }); تُنشَأ أنابيبٌ (pipes) لمجرى الدخل القياسي (stdin) ومجرى الخرج القياسي (stdout) ومجرى الخطأ القياسي (stderr) بين العمليَّة الأب في Node.js ...

مقدمة توفّر أحداث Laravel تطبيق مراقب بسيط  يسمح بالإشتراك والاستماع لعدّة أحداث يطلقها التطبيق. تُخزَّن أصناف الأحداث في الدليل app/Events، في حين توجد المنصتات في app/Listeners. لا تقلق إن لم تجد هذه الدلائل في التطبيق إذ تُصنع حين تولّد أحداثًا و منصتات باستعمال أوامر artisan. الأحداث طريقة ممتازة لفك ارتباط عدّة عناصر من التطبيق حيث يمكن أن يكون لحدث واحد عدّة منصتات منفصلة كليا عن بعضها البعض. مثلًا، قد تريد إرسال إعلان slack للمستخدم كلما شحن طلب. بدل ربط معالجة ...

الخاصية Error.prototype تُعيد كائن prototype للكائن Error. سمات الخاصية Error.prototype قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط لا الوصف الكائنات المُنشَأة من الدالة البانية Error ترث من Error.prototype؛ لاحظ أنَّه من غير الممكن تغيير قيمة الخاصية Error.prototype؛ لكن يمكن إضافة خاصيات ودوال إليها لكي تتوافر في جميع الكائنات المُنشَأة من الدالة البانية Error. الخاصيات Error.prototype.constructor تُحديد الدالة التي ستُنشِئ كائن prototype لكائنات Error؛ راجع صفحة الخاصيةObject.prototype.constructor لمزيدٍ من التفاصيل. Error.prototype.message رسالة الخطأ. Error.prototype.name اسم الخطأ. الدوال Error.prototype.toString()‎ إعادة سلسلة نصيّة ...

تدعم Sass جميع قواعد CSS التي تبدأ بالرمز @، فضلًا عن أخرى خاصَّة بلغة Sass تسمى بالتعليمات (directives). لهذه القواعد تأثيرات مختلفة في Sass سنفصلها بعد قليل. انظر أيضًا تعليمات التحكم (control directives) وتعليمات المخاليط (mixin directives). القاعدة ‎@import توسّع Sass استخدامات القاعدة ‎@import الخاصَّة بلغة CSS للسماح لها باستيراد ملفات SCSS وملفات Sass. ستُدمج جميع ملفات SCSS وملفات Sass المُستورَدة معًا في ملف CSS واحدٍ. إضافةً إلى ذلك، يمكن استخدام المتغيرات أو المخاليط (mixins) المُعرّفة في الملفات المستوردة في ...

تستبدل الدالة الحروف الخاصة في السلسلة النصية المعطاة باستخدام علامة التهريب ‎%xx. البنية العامة urllib.parse.quote(string, safe='/', encoding=None, errors=None) ‎المعاملات safe يحدّد هذا المعامل محارف ASCII الإضافية التي يجب على الدالة أن لا تحيطها بعلامات اقتباس. يحمل هذا المعامل القيمة الافتراضية '/'. string يمكن أن يكون سلسلة نصية أو كائن bytes. ملاحظة: اعتُمد المعيار RFC 3986 عوضًا عن المعيار RFC 2396 لاقتباس سلاسل URL النصية في الإصدار 3.7 من بايثون، وقد أضيف الرمز "~" إلى مجموعة المحارف المحجوزة. encoding و errors ...

المورد هو متغير خاص يحمل مرجعيةً إلى مورد خارجي، تُنشَأ الموارد وتُستخدَم باستعمال دوال خاصة، اطلع على الملحق للحصول على قائمة تضم جميع الدوال مع نوع المورد المناسب. اطلع على الدالة get_resource_type()‎ أيضًا. التحويل إلى مورد لا يمكن تحويل القيم من الأنواع الأخرى إلى موارد، فهذه المتغيرات تحمل مقابض (handles) خاصة لفتح الملفات، اتصالات قاعدة البيانات، مناطق الصورة … تحرير الموارد بفضل نظام عدّ المراجع (reference-counting system) الموجود في محرك Zend، ستُكتَشَف الموارد التي لا تمتلك مرجع إليها تلقائيًا، ,وتُحرَّر ...

المورد هو متغير خاص يحمل مرجعيةً إلى مورد خارجي، تُنشَأ الموارد وتُستخدَم باستعمال دوال خاصة، اطلع على الملحق للحصول على قائمة تضم جميع الدوال مع نوع المورد المناسب. اطلع على الدالة get_resource_type()‎ أيضًا. التحويل إلى مورد لا يمكن تحويل القيم من الأنواع الأخرى إلى موارد، فهذه المتغيرات تحمل مقابض (handles) خاصة لفتح الملفات، اتصالات قاعدة البيانات، مناطق الصورة … تحرير الموارد بفضل نظام عدّ المراجع (reference-counting system) الموجود في محرك Zend، ستُكتَشَف الموارد التي لا تمتلك مرجع إليها تلقائيًا، ,وتُحرَّر ...

تطبع الدالة تقويم السنة كاملة والذي تعيده الدالة calendar()‎. البنية العامة calendar.prcal(year, w=0, l=0, c=6, m=3) المعاملات year السنة المطلوبة. w معامل اختياري يأخذ القيمة الافتراضية 0، ويحدّد عرض التقويم الذي ستطبعه الدالة. l معامل اختياري يأخذ القيمة الافتراضية 0، ويحدّد مقدار الفاصل بين الأسطر في التقويم الذي ستطبعه الدالة. c معامل اختياري يأخذ القيمة الافتراضية 6، ويحدّد مقدار الفاصل بين الأعمدة في التقويم. m معامل اختياري يأخذ القيمة الافتراضية 3، ويحدّد عدد الأشهر في كل صفٍّ من صفوف التقويم. ...

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

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

يُعيد التابع inspect سلسلة نصية تمثل التوقيت الذي استدعي معه. هذا التابع مكافئ لاستدعاء التابع strftime مع سلسلة التنسيق المناسبة. البنية العامة inspect → string‎ القيمة المعادة تعاد سلسلة نصية تمثل التوقيت المعطى. أمثلة مثال على استخدام التابع inspect: t = Time.now t.to_s => "2012-11-10 18:16:12 +0100" t.strftime "%Y-%m-%d %H:%M:%S %z" => "2012-11-10 ...

يتحقق التابع pending_interrupt?‎ مما إذا كان طابور الانتظار غير المتزامن (asynchronous queue) فارغًا أم لا للمهمة الفرعية التي استُدعي معها. راجع صفة تابع الصنف pending_interrupt?‎. البنية العامة pending_interrupt?(error = nil) → true/false‎ المعاملات error إذا تم إعطاء هذا المعامل، فيتحقق فقط من الأحداث المؤجلة التي من نوع error. القيمة الافتراضية لهذا المعامل هي: nil. القيمة المعادة تعاد القيمة true إذا كان طابور الانتظار غير المتزامن (asynchronous queue) فارغًا. خلا ذلك، تعاد القيمة false. انظر أيضًا التابع priority: يُعيد أولوية المهمة الفرعية ...

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

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

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

يمكن تعريف قابلية رؤية خاصية أو تابع أو (بدءًا من الإصدار 7.1.0 من اللغة) ثابت بأنّها إلحاق صيغة التصريح بإحدى الكلمات المفتاحية public، أو protected، أو private. يتيح التصريح من نوع public الوصول إلى أعضاء الصنف من أي مكان، ويتيح التصريح من نوع protected الوصول إلى الأعضاء من داخل الصنف نفسه أو الأصناف التي ترث الصنف أو تورّثه، أما التصريح من نوع private فيتيح الوصول إلى الأعضاء من داخل الصنف الذي عرِّف فيه ذلك العضو حصرًا. قابلية رؤية الخاصية يجب ...

يمكن تعريف قابلية رؤية خاصية أو تابع أو (بدءًا من الإصدار 7.1.0 من اللغة) ثابت بأنّها إلحاق صيغة التصريح بإحدى الكلمات المفتاحية public، أو protected، أو private. يتيح التصريح من نوع public الوصول إلى أعضاء الصنف من أي مكان، ويتيح التصريح من نوع protected الوصول إلى الأعضاء من داخل الصنف نفسه أو الأصناف التي ترث الصنف أو تورّثه، أما التصريح من نوع private فيتيح الوصول إلى الأعضاء من داخل الصنف الذي عرِّف فيه ذلك العضو حصرًا. قابلية رؤية الخاصية يجب ...

قد تكون أخطاء الصيغة (Syntax errors) أو ما يعرف أيضًا بأخطاء الإعراب (Parsing errors) هي أكثر نوع من الأخطاء التي يواجهها المبتدئون عند تعلّم بايثون: >>> while True print('Hello world')   File "<stdin>", line 1     while True print('Hello world')                    ^ SyntaxError: invalid syntax يعيد المفسّر (parser) طباعة الجملة التي تحتوي على الخطأ مع سهم صغير يشير إلى مكان الخطأ ضمن السطر. ويكون الخطأ ناتجًا عن (أو اكتشف في) المكان الذي يسبق السهم. في المثال السابق ...

الخاصية Error.prototype.message تُمثِّل رسالةً نصيّةً تشرح الخطأ، وهي قابلةٌ للقراءة من البشر. الوصف هذه الخاصية تحتوي على وصفٍ قصيرٍ للخطأ إن كان متوافرًا. تُستخدَم الخاصية message مع الخاصية name من الدالة Error.prototype.toString()‎ لإنشاء تمثيل نصي للخطأ. افتراضيًا، تكون قيمة الخاصية message هي سلسلةٌ نصيّةٌ فارغة، لكن يمكن تغيير قيمتها عند إنشاء الكائن Error بتمرير سلسلة نصية كأوّل معامل إلى الدالة البانية Error. أمثلة المثال الآتي يرمي خطأً خاصًا أنشأه المستخدم: var e = new Error('Could not parse input'); // e.message: ...

قد تكون أخطاء الصيغة (Syntax errors) أو ما يعرف أيضًا بأخطاء الإعراب (Parsing errors) هي أكثر نوع من الأخطاء التي يواجهها المبتدئون عند تعلّم بايثون: >>> while True print('Hello world')   File "<stdin>", line 1     while True print('Hello world')                    ^ SyntaxError: invalid syntax يعيد المفسّر (parser) طباعة الجملة التي تحتوي على الخطأ مع سهم صغير يشير إلى مكان الخطأ ضمن السطر. ويكون الخطأ ناتجًا عن (أو اكتشف في) المكان الذي يسبق السهم. في المثال السابق ...

يحول التابع to_s التوقيت المعطى إلى سلسلة نصية. وهو مكافئ لاستدعاء التابع strftime مع سلسلة تنسيق مناسبة. البنية العامة to_s → string‎ القيمة المعادة تعاد سلسلة نصية تمثل التوقيت المعطى. أمثلة مثال على استخدام التابع to_s: t = Time.now t.to_s => "2012-11-10 18:16:12 +0100" t.strftime "%Y-%m-%d %H:%M:%S %z" => "2012-11-10 18:16:12 +0100" t.utc.to_s ...

الدالة String.prototype.charCodeAt()‎ تُعيد عددًا صحيحًا بين 0 و 65535 يُمثِّل رمز UTF-16 للمحرف الموجود عند الفهرس المُعيّن (لاحظ أنَّ رمز UTF-16 سيُطابِق رمز المحرف القابل للتمثيل كمحرف واحد في UTF-16، لكن سيُطابِق أوّل قسم من زوجَيّ الرموز للمحارف التي لا يمكن تمثيلها كرمز واحد في UTF-16 مثل رموز يونيكود الأكبر من 0x10000). إذا أردَت الحصول على كامل قيمة الرمز فاستخدم الدالة codePointAt()‎. البنية العامة str.charCodeAt(index) index عدد صحيح بين 0 و length -1. وإذا لم توفَّر قيمة لهذا الوسيط، فالقيمة ...

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

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

ينشئ التابع سلسلة ذاكرة نصية من كائن TarInfo. البنية العامة TarInfo.tobuf(format=DEFAULT_FORMAT, encoding=ENCODING, errors='surrogateescape') ‎المعاملات ‎لمزيد من المعلومات حول معاملات هذا التابع راجع الدالة البانية للصنف TarFile. ملاحظة: في الإصدار 3.2 من بايثون تستخدم القيمة 'surrogateescape' كقيمة افتراضية للمعامل errors. مصادر صفحة Read and write tar archive files في توثيق بايثون الرسمي.

يستخدم هذا الصنف ملفًّا ثنائيًا يقرأ منه تدفق البيانات المسلسلة. يجري الكشف عن رقم البروتوكول المستخدم تلقائيًا؛ لذا لا حاجة لأي معامل لتحديده. البنية العامة class pickle.Unpickler(file, *, fix_imports=True, encoding="ASCII", errors="strict") ‎المعاملات file يجب أن يمتلك المعامل file تابعين، الأول هو تابع read()‎ والذي يأخذ معاملًا عدديًا، وتابع readline()‎ والذي لا يحتاج إلى أيّ معاملات. يجب أن يعيد كلا المعاملين كائنات bytes، ولهذا يمكن أن يكون file كائن ملف مخزّنًا على القرص الصلب ومفتوحًا للقراءة الثنائية، أو كائن io.BytesIO أو ...