نتائج البحث

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

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

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

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

مقدمة يوفر Laravel خدمات تسجيل صلبة (robust) تسمح لك بتسجيل الرسائل في ملفّات، و سجّل أخطاء النظام، وحتى بتطبيق Slack لإعلام فريقك بأكمله وذلك لمساعدتك على معرفة المزيد حول ما يحدث داخل تطبيقك. يستخدم Laravel وراء الكواليس مكتبة Monolog التي توفر الدعم لمجموعة متنوعة من معالجات السجل القوية. يجعل Laravel إعداد هذه المُعالجات سهلة للغاية، ممّا يسمح لك بالتنسيق بينهم لتخصيص معالجة سجل تطبيقك. الضبط توجد كل إعدادات نظام تسجيل تطبيقك في ملف الإعدادات config/logging.php. يتيح لك هذا الملف إعداد ...

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

تدعم SassScript تعليمات وتعابير التحكم التي تُستعمل لرَهن تفعيل الأنماط بشروط معيّنةٍ أو لتضمين نفس النمط لكن مع تطبيق بعض التنويعات عليه. ملاحظة: تعليمات التحكم هي ميزة متقدمةٌ، كما أنّها غير شائعة الاستخدام. وُجدت أساسًا لتُستعمل في المخاليط (mixins)، لاسيما تلك التي هي جزءٌ من المكتبات مثل Compass، لذلك فهي تتطلب مرونةً كبيرةً في التعامل معها. if()‎ تُعيد الدالة المضمّنة if()‎ إحدى قيمتين محدَّدتين بناءً على شرط معيّن، ويمكن استخدامها في أيّ سياق برمجي. لا تتحقق الدالة if إلا من ...

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

سنتطرق في هذه الصفحة إلى شرح بقية الصيغ والبنى المستعملة في روبي والتي لم تُشمَل في الأقسام السابقة. ستجد هنا شرحًا حول الصيغة المستعملة في إنهاء التعبيرات البرمجية في روبي، وكيفية استعمال المسافات البادئة بالإضافة إلى شرح الكلمات المفتاحية alias، و undef، و ?defined، و BEGIN، و END. إنهاء تعبير برمجي يعدّ السطر الجديد في لغة روبي إنهاءًا للتعبير البرمجيّ السابق. وإذا انتهى السطر بعملية أو قوس مفتوح أو فاصلة أو ما شابه، فسيستمرّ التعبير البرمجيّ إلى السطر التالي. كما ...

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

من مشاكل الشيفرات أيضًا التطبيقُ الخطأ وغير المكتمل لمبادئ البرمجة كائنية التوجّه (Object-Oriented)، مثل: استخدام الأصناف البديلة (alternative) ذات الواجهات (interfaces) المختلفة المشكلة: التطابق بالمهام ما بين صنفين ولكن بأسماءٍ مختلفةٍ لتوابعهما. الحل: حذف أحد الصنفين بعد تنفيذ إحدى الحلول الآتية: إعادة تسمية التوابع (methods) لتصبح متطابقةً بكافّة الأصناف البديلة، أو توحيد التوقيع (signature) وتعريف الاستخدام ما بين التوابع (إمّا بنقل التابع أو إضافة المعاملات أو دمج التوابع عبر المعاملات)، أو استخراج صنفٍ أعلى وجعلهما صنفين فرعيين له (إن كان التطابق جزئيًا). الوراثة الفائضة (refused bequest) ...

توصيف المشكلة وجود تركيبٍ معقَّدٍ لتعليمة switch أو عدّة تعليمات if متسلسلة. أسبابها ما يميِّز البرمجة كائنيّة التوجّه (OO) هو اعتمادها النادر على المعاملين switch و case، إذ تُوزَّع شيفرة switch بمواقع مختلفة من البرنامج بدلًا من تجمعيها في تعليمة switch واحدةٍ، وعند إضافة شرطٍ جديدٍ عليك إيجاد كافّة شيفرات switch لتعديلها، وكقاعدة عامّة: وجود تعليمة switch يعني أن عليك البدء بالتفكير بمبدأ التعدديّة الشكليّة (polymorphism). وما الحل؟ عزل تعليمة switch ووضعها بالصنف الصحيح عبر إنشاء صنفٍ (class) ونقل التابع ...

يمكن تعريف دوالّ خاصَّةٍ بك في Sass واستخدامها في أيِّ سياق أو على أيّ قيمة داخل الملف البرمجي مثل: $grid-width: 40px; $gutter-width: 10px; @function grid-width($n) { @return $n * $grid-width + ($n - 1) * $gutter-width; } #sidebar { width: grid-width(5); } ستُصبح الشيفرة بعد تصريفها: #sidebar {  width: 240px; } لاحظ أنَّه يمكن للدوال الوصول إلى كل المتغيرات العامَّة وقبول الوسائط كما تفعل المخاليط (mixins). قد تحتوي الدالة على العديد من العبارات البرمجيَّة، ويجب استدعاء ‎@return لتعيد الدالة قيمة محدَّدة. كما هو الحال في المخاليط، ...

تعيد الدالة keywords()‎ خريطة (map) تحتوي على الوسائط المسماة المُمرّرة إلى دالة أو مخلوط (mixin)، والذي يتطلب تمرير قائمة متغيرةً من الوسائط. أسماء الوسائط هي سلاسل نصيةٌ ولا تحتوي على البادئة $. البنية العامة keywords($args) المعاملات ‎$args قائمة متغيرة من الوسائط. القيم المعادة تُعاد خريطة تحتوي على الوسائط المسماة المُمرّرة إلى الدالة أو المخلوط آنذاك. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن لم يكن المعامل ‎$args قائمةً متغيرة من الوسائط. أمثلة مثال عن استخدام الدالة keywords()‎ مع قاعدة ‎@debug: @mixin foo($args...) { @debug ...

يتيح الامتداد JSON معالجة صيغة تبادل البيانات JavaScript Object Notation (اختصارًا JSON) في لغة PHP. يُعالَج فك تّرميز JSON في الإصدار الخامس من PHP بواسطة مُحلِّل اعتمادًا على الأداة JSON_checker التي أنشأها Douglas Crockford، بينما يأتي الإصدار السّابع من PHP مع مُحلِّل مُحسَّن وجديد تمامًا مكتوب خصّيصًا لأجل PHP ومُرخَّص بموجب رخصة PHP. مُلاحظة: تعتمد PHP مجموعة عُليا من JSON كما هو مُحدَّد في المعيار الأصلي RFC 7159. json_decode()‎ تفك ترميز سلسلة نصية بصيغة JSON. json_encode()‎ تُعيد قيمة ما على ...

برنامج الصدفة هو سلسلة من الأوامر يعاد استخدامها بشكل متكرر، ووُضعت في ملف نصي له إذن تنفيذ كبرنامج، ويمكن استخدام أي محرر نصي لكتابة برامج لصدفة Bash. تبدأ برامج bash بـ !# متبوعيْن بمسار الصفة التي ستنفذ الأوامر التي ستُكتب في البرنامج، وتضاف التعليقات إلى البرنامج للمرجعية فيما بعد ولتيسير فهم الشيفرة على من يقرؤها. يُفضل الإسهاب في التعليقات داخل برامج الصدفة على الإيجاز فيها. تُنقَّح الصدفة باستخدام خيارات الصدفة، ويمكن استخدام تلك الخيارات للتنقيح الجزئي أو لتحليل الشيفرة كاملة، ...

(PHP 4, PHP 5, PHP 7) تقدّم PHP صيغة مختلفة لبعض بنى التحكّم المتوفّرة فيها، وهي if و while و for و foreach و switch. وفي جميع الأحوال يمكن استخدام الصيغة البديلة بوضع نقطتين رأسيتين (:) بدلًا من القوس المعقوف في بداية العبارة ووضع العبارة endif;‎ أو endwhile;‎ أو endfor;‎ أوendforeach; ‎ أو endswitch;‎ في النهاية حسب الحاجة. <?php if ($a == 5): ?> A is equal to 5 <?php endif; ?> في المثال السابق أُدخلِت كتلة HTML والتي تتضمن الجملة "A ...

(PHP 4, PHP 5, PHP 7) تقدّم PHP صيغة مختلفة لبعض بنى التحكّم المتوفّرة فيها، وهي if و while و for و foreach و switch. وفي جميع الأحوال يمكن استخدام الصيغة البديلة بوضع نقطتين رأسيتين (:) بدلًا من القوس المعقوف في بداية العبارة ووضع العبارة endif;‎ أو endwhile;‎ أو endfor;‎ أوendforeach; ‎ أو endswitch;‎ في النهاية حسب الحاجة. <?php if ($a == 5): ?> A is equal to 5 <?php endif; ?> في المثال السابق أُدخلِت كتلة HTML والتي تتضمن الجملة "A ...

تستخدم التعابير النمطية لمطابقة مجموعة من الحروف في السلاسل النصية، وتسمح الدوال في هذه الوحدة بالتحقق من تطابق سلسلة نصّية معينة مع التعبير النمطي المعطى (أو من تطابق التعبير النمطي المعطى مع سلسلة نصّية معينة، والنتيجة في كلتا الحالتين واحدة). يمكن ربط التعابير النمطية بعضها ببعض لتكوين تعابير نمطية جديدة، فعلى سبيل المثال إن كان A و B تعبيرين نمطيين فإنّ AB هو تعبير نمطيّ أيضًا. وبصورة عامة، إن كانت السلسلة p تطابق التعبير النمطي A وكانت سلسلة نصية أخرى ...

تتحقَّق الدالة function_exists()‎ إذا كانت دالةٌ ما موجودةً أم لا. البنية العامة function_exists($name) المعاملات ‎$name اسم أو مرجع الدالة المراد التحقُّق من وجودها. القيم المعادة تُعاد القيمة المنطقيَّة TRUE إذا كانت الدالة مُعرّفةً. خلا ذلك، تُعاد القيمة FALSE. أمثلة مثال عن استخدام الدالة function_exists()‎ لمعرفة إن كانت الدالة myfunc التي عرّفها المستخدم موجودةً أم لا: // تعريف الدالة myfunc @function myfunc() { @return "something"; } @if function_exists(myfunc) { @debug "myfunc exists!"; } يمكن أيضًا استخدام الدالة function_exists()‎. لمعرفة إن كانت الدالة content_exists()‎ متوافرةً أم لا ...

يغطي هذا الدليل ميزات التخطيط الأساسية لوحدتي التحكم والعرض. بعد قراءة هذا الدليل، ستتعلم: كيفية استخدام توابع التصيير المختلفة المضمنة ‎في ريلز. كيفية إنشاء تخطيطات (layouts) تحتوي على أقسام محتوى متعددة. كيفية استخدام الأجزاء مع واجهات العرض. كيفية استخدام تخطيطات متداخلة (قوالب فرعية). نظرة عامة: كيف تتراكب قطع الأحجية معًا يركز هذا الدليل على التفاعل بين المتحكم والعرض في نمط التصميم Model-View-Controller. كما تعلم، فإنَّ المتحكم مسؤول عن تنظيم العملية الكاملة للتعامل مع الطلب في ريلز، على الرغم من أنه ...

الخاصية العامة undefined تُمثِّل القيمة الأوليّة undefined في JavaScript. سمات الخاصية undefined قابلة للكتابة لا قابلة للإحصاء لا قابلة للضبط لا البنية العامة undefined الوصف الخاصية undefined هي خاصيةٌ للكائن العام (global object) أي أنها متغيرٌ في المجال العام، والقيمة الابتدائية للخاصية undefined هي نوع البيانات الأوليّ undefined. الخاصية undefined غير قابلة للضبط وغير قابلة للكتابة في المتصفحات الحديثة (بدءًا من معيار ECMAScript 5)، لكن مع ذلك حاول تجنّب الكتابة عليها. المتغيرات التي لم تُسنَد لها قيمةٌ سيكون نوعها هو ...

يقدّم هذا الدليل التقنيات اللازمة لتنقيح تطبيقات ريلز. بعد قراءة هذا الدليل، ستتعلّم: الغرض من التنقيح. كيفة تتبّع العلل والأخطاء التي لا تتعرّف عليها الاختبارات في تطبيقك. طرقًا مختلفة للتنقيح. كيفيّة تحليل أثر المكدس. مساعدي العرض للتنقيح احدى المهام الشائعة في التنقيح هي فحص محتويات متغيّر معيّن، لذا يوفر ريلز ثلاثة طرائق لفعل ذلك: Debug To_yaml Inspect debug سيعيد المساعد debug الوسم <pre> الذي يصدّر الكائن باستخدام تنسيق YAML، وسيؤدي هذا إلى توليد بيانات يمكن للإنسان قراءتها من أي كائن. ...

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

الدالة Symbol()‎ تُعيد قيمةً من النوع symbol، وتملك هذه الدالة خاصيات ساكنة (static properties) ودوال ساكنة (التي تُستخدَم للوصول إلى سجل الرموز العام، أي global symbol registry، ويسمى أيضًا بالمصطلح symbol table)؛ وهذه الدالة تحاول التشبه بالدوال البانية للكائنات، لكنها ليست دالةً بانيةً لعدم القدرة على استخدام المعامل new معها كما في new Symbol()‎. كل رمز (symbol) مُعاد من الدالة Symbol()‎ هو رمزٌ فريد؛ ويمكن أن يُستخدَم كمُعرِّف (identifier) لخاصيات الكائنات، وهذا هو الغرض الرئيسي من هذا النوع من البيانات. ...

تدعم PHP عاملًا واحدًا للتحكّم بالأخطاء وهو علامة (@). تتجاهل PHP جميع الأخطاء الناتجة من أي تعبير تُلحق به هذه العلامة. إن كنت قد عينت دالة خاصة للتعامل مع الأخطاء باستخدام set_error_handler()‎ فستستدعى تلك الدالة حتى مع استخدام هذا العامل، ولكن يمكن للدالة الخاصة (بل ويجدر بها) أن تستدعي الدالة error_reporting()‎ والتي ستعيد 0 عندما يكون الاستدعاء المتسبب في حدوث الخطأ مسبوقًا بعلامة @. إن كانت الخاصية track_errors مفعّلة فإن أيّ رسالة خطأ تنشأ من التعبير ستحفظ في المتغير ‎$php_errormsg، ...

تدعم PHP عاملًا واحدًا للتحكّم بالأخطاء وهو علامة (@). تتجاهل PHP جميع الأخطاء الناتجة من أي تعبير تُلحق به هذه العلامة. إن كنت قد عينت دالة خاصة للتعامل مع الأخطاء باستخدام set_error_handler()‎ فستستدعى تلك الدالة حتى مع استخدام هذا العامل، ولكن يمكن للدالة الخاصة (بل ويجدر بها) أن تستدعي الدالة error_reporting()‎ والتي ستعيد 0 عندما يكون الاستدعاء المتسبب في حدوث الخطأ مسبوقًا بعلامة @. إن كانت الخاصية track_errors مفعّلة فإن أيّ رسالة خطأ تنشأ من التعبير ستحفظ في المتغير ‎$php_errormsg، ...

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

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

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

(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 غير صالحة. ...

تحوّل الدالة ()ie_hex_str اللون إلى صيغة تفهمها الخاصِّيَّة filters في المتصفح IE. البنية العامة ie_hex_str($color) المعاملات ‎$color اللون المراد تعديله. القيم المعادة تُعاد سلسلة نصيَّة تمثِّل اللون ‎$color بصيغة تناسب المتصفح IE. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إذا لم يكن ‎$color لونًا. انظر أيضًا الدالة adjust_hue()‎: تغير قيمة الصبغة (hue). الدالة adjust_color()‎: تغير قيمة اللون. مصادر قسم الدالة ie_hex_str في صفحة الدوال في توثيق Sass الرسمي.

مقدمة كثيرًا ما يكون ترقيم الصفحات في الأطر الأخرى متعبًا جدًا. هنا في Laravel، دُمج مُرقّم صفحات Laravel مع منشئ الاستعلامات و رابط الكائنات بالعلاقات Eloquent، وهو يوفّر ترقيم صفحات لنتائج قواعد البيانات سهل الاستخدام فورًا. يتوافق HTML المُنشئ بواسطة مُرقّم الصفحات مع إطار عمل Bootstrap CSS. الاستخدام الأساسي ترقيم نتائج صفحات منشئ الاستعلام هناك عدّة طرق لترقيم العناصر. أبسطها باستخدام التابع paginate على منشئ الاستعلامات أو Eloquent الاستعلامات. يهتم التابع paginate تلقائيًا بإعداد الحد و والإزاحة (offset) المناسبة استنادًا ...

درجة الثبات: 2 - مستقر كثيرًا ما نحتاج لتنقيح الشيفرات ومراجعتها من الأخطاء، لذلك يتضمن Node.js أداة تنقيح مستقلة يمكن الوصول إليها من خلال محقق V8 inspector وعميل تنقيح مدمج. لاحظ أن عميل تنقيح Node.js هنا هو أداة بسيطة وليست منقّحًا كامل الخصائص، لكنها تكفي في حالة تفحص خطوات تنفيذ الشيفرة. سنستخدم في مثالنا هذا ملف myscript: // myscript.js ‎global.x = 5; setTimeout(() => {  console.log('world'); }, 1000)‎; console.log('hello'); كما ترى، المثال المستخدم هنا بسيط، حيث يبدأ في السطر الأول بتحديد متغير عام x بقيمة 5، ...

الضبط كيفية ضبط لغة PHP عبر مختلف أنواع ملفات الضبط، وطرائق تعديلها. بنية اللغة تبيان أنواع وسوم لغة PHP، وطريقة دمجها مع HTML، وشرح بعض خصائصها البنيوية (ومن بينها التعليقات). أنواع البيانات لا يعيّن المبرمج نوع المتغير عادةً، بل تُعيِّنُه لغة PHP أثناء التنفيذ بالاعتماد على محتوى المتغير المستخدم. القيم المنطقية (boolean) القيم المنطقية (boolean) من أبسط الأنواع، فالتعبير المنطقي يُعبِّر عن صحّة تعبيرٍ ما، فإما أن تكون قيمة التعبير صحيحةً TRUE أو خطأً FALSE. الأعداد الصحيحة (integer) العدد الصحيح هو عدد من ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة filegroup()‎ رقم معرِّف المجموعة المالكة (group ID) لملف محدَّد. الوصف int filegroup ( string $filename ) تعيد هذه الدالة رقم معرِّف المجموعة المالكة (GID) للملف filename في الصيغة العدديَّة. استعمل الدالة posix_getgrgif()‎ للحصول على اسم المجموعة بناءً على رقم المعرِّف GID الذي تعيده هذه الدالة. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. القيم المعادة يُعاد رقم معرِّف المجموعة المالكة (GID) للملف filename أو القيمة FALSE عند حصول أي خطأ. استعمل الدالة posix_getgrgif()‎ ...

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

تتحقَّق الدالة 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: تشير إلى أن مواصفات الخاصِّيَّات المُخصّصة مدعومة. هذا يعني ...

تتحقَّق الدالة comparable()‎ ما إذا كان بالإمكان جمع أو طرح أو موازنة العددين الممرَّرين إليها. البنية العامة comparable($number1, $number2) المعاملات ‎$number1 العدد الأول. ‎$number2 العدد الثاني. القيم المعادة تُعاد القيمة المنطقيَّة TRUE إن كان بالإمكان جمع أو طرح أو موازنة العددين ‎$number2 و ‎$number1. خلا ذلك، تعاد القيمة FALSE. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إذا كان أحد المعاملين السابقين من النوع الخطأ. أمثلة أمثلة عن استخدام الدالة comparable()‎ على أعداد لها مختلف الوحدات: comparable(2px, 1px) // true comparable(100px, 3em) // false comparable(10cm, 3mm) // true تذكّر أنَّ ...

يستخدم التابع str.format()‎ والصنف Formatter صيغة سلاسل التنسيق النصية ذاتها، (ولكن يمكن للأصناف الفرعية في الصنف Formatter أن تعرّف الصيغة الخاصّة بها). ترتبط هذه الصيغة بحروف سلاسل التنسيق النصية، ولكن هناك بعض الاختلافات. تتضمّن سلاسل التنسيق "حقول استبدال" محاطة بالأقواس المعقوفة {}، ويعدّ كل شيء خارج هذه الأقواس حرفًا اعتياديًا ويُنسخ إلى المخرجات دون أي تعديل. إن كانت هناك حاجة إلى استخدام الأقواس المعقوفة ضمن النص فيمكن تهريبها بمضاعفتها: {{ و }}. الصيغة العامة لحقل الاستبدال الصيغة العامة لحقل الاستبدال ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة fileowner()‎ رقم معرِّف المستخدم المالك (usre ID) لملف محدَّد. الوصف int fileowner ( string $filename ) تعيد هذه الدالة رقم معرِّف المستخدم المالك (UID) للملف filename في الصيغة العدديَّة. استعمل الدالة posix_getpwuid()‎ للحصول على اسم المستخدم المالك بناءً على رقم المعرِّف GID الذي تعيده هذه الدالة. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. القيم المعادة يُعاد رقم معرِّف المستخدم المالك (UID) للملف filename أو القيمة FALSE عند حصول أي خطأ. استعمل الدالة ...

قد تكون التعابير البرمجية في الشيفرة صحيحة من ناحية الصيغة، لكن قد يؤدي تنفيذ تلك الشيفرة إلى التسبب في حدوث الأخطاء. تسمّى الأخطاء المُكتشفة أثناء تنفيذ الشيفرة بالاستثناءات (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' ...

(PHP 5 >= 5.2.0, PHP 7, PECL json >= 1.2.0) تفك الدالة json_decode()‎ ترميز سلسلة نصية بصيغة JSON. الوصف mixed json_decode ( string $json [, bool $assoc = FALSE [, int $depth = 512 [, int $options = 0]]] ) تأخذ سلسلة مُرمَّزة بصيغة JSON وتحوِّلها إلى مُتغيِّر PHP. المعاملات json سلسلة نصية بصيغة JSON التي سيُفكُّ ترميزها. تعمل هذه الدّالّة مع سلاسل نصّيّة مُرمَّزة بترميز UTF-8 فقط. ملاحظة: تعتمد PHP مجموعة عُليا من JSON كما هو مُحدَّد في المعيار ...

ينفذ التابع system الأمر المُمرَّر إليه في صدفة فرعية (subshell). البنية العامة system([env,] command... [,options]) → true, false or nil‎ المعاملات env‎ بيئة التنفيذ. يعد هذا المعامل الذي من النوع Hash مماثلة تمامًل لمعامل التابع exec و spawn. انظر صفحة spawn لمزيد من التفاصيل. command...‎ التعليمة المراد تنفيذها. تأخذ التعليمة command…‎ أحد الأشكال التالية. شكل المعامل command…‎ الوصف commandline تعليمة نصية تُمرر إلى الصدفة القياسية cmdname, arg1, ...‎ تعليمة نصية تُمرر إلى الصدفة القياسية ‎[cmdname, argv0], arg1, ...‎ تعليمة ووسيط ...

(PHP 7 >= 7.1.0) تُحوِّلُ الدالةُ sapi_windows_cp_conv()‎ السلسلةَ النصية من صيغتها في جدول ترميز (code page) إلى صيغتها في جدول ترميز آخر. الوصف string sapi_windows_cp_conv ( int|string $in_codepage , int|string $out_codepage , string $subject ) تُحوِّلُ الدالةُ sapi_windows_cp_conv()‎ السلسلةَ النصية من صيغتها في جدول ترميز إلى صيغتها في جدول ترميز آخر. المعاملات in_codepage صيغة جدول الترميز للسلسلة النصية المضافة للمعامل subject. إما اسم جدول الترميز أو مُعرفه. out_codepage جدول الترميز الذي ستحول إليه سلسلة المعامل subject النصية. إما اسم جدول الترميز ...

نمط Strict أتى في معيار ECMAScript 5 لإضافة «صرامة» في تطبيق شيفرات JavaScript، لاحظ أنَّ نمط strict لا يُشكِّل قسمًا فرعيًا من JavaScript، وإنما له بنية خاصة به تختلف عن الشيفرات العادية. فالمتصفحات التي لا تدعم نمط strict ستُشغِّل الشيفرات بطريقة مختلفة عن المتصفحات التي تدعمه، لذا لا تعتمد على نمط strict دون اختبار دعمه أولًا من المتصفح. نمط Strict يُضيف عددًا من التغييرات على بنية JavaScript، فلم تعد تسكت JavaScript عن الأخطاء وإنما أصبحت ترمي استثناءات عند حدوثها؛ ونمط ...

الأعداد العشرية (تعرف أيضا بالأعداد الحقيقة real number أو doubles أو float) ويمكن تعريفها باستخدام إحدى الصيغ التالية: <?php $a = 1.234; $b = 1.2e3; $c = 7E-10; ?> بشكل رسمي: LNUM [0-9]+ DNUM ([0-9]*[\.]{LNUM}) | ({LNUM}[\.][0-9]*) EXPONENT_DNUM [+-]?(({LNUM} | {DNUM}) [eE][+-]? {LNUM}) حجم الأعداد الكسرية يختلف حسب المنصة، رغم أن الحد الأقصى هو ‎~1.8e308 مع دقةٍ تقارب 14 رقم بعد الفاصلة (تنسيق 64 بت في ...

الأعداد العشرية (تعرف أيضا بالأعداد الحقيقة real number أو doubles أو float) ويمكن تعريفها باستخدام إحدى الصيغ التالية: <?php $a = 1.234; $b = 1.2e3; $c = 7E-10; ?> بشكل رسمي: LNUM [0-9]+ DNUM ([0-9]*[\.]{LNUM}) | ({LNUM}[\.][0-9]*) EXPONENT_DNUM [+-]?(({LNUM} | {DNUM}) [eE][+-]? {LNUM}) حجم الأعداد الكسرية يختلف حسب المنصة، رغم أن الحد الأقصى هو ‎~1.8e308 مع دقةٍ تقارب 14 رقم بعد الفاصلة (تنسيق 64 بت في ...

تُعيدُ الدالة ()saturation قيمة مُكوّن التشبُّع (saturation) للون الممرَّر إليها. البنية العامة saturation($color) المعاملات ‎$color القيمة اللونيَّة التي نريد الحصول على مكوِّن التشبُّع الخاص بها. القيم المعادة تُعاد قيمة التشبّع للون ‎$color، وتكون بين %0 و %100. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن لم يكن ‎$color لونًا. أمثلة مثال عن استخدام الدالة saturation()‎ لمقارنة تشبّع اللون المُعرَّف من المستخدم بالقيمة 50% باستخدام التعليمة ‎@if، ثم اعتمادًا على نتيجة الشرط السابق فسنجعل اللون أكثر تشبعًا (باستخدام الدالة saturate()‎) أو أقل تشبعًا (باستخدام الدالة desaturate()‎): $color: salmon; .selector { // ...

تُعيدُ الدالة ()lightness مُكوّن السطوع (lightness) للون الممرَّر إليها. البنية العامة lightness ($color) المعاملات ‎$color القيمة اللونيَّة التي نريد الحصول على مكوِّن السطوع الخاص بها. القيم المعادة تُعاد قيمة السطوع، وتكون بين ‎0% و ‎100%. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن لم يكن المعامل ‎$color لونًا. أمثلة مثال عن استخدام الدالة lightness()‎ لمقارنة إضاءة اللون المُعرَّف من المستخدم باللون الفضي باستخدام التعليمة ‎@if، ثم اعتمادًا على نتيجة الشرط السابق فسنجعل اللون أغمق (باستخدام الدالة darken()‎) أو أفتح (باستخدام الدالة lighten()‎): $color: ...

مقدمة يقدم Laravel محرّك قولبةٍ بسيطاً لكن قويٌّ و فعّال هو Blade. على خلاف محرّكات PHP أخرى، لا يمنع Blade المستخدم من استعمال شيفرات PHP في الواجهة، بل إنّه يحوِِّل صفحات Blade إلى شيفرة PHP ويخزِّنها تخزينًا مؤقتًا إلى حين تغييرها. ممّا يعني أنّ Blade لا يتطلب أيّ جهد أو وقت إضافي من التطبيق. تنتهي صفحات Blade بالامتداد blade.php. وتوجد عادة في مجلد resources/views. توريث القوالب تعريف التخطيط إنّ من الفوائد الأساسية لاستخدام Blade هي توريث القوالب (template inheritance) واستخدام ...

مقدمة يقدم Laravel محرّك قولبةٍ بسيطاً لكن قويٌّ و فعّال هو Blade. على خلاف محرّكات PHP أخرى، لا يمنع Blade المستخدم من استعمال شيفرات PHP في الواجهة، بل إنّه يحوِِّل صفحات Blade إلى شيفرة PHP ويخزِّنها تخزينًا مؤقتًا إلى حين تغييرها. ممّا يعني أنّ Blade لا يتطلب أيّ جهد أو وقت إضافي من التطبيق. تنتهي صفحات Blade بالامتداد blade.php. وتوجد عادة في مجلد resources/views. توريث القوالب تعريف التخطيط إنّ من الفوائد الأساسية لاستخدام Blade هي توريث القوالب (template inheritance) واستخدام ...

طريقة الاستعمال وتشغيل الأمثلة (Usage & Example) تبيّن هذه الصفحة طريقة استعمال Node.js وكيفية تشغيل الأمثلة الخاصة بها. اختبارات التوكيد (Assertion Testing) توفِّر الوحدة assert مجموعةً من اختبارات التوكيد البسيطة التي يمكن استعمالها للتأكد من الثوابت (invariants). الخطافات غير المتزامنة (async_hooks) توفِّر الوحدة async_hooks واجهة برمجية (API) لتسجيل دوال ردود النداء التي تتعقَّب دورة حياة (lifetime) الموارد غير المتزامنة (asynchronous resources) المُنشأَة داخل تطبيقات Node.js. الصنف Buffer أُنشِئ الصنف Buffer ليكون جزءًا من واجهة Node.js البرمجيَّة من أجل التعامل مع المجاري الثمانيَّة (octet streams) ...

يتوافر العديد من خيارات سطر الأوامر التي يمكن استعمالها مع Node.js. تُستعمَل هذه الخيارات في تنقيح أخطاء الشيفرة، والتحكم في كيفيَّة تنفيذ الشيفرة، وغيرها من الأمور المفيدة. يمكن عرض هذا التوثيق في الطرفيَّة عبر استعمال الأمر man node. البنية العامة node [options] [V8 options] [script.js | -e "script" | -] [--] [arguments] node debug [script.js | -e "script" | <host>:<port>] … node --v8-options إنَّ تنفيذ node دون أيَّة وسائط يؤدي إلى بدئها مع الوحدة REPL. لمزيدٍ من المعلومات حول node debug، راجع رجاءً ...

كما في أيّة لغة برمجة فإن لغة Kotlin تحتوي على تعابير للتحكم بالتدفق، وهي: تعبير if، وتعبير when، وحلقة for، وحلقة while. وتدعم كذلك الكلمتين المفتاحيّتَين continue و break المستخدَمتَين في الحلقات (راجع أوامر الرجوع والقفز returns and jump). تعبير if يُعدُّ الشرط if في لغة Kotlin تعبيرًا يعيد قيمة، وبالتالي لا حاجة للصيغة condition ? then : else لأن تعبير if يقوم بهذا الدور كما في الشيفرة الآتية: // الاستخدام الاعتيادي var max = a if (a < b) max = b // ...

الاستقرار: 2-مستقر تحتوي الوحدة dns على دوال تخص فئتين مختلفتين هما: الدوال التي تستعمل خدمات نظام التشغيل الضمنية لتنفيذ عملية استبيان الاسم (name resolution)، والتي لا تتطلب بالضرورة تنفيذ أية عمليات اتصال بالشبكة. تحوي هذه الفئة على دالة وحيدة هي dns.lookup()‎. يتطلع المطورون إلى تنفيذ عملية استبيان الاسم بالطريقة نفسها التي تُنفِّذ فيها التطبيقات الأخرى الدالة dns.lookup()‎ على المنصة ذاتها عندما تضطر إلى استعمالها. تفحَّص المثال التالي الذي يُستعمَل فيه الدالة dns.lookup()‎ للبحث عن iana.org‎: const dns = require('dns'); dns.lookup('iana.org', (err, ...

يعلِّمك هذا الدليل كيفية التحقق من حالة الكائنات قبل إرسالها إلى قاعدة البيانات باستعمال ميزة التحققات من الصحة (validations) التي يوفرها Active Record. بعد قراءة هذا الدليل، ستتعرَّف على: كيفية استعمال مساعدي التحقق من الصحة (validation helpers) لـ Active Record المدمجين. كيفية إنشاء توابع مخصصة للتحقق من الصحة. كيفية العمل مع رسالة الخطأ المولدة عبر عملية التحقق. نظرة عامة على عمليات التحقق الشيفرة التالية تظهر مثالًا عن تحقق بسيط جدًا: class Person < ApplicationRecord validates :name, presence: true end Person.create(name: ...

تسمح العديد من أنظمة التشغيل بإرسال إشارات إلى العمليات (processes) قيد التشغيل للتحكم بها. بعض الإشارات لها تأثير محدد على العملية، بينما تكون أخرى مرتبطة بالشيفرة البرمجية، وتتصرف بناء عليها. على سبيل المثال، قد تقوم العملية بإمساك (trap) الإشارة USR1 واستخدامها في عملية التنقيح (debugging)، أو قد تُستخدَم الإشارة TERM لبدء إيقاف تشغيل العملية بشكل مُراقَب. pid = fork do Signal.trap("USR1") do $debug = !$debug puts "Debug now: #$debug" end Signal.trap("TERM") ...

في هذا الدليل ستتعلم: ما تقدمه ريلز للتطبيقات ذات الواجهة البرمجية فقط. كيفية ضبط ريلز للبدء دون أي ميزات للمتصفح. كيفية تحديد البرامج الوسيطة (middleware) التي تريد تضمينها. كيفية تحديد الوحدات لاستخدامها في وحدة التحكم الخاصة بك. ما الذي يعنيه «تطبيق ذو واجهة برمجية فقط»؟ تقليديًا، عندما قال الناس أنهم استخدموا ريلز كـ "واجهة برمجية"، فقد كان يعني توفير واجهة برمجية يمكن الوصول إليها برمجيًا جنبًا إلى جنب مع تطبيق الويب الخاص بهم. على سبيل المثال، يوفر GitHub واجهة برمجية ...

تنقل الكلمة goto المفتاحية البرنامج إلى موضع معين ضمن الشيفرة. البنية العامة goto label; // إرسال البرنامج لتنفيذ الكتلة البرمجية // label الموجودة عند التسمية أمثلة مثالٌ على استعمال التعبير goto: for(byte r = 0; r < 255; r++){ for(byte g = 255; g > 0; g--){ for(byte b = 0; b < 255; b++){ ...

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

تقدّم هذه الوحدة عددًا من الأدوات التي تستخدم بواسطة سكربتات CGI المكتوبة في بايثون. مقدمة تنفّذ سكربتات CGI بواسطة مخدّم HTTP وتستخدم عادة لمعالجة مدخلات المستخدم المرسلة إلى المخدّم من خلال عنصر <FORM> أو <ISINDEX> في HTML. تستقرّ سكربتات CGI معظم الأحيان في المجلد الخاص cgi-bin في المخدّم، ويضع مخدّم HTTP جميع المعلومات المرتبطة بالطلب (مثل اسم المضيف لدى العميل، عنوان URL المطلوب، سلسلة الاستعلام النصية، وغير ذلك الكثير) في بيئة الصدفة الخاصة بالسكربت، وينفّذ السكربت ثم يرسل مخرجاته إلى ...

يعيّن التابع DEBUG عند استدعائه بالشكل DEBUG = num قيمة مستوى تصحيح المهمة الفرعية (thread debug level) إلى القيمة num. متوفر فقط في حالة تصريفه (compiled) مع الخيار THREAD_DEBUG = -1. البنية العامة DEBUG = num‎ انظر أيضا التابع DEBUG: يُعيد مستوى التصحيح في المهمة الفرعية (thread debug level). مصادر قسم التابع DEBUG=‎ في الصنف Thread‎ في توثيق روبي الرسمي.

يُعيد التابع DEBUG مستوى التصحيح في المهمة الفرعية (thread debug level). متوفر فقط في حالة تصريفه (compiled) مع الخيار THREAD_DEBUG = -1. البنية العامة DEBUG → num‎ القيمة المعادة يعاد عددٌ يمثل مستوى التصحيح في المهمة الفرعية (thread debug level). انظر أيضًا التابع DEBUG=‎: يعيّن عند استدعائه بالشكل DEBUG = num قيمة مستوى تصحيح المهمة الفرعية (thread debug level) إلى القيمة num. مصادر قسم التابع DEBUG‎ في الصنف Thread‎ في توثيق روبي الرسمي.

(PHP 4 >= 4.0.1, PHP 5, PHP 7) تستعيد الدالة restore_error_handler()‎ معالجة الأخطاء السابقة. الوصف bool restore_error_handler ( void ) تستعيد الدالة restore_error_handler()‎ معالجة الأخطاء السابقة وذلك للعودة إلى معالج الخطأ السابق (الذي يمكن أن يكون مدمجا أو وظيفة معرفة من طرف المستخدم). القيم المعادة تعيد الدالة restore_error_handler()‎ دائما القيمة TRUE. أمثلة المثال 1: استعمال الدالة restore_error_handler()‎ <?php function unserialize_handler($errno, $errstr) {     echo "Invalid serialized value.\n"; } $serialized = 'foo'; set_error_handler('unserialize_handler'); $original = unserialize($serialized); restore_error_handler(); ?> سوف تكون مُخرجات المثال أعلاه قيمة متسلسلة غير صالحة كالتالي Invalid serialized value انظر أيضا الدالة ()error_reporting: تحدد أي أخطاء PHP يبلغ عنها الدالة ()set_error_handler: تحدد وظيفة معالج ...

وظيفة هذا الصنف هي قراءة ملفات الأرشيف من نوع tar والكتابة فيها. لا تستخدم هذا الصنف مباشرة، بل استخدم الدالة tarfile.open()‎ عوضًا عنه. يقدّم كائن TarFile واجهة لملفات الأرشيف من نوع tar. يتكوّن أرشيف tar من تسلسل من الكتل، ويتكوّن عضو الأرشيف (الملفّ المخزّن) من كتلة الترويسة header block متبوعة بكتل البيانات. يمكن تخزين ملف معيّن في أرشيف tar عدّة مرات، ويُمثّل كل عضو في الأرشيف بواسطة كائن TarInfo (راجع قسم كائنات TarInfo للمزيد من التفاصيل). يمكن استخدام كائن TarFile ...

(PHP 4, PHP 5, PHP 7) تبحث الدالة preg_replace()‎‎‎ عن تعبير نمطي وتستبدله. الوصف mixed preg_replace ( mixed $pattern , mixed $replacement , mixed $subject [, int $limit = -1 [, int &$count ]] ) تبحث هذه الدالة في الهدف subject عن النمط المطابق pattern وتبدله إلى replacement. المعاملات pattern النمط المراد البحث عنه. ويمكن أن يكون إما سلسلةً نصيةً أو مصفوفةً من السلاسل النصية. وتتوافر أيضًا العديد من مُعدِّلات PCRE. replacement السلسلة النصية البديلة أو مصفوفة السلاسل النصية البديلة. إذا ...

يُمكن تعديل صفات قاعدة البيانات من خلال هذا الأمر الذي له الصيغ الآتية: ALTER DATABASE name RENAME TO new_name; أو في محرك SQL Server: ALTER DATABASE name MODIFY NAME = new_name; لإعادة تسمية قاعدة البيانات باسم جديد new_name ولا تمكن إعادة تسمية قاعدة البيانات المستخدمة حاليًا إذ يجب الاتصال بقاعدة بيانات أخرى ريثما تُعاد تسمية قاعدة البيانات الحالية. ALTER DATABASE name OWNER TO new_owner; التعليمة السابقة لنقل ملكية قاعدة البيانات باسم name إلى مالك آخر باسم new_owner. ALTER DATABASE name RESET ALL; أما التعليمة ...

السلسلة النصية هي سلسلة من الأحرف، إذ يكون كل حرف ممثلًا ببايت، ولذلك فإن PHP تدعم مجموعةً من 256 حرفًا فقط ولا تقدم دعمًا لمحارف يونيكود، راجع "تفاصيل نوع البيانات string" للمزيد من المعلومات. ملاحظة: بدءًا من الإصدار 7.0.0، لم تعد هنالك قيودٌ حول طول السلسلة النصية على منصات 64 بت، أما بالنسبة لمنصات 32 بت وفي النسخ القديمة، يمكن أن يصل حجم السلسلة النصية إلى 2 جيجا بايت (2147483647 بايت). البنية العامة يمكنك تعريف السلسلة النصية بأربع طرائق مختلفة: ...

يمكن استخدام Sass بثلاث طرائق هي: كأداة سطر أوامر، أو كوحدةٍ مستقلة لروبي، أو كمُلحقة في أيّ بيئة عمل تدعم Rack، بما في ذلك Ruby on Rails و Merb. تثبيت Sass الخطوة الأولى لاستخدام Sass هي تثبيت الجوهرة (gem)‏ Sass: gem install sass إن كنت تستخدم نظام ويندوز، فقد تحتاج إلى تثبيت روبي أولاً. لتشغيل Sass من سطر الأوامر، يكفي أن تكتب الأمر الآتي: sass input.scss output.css يمكنك أيضًا إخبار Sass بمراقبة الملف وتحديث ملف CSS الناتج عند كلِّ تغيُّرٍ في ملف ...

الأنواع Nullable والأنواع Non-Null يهدف نظام الأنواع في Kotlin إلى الحدِّ من أخطار القيمة الفارغة null في الشيفرات، إذ إنّ أحد الأخطاء الأكثر شيوعًا في لغات البرمجة -بما فيها لغة Java- هو أنّ محاولة الوصول إلى مرجعيّةٍ تحتوي على القيمة null سيؤدي إلى حدوث استثناءٍ مرجعيّ (reference exception)، ويُدعى هذا الاستثناء في لغة Java باسم NullPointerException أو NPE اختصارًا، أمّا Kotlin فهي تحدُّ من هذا الاستثناء ليقتصر على الحالات الآتية: استدعاءٌ صريحٌ بالشكل: throw NullPointerException()‎ استخدام المعامل !! (كما سيُشرح لاحقًا) ...

المشكلة يعيد التابع قيمة خاصة تشير إلى خطأ. الحل إطلاق استثناء بدلًا من ذلك. مثال قبل إعادة التصميم يعيد التابع ()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) { ...

صدفة Bash وبرامج Bash البرامج الشائعة للصَّدَفة وظائف الصدفة وما تفعله إضافة إلى أنواعها المختلفة (sh، bash، csh، ... ) مزايا صدفة Bash استعراض لأهم مزايا صدفة Bash، مثل الصور المختلفة لاستدعاءات الصدفة، والتعابير الحسابية والشرطية والصدفة المحظورة، وكذلك الأوامر البديلة والمصفوفات، ... . تنفيذ الأوامر في Bash توضيح لما يحدث عند تنفيذ الأوامر في صدفة Bash، واستعراض لأهم الأوامر المُضمَّنة فيها. وحدات البناء الأساسية شرح للوحدات الأساسية التي تشكل صدفة Bash، مثل الأوامر والدوال والمعامِلات والتوسعات والبنية اللغوية، إضافة ...

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

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 بدلًا من اختفائها دون سدًى. استَبدل هذا ...

يعتبر الصنف SystemCallError الصنف الأب لكل أصناف الأخطاء منخفضة المستوى المرتبطة بنظام التشغيل. الأخطاء المتوفرة على نظام التشغيل الحالي هي أصناف فرعية من الصنف SystemCallErrorـ وهي مُعرّفة في الوحدة Errno. File.open("does/not/exist")‎ عند تنفيذ هذا السطر البرمجي، سيطلق استثناء بالشكل التالي: Errno::ENOENT: No such file or directory - does/not/exist‎ توابع الصنف العامة (Public Class Methods) === يتحقق إن كان الاستثناء الذي استُدعي معه كائنًا عامًا من الصنف SystemCallError، أو إن كان رقما الخطأ الخاصين بهذا الاستثناء والاستثناء الآخر المعطى متساويين. new ...

يمكن تهيئة الكائنات باستخدام new Object()‎ أو الدالة Object.create()‎ أو باستخدام الشكل المختصرة (initializer notation). إنَّ مُهيّئ الكائنات هو قائمة فيها «صفر» زوج أو أكثر من أسماء الخاصيات مع القيم المرتبطة بها، مفصولةٌ بفواصل، ويحيط بها قوسين معقوفين {}. البنية العامة var o = {}; var o = {a: 'foo', b: 42, c: {}}; var a = 'foo', b = 42, c = {}; var o = {a: a, b: b, c: c}; var o = { property: function ([parameters]) {}, get property() ...

(PHP 4, PHP 5, PHP 7) تشبه عبارة switch سلسلةً من عبارات if مطبّقة على نفس التعبير. قد تحتاج في بعض الأحيان إلى مقارنة نفس المتغير (أو التعبير) مع قيم مختلفة (حالات cases)، وتنفيذ شيفرة مختلفة بالاعتماد على ذلك، وهذه هي وظيفة عبارة switch. ملاحظة: بخلاف بعض اللغات البرمجية، يمكن استخدام عبارة continue في switch وهي تعمل عمل العبارة break. إن كنت تستخدم switch داخل حلقة وأردت الانتقال إلى الدورة التالية في الحلقة التكرارية الخارجية، استخدم continue 2. ملاحظة: تؤدي ...

(PHP 4, PHP 5, PHP 7) تشبه عبارة switch سلسلةً من عبارات if مطبّقة على نفس التعبير. قد تحتاج في بعض الأحيان إلى مقارنة نفس المتغير (أو التعبير) مع قيم مختلفة (حالات cases)، وتنفيذ شيفرة مختلفة بالاعتماد على ذلك، وهذه هي وظيفة عبارة switch. ملاحظة: بخلاف بعض اللغات البرمجية، يمكن استخدام عبارة continue في switch وهي تعمل عمل العبارة break. إن كنت تستخدم switch داخل حلقة وأردت الانتقال إلى الدورة التالية في الحلقة التكرارية الخارجية، استخدم continue 2. ملاحظة: تؤدي ...

الاستقرار: 1-تجريبي توفِّر الوحدة async_hooks واجهة برمجية (API) لتسجيل دوال ردود النداء التي تتعقَّب دورة حياة (lifetime) الموارد غير المتزامنة (asynchronous resources) المُنشأَة داخل تطبيقات Node.js. يمكن الوصول إلى هذه الوحدة باستعمال الأمر التالي: const async_hooks = require('async_hooks'); اصطلاحات يمثِّل المورد غير المتزامن كائنًا مرفقًا به رد نداء. قد يُستدعَى رد النداء هذا عدَّة مرات، مثل الحدث 'conection' في net.createServer()‎، أو مرةً واحدة فقط، مثل fs.open()‎. يمكن أن يُغلق المورد أيضًا قبل أن يُستدعَى رد النداء. لا تفرِّق الوحدة AsyncHook ...

تتحقَّق الدالة global_variable_exists()‎ ما إذا كان متغيِّر ما موجودًا في النطاق العام (global scope)، أي في المستوى الأعلى من الملف. البنية العامة global_variable_exists($name) المعاملات ‎$name اسم المتغير المراد التحقُّق منه. لا ينبغي أن يتضمن اسم المتغير البادئةَ $. القيم المعادة تُعاد القيمة المنطقيَّة TRUE إذا كان المتغير مُعرّفًا في النطاق العام. خلا ذلك، تُعاد القيمة FALSE. أمثلة مثال عن استخدام الدالة global_variable_exists()‎ للتحقق من وجود متغير في النطاق العام باسم global-var وآخر باسم local-var: $global-var: "value"; .selector { $local-var: "value"; ...

تتيح وحدة tarfile القدرة على قراءة ملفات الأرشيف tar والكتابة فيها، ومن ضمن ذلك تلك التي تستخدم خوارزمية gzip و bz2 و lzma لإجراء عملية الضغط. استخدم وحدة zipfile لقراءة الملفات ذات الامتداد ‎.zip والكتابة فيها، أو استخدم الدوال ذات المستوى الأعلى في shutil. وقبل الدخول في تفاصيل هذه الوحدة يجدر التنبيه إلى النقاط التالية: تقرأ الوحدة وتكتب ملفات gzip و bz2 و lzma المضغوطة إن كانت الوحدات المقابلة لكل نوع متوفرة. تدعم الوحدة القراءة والكتابة للصيغة POSIX.1-1988 ‏(ustar). تدعم ...

معاملات الأنواع (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 لها ...

يتكرَّر التابع each_key على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ (weakly referenced object). البنية العامة each_key() انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. مصادر صفحة التابع each_key في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتكرَّر التابع keys على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ (weakly referenced object). البنية العامة keys() انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. مصادر صفحة التابع keys في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتكرَّر التابع values على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ (weakly referenced object). البنية العامة values() انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. مصادر صفحة التابع values في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتكرَّر التابع values على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ (weakly referenced object). البنية العامة values() انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. مصادر صفحة التابع values في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتكرَّر التابع each_value على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ (weakly referenced object). البنية العامة each_value() انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. مصادر صفحة التابع each_value في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتحقَّق التابع ?include إذا كان المفتاح مُسجّلًا (registered). البنية العامة include?(p1) المعاملات p1 المفتاح (key) المراد التحقق منه إن كان مسجلًا. القيم المعادة تُعاد القيمة true إذا كان المفتاح p1 مُسجّلًا. انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع each: يتكرَّر على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ. مصادر صفحة التابع ?include في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

البنية العامة rand(*args) المعاملات *args المعاملات المُمرَّرة إلى التابع. مصادر صفحة التابع Random::Formatter.rand في توثيق روبي الرسمي.

يتحقَّق التابع ?member إذا كان المفتاح مُسجّلًا (registered). البنية العامة member?(p1) المعاملات p1 المفتاح (key) المراد التحقق منه إن كان مسجلًا. القيم المعادة تُعاد القيمة true إذا كان المفتاح p1 مُسجّلًا. انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع each: يتكرَّر على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ. مصادر صفحة التابع ?member في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتكرَّر التابع each_key على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ (weakly referenced object). البنية العامة each_key() انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. مصادر صفحة التابع each_key في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتكرَّر التابع each_value على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ (weakly referenced object). البنية العامة each_value() انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. مصادر صفحة التابع each_value في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتكرَّر التابع each على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ (weakly referenced object). البنية العامة each() انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. مصادر صفحة التابع each في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتكرَّر التابع each_pair على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ (weakly referenced object). البنية العامة each_pair() انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. مصادر صفحة التابع each_pair في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتحقَّق التابع ?member إذا كان المفتاح مُسجّلًا (registered). البنية العامة member?(p1) المعاملات p1 المفتاح (key) المراد التحقق منه إن كان مسجلًا. القيم المعادة تُعاد القيمة true إذا كان المفتاح p1 مُسجّلًا. انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع each: يتكرَّر على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ. مصادر صفحة التابع ?member في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتكرَّر التابع each على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ (weakly referenced object). البنية العامة each() انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع ?key: يتحقَّق إذا كان المفتاح مُسجّلًا. مصادر صفحة التابع each في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

يتحقَّق التابع ?key إذا كان المفتاح مُسجّلًا (registered). البنية العامة key?(p1) المعاملات p1 المفتاح (key) المراد التحقق منه إن كان مسجلًا. القيم المعادة تُعاد القيمة true إذا كان المفتاح p1 مُسجّلًا. انظر أيضًا المعامل []: يعيد كائنًا ذو مرجع ضعيف مع المفتاح المُعطى. المعامل =[]: يُنشئ مرجعًا ضعيفًا من المفتاح المُعطى إلى القيمة المعطية. التابع each: يتكرَّر على المفاتيح والكائنات في كائنٍ ذي مرجعٍ ضعيفٍ. مصادر صفحة التابع ?key في الصنف ObjectSpace::WeakMap في توثيق روبي الرسمي.

البنية العامة random_number(*args) المعاملات *args المعاملات المُمرَّرة إلى التابع. مصادر صفحة التابع Random::Formatter.random_number في توثيق روبي الرسمي.