نتائج البحث

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

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

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

معاملات الدالة الافتراضية (default function parameters) تسمح بتهيئة معاملات الدالة مع قيم افتراضية إن لم تُمرَّر لها قيمة أثناء استدعاء الدالة أو كانت القيمة المُمرَّرة هي undefined. البنية العامة function [name]([param1[ = defaultValue1 ][, ..., paramN[ = defaultValueN ]]]) { statements } الوصف تكون قيمة المعاملات الافتراضية في JavaScript هي undefined، لكن في بعض الحالات يكون من المفيد ضبط قيمة تلك المعاملات إلى قيمةٍ أخرى، وهنا تلعب المعاملات الافتراضية دورها. في الماضي كانت الاستراتيجية العامة المتبعة لضبط قيم افتراضية ...

يمكن للمتغير أن يحتوي أي نوع من البيانات ما لم يُصرح بخلاف ذلك بوضوح، وتُضبط المتغيرات الساكنة (Constant Variables) باستخدام أمر readonly. وتحتوي المصفوفة على مجموعة من المتغيرات، وإن صُرح بنوع معين من البيانات لتلك المصفوفة فإن جميع العناصر داخلها ستُضبط على احتواء ذلك النوع فقط من البيانات. كذلك تسمح مزايا Bash بإحلال وتحويل المتغيرات بسرعة، وتتضمن العمليات القياسية حساب طول المتغير والتوسعات الحسابية عليه وإحلال محتواه أو جزء من محتواه. أنواع المتغيرات في Bash شرح للقيم العامة للمتغيرات والمتغيرات ...

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

التعبير البرمجي switch يُستخدَم لمطابقة قيمة تعبير برمجي باستخدام عبارة case، ثم يُنفِّذ التعابير البرمجية المرتبطة معها. البنية العامة switch (expression) { case value1: // التعابير البرمجية التي ستُطبِّق // عندما تُطابِق قيمةُ التعبير قيمةَ الحالة [break;] case value2: // التعابير البرمجية التي ستُطبِّق // عندما تُطابِق قيمةُ التعبير قيمةَ الحالة [break;] ... case valueN: ...

الوظائف العامة للصدفة يفسر برنامج صَدَفة يونكس أوامر المستخدم التي يدخلها بنفسه أو التي يمكن استخراجها وقراءتها من ملف نصي يسمى شيفرة الصَّدَفة النصية (shell script) أو برنامج الصدفة (shell program). وتكون تلك الملفات النصية مفسّرة (interpreted) على خلاف الملفات المُجمّعة (compiled)، بمعنى أن الصدفة تقرأ الأوامرَ سطرًا سطرًا وتبحث عنها في النظام، على خلاف البرامج المُجمَّعة التي يحوِّل المُجمِّع (compiler) شيفرتها إلى ملف تنفيذي (executable file) مكتوب بلغة يستطيع الحاسوب فهمها -لغة الآلة-، ثم يُمكن استخدام ذلك الملف بعدها ...

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

استخدام أمر read أمر read هو الأمر المتمم لأمريْ echo و printf، وبنيته اللغوية كالتالي: read [options] NAME1 NAME2 ... NAMEN يُقرأ سطر واحد من المُدخل القياسي (standard input) أو من واصف ملف (file descriptor) أُدخِل كوسيط لخيار u-، وتُعيَّن أول كلمة من السطر لأول اسم NAME1، والثانية للاسم الثاني NAME2 وهكذا، ثم تُعيَّن الكلمات المتبقية وفاصلاتها المتداخلة (intervening seperators) إلى الاسم الأخير NAMEN، أما إن كانت الكلمات المقروءة من مجرى الدخل أقل من الأسماء فتعيَّن قيم فارغة لتلك الأسماء. تُستخدم ...

إعادة توجيه المُدخلات يمكن تحديد ملف به تعليمات تُستخدم للتحكم في حلقة تكرارية بدلًا من التحكم فيها عن طريق تفقد نتيجة أمر ما أو عن طريق تدخل المستخدم يدويًا، وعادة ما يُستخدم أمر read في هذه الحالة كأمر متحكِّم، ويستمر تنفيذ الحلقة طالما تُغذَّى الحلقة التكرارية بأسطر مدخلات من ذلك الملف، وبمجرد قراءة جميع الأسطر فإن الحلقة تتوقف وتخرج. وبما أن بنية الحلقة التكرارية تُعد بنية لأمر واحد (مثل while TEST-COMMAND; do CONSEQUENT-COMMANDS; done) فإن إعادة التوجيه يجب أن تحدث ...

وحدات بناء الصدفة البنية اللغوية للصدفة (Shell Syntax) إن كان المُدخَل ليس تعليقًا (comment) فإن الصدفة تقرؤه وتقسمه إلى كلمات ومعامِلات مطبِّقة قواعد الاقتباس (quoting rules) لتحدد معنى كل مِحرَف (character)، ثم تُترجَم تلك الكلمات والمعامِلات إلى أوامر وعناصر أخرى ينتج عنها حالة الخروج المناسبة للعملية. ولا تُطبَّق آلية fork-exec التي ذكرناها في تنفيذ الأوامر في Bash إلا بعد أن تحلل الصدفة المُدخلات وفقًا للخطوات الآتية: تقرأ الصدفة المُدخلات من ملف، سواء من نص (string) أو من طرفية المستخدم. يُقسَّم ...

الكتابة والتسمية إن كان لديك سلسلة أوامر تنفذها بشكل متكرر وتريد اختصار وقت تنفيذها أو تنفيذها بشكل آلي، فيمكنك وضعها في ملف فارغ يكتب بصيغة معينة وتقرؤه الصدفة على أنه برنامج تنفذه عند استدعاءه بكتابة اسم الملف الذي يحويه، وتسمى تلك البرامج ببرامج الصدفة أو شيفرات الصدفة النصية (Shell Scripts). ويمكن استخدام تلك البرامج لأتمتة المهام باستخدام أداة cron أو في إجراءات الإقلاع وإيقاف التشغيل في أنظمة يونكس، حيث يُحدَّد أسلوب عمل العفاريت (daemons) والخدمات في شيفرات init النصية (init ...

تعبير let يُصرِّح عن متغير محلي للقسم الكتلي، ويمكن تهيئة قيمته الابتدائية اختياريًا. البنية العامة let var1 [= value1] [, var2 [= value2]] [, ..., varN [= valueN]]; varnameN اسم المتغير، ويمكن أن يكون أيّ معرِّف صالح في JavaScript. valueN القيمة الابتدائية للمتغير، ويمكن استخدام أيّ تعبير (expression) صالح في JavaScript. الوصف التعبير let يسمح بالتصريح عن متغيرات يكون مجالها (scope) محدودًا إلى القسم الكتلي (block statement)، أو إلى التعبير (expression) الذي اُستخدِمَ فيه؛ وهو على النقيض من الكلمة المحجوزة ...

القوسان المعقوصان {} (curly braces، أو تدعى braces فقط أو curly brackets) هما جزء لا يتجزأ من لغة C. يستعملان في بُنى عديدة مثل بنى التحكم وغيرها وهذا يربك أحيانًا المبتدئين أثناء تعلمهم اللغة. يجب أن يُغلَق القوس المعقوص } الافتتاحي بالقوس المعقوص { الختامي دومًا. أي يجب أن تكون الأقواس المعقوصة في حالة توازن دائمة. تتضمن بيئة عمل أردوينو (Arduino IDE) ميزة التحقق من توازن الأقواس المعقوصة. حدِّد فقط أحد الأقواس المعقوصة أو اضغط على نقطة الإدخال التي تلي ...

تُستخدَم الأصناف المُغلَقة لتمثيل الهرميّة (hierarchy) المحدودة للأصناف؛ وذلك عندما يكون نوع القيمة هو أحد الأنواع الموجودة في مجموعةٍ مُحدَّدةٍ (limited set) وليس أيّ نوع آخر، وبالتالي تُعدُّ هذه الأصناف إضافةً (extension) لأصناف الثوابت المُتعدَّدة (enum classes)، إذ إنّ مجموعة القيم لنوع enum محدودة أيضًا ولكل ثابت فيها نسخةٌ (instance) واحدةٌ فقط، بينما يمكن أن يكون للصنف الفرعيّ (subclass) من الصنف المغلق أكثر من نسخةٍ تحتوي على الحالة (case). ويُستخدَم المُحدِّد (modifier)‏ sealed قبل اسم الصنف للتصريح عن أنّه من ...

التعبير البرمجي for يُنشِئ حلقة تكرار تتألف من ثلاثة تعبيرات برمجية اختيارية تحيط بها أقواس وتفصل بينها فواصل منقوطة، ويليها تعبيرٌ برمجيٌ (وعادةً يكون قسمًا كتليًا [block statement]) سيُنفَّذ في كل تكرار للحلقة. البنية العامة for ([initialization]; [condition]; [final-expression]) statement initialization تعبير (يتضمن تعابير الإسناد) أو تصريح عن متغير، ويُستخدَم عادةً لتهيئة متغير العدّاد؛ وهذا التعبير قد يُصرِّح اختياريًا عن متغيرات جديدة باستخدام الكلمة المحجوزة var؛ وهذه المتغيرات ليست محليةً وتابعةً لحلقة التكرار، وإنما ستكون موجودةً في نفس ...

التعبير البرمجي while يُنشِئ حلقة تكرار تُنفِّذ تعبيرًا برمجيًا معيّنًا طالما كان الشرط محققًا (true)، وسيتم التحقق من الشرط قبل تنفيذ التعبير البرمجي. البنية العامة while (condition) statement condition تعبير سيتم التحقق من صحته قبل كل تكرار، وإذا كانت قيمة الشرط condition هي true فسيُنفَّذ التعبير البرمجي statement، وعندما تصبح قيمة الشرط condition مساويةً للقيمة false فسينتقل التحكم إلى التعبير البرمجي الذي يلي حلقة while. statement  التعبير البرمجي الذي سيُنفَّذ طالما كان الشرط محققًا؛ ولتنفيذ أكثر من تعبير برمجي ...

التعبير البرمجي do...while يُنشِئ حلقة تكرار تُنفِّذ تعبيرًا برمجيًا معيّنًا إلى أن يصبح الشرط غير محقق (false)، وسيتم التحقق من الشرط بعد تنفيذ التعبير البرمجي، مما يؤدي إلى تنفيذ التعبير البرمجي المُعيّن مرةً واحدةً على الأقل. البنية العامة do statement while (condition); statement  التعبير البرمجي الذي سيُنفَّذ مرةً واحدةً على الأقل وسيُعاد تنفيذه في كل مرة يكون فيها الشرط محققًا (أي true)؛ ولتنفيذ أكثر من تعبير برمجي فاستخدام الأقسام الكتلية (block statement) { ... } لتجميع هذا التعابير. condition ...

تتكون جميع شيفرات PHP من سلسلة من العبارات (statements)، ويمكن للعبارة أن تكون إسنادًا (assignment) أو استدعاءً لدالّة، أو حلقة تكرارية، أو عبارة شرطية أو حتى عبارة لا تقوم بأي عمل على الإطلاق (عبارة فارغة). تنتهي العبارات عادة بالفاصلة المنقوطة (;)، ويمكن تجميع العبارات بإحاطتها بالأقواس المعقوفة ({}) لتصبح مجموعة عبارات (statement-group)، والتي تعدّ بدورها عبارات أيضًا. سنفصل الحديث في هذا الفصل عن أنواع متعددة من العبارات. if بنية if هي واحدة من أهم الميزات المتوفّرة في العديد من اللغات ...

التعابير النمطية Regular Expressions التعبير النمطي (Regular Expression) هو أسلوب يصف مجموعة من النصوص (strings)، وتُبنى تلك التعابير النمطية بشكل تناظري للتعابير الحسابية (arithmetic expressions) باستخدام عدة معامِلات لدمج التعابير الأصغر. وأصغر وحدة بنائية للتعابير النمطية هي تلك التي تطابق محرفًا واحدًا، ذلك أن أغلب المحارف -بما في ذلك كل الحروف والأرقام- ما هي إلا تعابير نمطية تطابق أنفسها، ويمكن اقتباس أي محرف خاص (metacharacter) له معنىً خاص بسبْقِه بشرطة مائلة خلفية \. المحارف الخاصة للتعابير النمطية يمكن إتْباع التعبير ...

مدى المحارف Character Ranges خلافًا لأمر grep والتعابير النمطية (regular expressions) فإن لدينا حالات كثيرة لمطابقة الأنماط التي يمكنك إجراؤها في الصدفة مباشرة دون الحاجة إلى استخدام برنامج خارجي، فلعلك تعلم أن محرفي * و ? يطابقان أي نص أو محرف وحيد -على الترتيب-، ومن أجل مطابقة هذين المحرفيْن تحديدًا، ضع حول كل منهما علامات اقتباس مزدوجة: hsoub ~> touch "*" hsoub ~> ls "*" * يمكنك استخدام الأقواس المربعة لمطابقة أي محرف أو مجموعة محارف بداخل تلك الأقواس إن فُصلت أزواج المحارف ...

(PHP 4, PHP 5, PHP 7) تعد حلقات while التكرارية أبسط أنواع الحلقات في PHP، وتعمل بطريقة مماثلة لنظيرتها في لغة C، والصيغة الأساسية لعبارة while هي: while (expr) statement تؤدي عبارة while وظيفةً بسيطةً، وهي تنفيذ العبارة أو العبارات التي تحتضنها بصورة متكررة ما دامت العبارة الشرطية المرتبطة بحلقة while تؤول إلى TRUE. تتحقّق اللغة من قيمة التعبير في بداية كل دورة، لهذا لن يؤدي تغيير القيمة أثناء عملية التنفيذ إلى إيقاف الدورة بل ستكمل الشيفرة ...

(PHP 4, PHP 5, PHP 7) تعد حلقات while التكرارية أبسط أنواع الحلقات في PHP، وتعمل بطريقة مماثلة لنظيرتها في لغة C، والصيغة الأساسية لعبارة while هي: while (expr) statement تؤدي عبارة while وظيفةً بسيطةً، وهي تنفيذ العبارة أو العبارات التي تحتضنها بصورة متكررة ما دامت العبارة الشرطية المرتبطة بحلقة while تؤول إلى TRUE. تتحقّق اللغة من قيمة التعبير في بداية كل دورة، لهذا لن يؤدي تغيير القيمة أثناء عملية التنفيذ إلى إيقاف الدورة بل ستكمل الشيفرة ...

تستخدم عبارة while لتكرار عملية التنفيذ ما دام الشرط المقدّم إلى هذه العبارة صحيحًا، وتأخذ عبارة while الصيغة التالية: while expression: statement مثال: >>> a, b = 0, 1 >>> while b < 10: ...     print(b) ...     a, b = b, a+b ... 1 1 2 3 5 8 تستمر هذه العبارة في تكرار تنفيذ الشيفرة ما دام الشرط صحيحًا True، أما إذا كان نتيجة الشرط خطأً False (قد يحدث ذلك في الدورة الأولى من الحلقة) فستنتقل عملية التنفيذ إلى عبارة else في حال وجودها، وتوقف اللغة ...

تهدف حلقة WHILE إلى تكرار عددٍ من التعليمات باستمرار تحقق الشرط ضمنها، إذ يُتأكَّد من تحقّق الشرط قبل البدء بتنفيذ التعليمات التي تحتويه، وتكون البنية العامّة لها: [ <<label>> ] WHILE boolean-expression LOOP statements END LOOP [ label ]; إذ يمكن تحديد تسمية label لها وتوضع التعليمات statements ضمنها بعد الكلمة المفتاحية LOOP. أما في محرك MySQL فتصبح بالشكل الآتي: [begin_label:] WHILE search_condition DO statement_list END WHILE [end_label]; وفي محرك SQL Server تكون بالشكل: WHILE boolean_expression { sql_statement | ...

الكلمة المحجوزة function*‎ تُستخدَم لتعريف دالة مولِّدة داخل تعبير. البنية العامة function* name([param[, param[, ... param]]]) { statements } name اسم الدالة، ويمكن حذفه وحينئذٍ ستسمى الدالة بالدالة المجهولة؛ واسم الدالة لن يكون متاحًا إلا داخل الدالة نفسها (يمكن أن يستعمل لتنفيذها تعاوديًا [recursively]). param اسم الوسيط المُرَّر إلى الدالة، العدد الأقصى للوسائط التي يمكن تمريرها إلى الدالة يختلف حسب المحرِّك الذي يُفسِّر اللغة. statements التعابير البرمجية التي تُشكِّل جسم الدالة. الوصف تعابير تعريف الدوال المولِّدة تشبه كثيرًا (وتكاد ...

تعبير الدوال السهمية (arrow function expression) له بنيةٌ عامةٌ مختصرةٌ أكثر من تعبير تعريف الدوال، ولا يملك قيم this أو arguments أو super أو new.target خاصة به؛ والدوال السهمية تناسب الدوال التي لا تكون أعضاءً في كائنٍ ما، وتلك التي لن تُستخدَم كدالة بانية. البنية العامة البنية الأساسية (param1, param2, …, paramN) => { statements } (param1, param2, …, paramN) => expression // ستُقدَّر إلى: (param1, param2, …, paramN) => { return expression; } // الأقواس اختيارية عندما يكون هنالك وسيطٌ وحيدٌ فقط (singleParam) ...

التعبير البرمجي الفارغ (empty statement) يُستخدَم لتجنب توفير تعبير برمجي في المواضع التي تتطلب فيها JavaScript تعبيرًا برمجيًا واحدًا على الأقل. البنية العامة ; الوصف التعبير الفارغ هو فاصلة منقوطة ; الذي يُشير إلى عدم وجود تعبير لتنفيذه حتى لو تطلبت JavaScript تعبيرًا أو أكثر؛ وفي المقابل، إذا كانت JavaScript تقبل باستخدام تعبير واحد فمن الممكن استخدم الأقسام الكتلية (block statement) لتجميع أكثر من تعبير برمجي. أمثلة قد يُستخدَم التعبير البرمجي الفارغ مع حلقات التكرار، لاحظ المثال الآتي الذي فيه ...

يحول التابع to_a متغيرات البيئة إلى مصفوفة مكونة من مصفوفات فرعية تضم أسماء وقيم تلك المتغيرات. البنية العامة to_a → Array القيمة المعادة تُعاد مصفوفة مكونة من مصفوفات فرعية تضم أسماء وقيم متغيرات البيئة. أمثلة مثال عن استخدام التابع to_a: ENV.to_a # => [["TERM", "xterm-color"], ["SHELL", "/bin/bash"], ...] انظر أيضًا التابع to_h: ينشئ جدولًا من النوع Hash يحوي نسخةً من متغيرات البيئة.  التابع to_s: يعيد السلسلة النصية “ENV”. مصادر قسم التابع to_a في الصنف ENV في توثيق روبي الرسمي.

التصريح عن الدالة (function declaration) يُعرِّف دالةً لها معاملات (parameters) معيّنة. يمكن أيضًا تعريف الدوال عبر الدالة البانية Function وعبر تعابير تعريف الدوال (function expression). البنية العامة function name([param,[, param,[..., param]]]) { [statements] } name اسم الدالة. param اسم الوسيط المُرَّر إلى الدالة، العدد الأقصى للوسائط التي يمكن تمريرها إلى الدالة يختلف حسب المحرِّك الذي يُفسِّر اللغة. statements التعابير البرمجية التي تُشكِّل جسم الدالة. الوصف الدالة المُصرَّح عنها هي كائن Function يملك وصولًا إلى جميع خاصياته ودواله ولها نفس ...

الأقسام الكتلية (block statement) تُستخدَم لتجميع عدِّة تعابير برمجية معًا، ويُعرَّف القسم بزوجٍ من الأقواس المعقوفة {}، وقد يُضاف قبله لافتة (label). البنية العامة قسم كتلي دون لافتة: { StatementList } قسم كتلي مع لافتة: LabelIdentifier: { StatementList } StatementList التعابير البرمجية المجمَّعة ضمن القسم الكتلي. LabelIdentifier لافتة label اختيارية يمكن استخدامها لتسهيل التعرّف بصريًا على القسم، أو كوجهة للتعبير break. الوصف تسمح الأقسام الكتلي لك باستخدام أكثر من تعبير برمجي في المواضع التي تتوقع JavaScript أن تتلقى تعبيرًا برمجيًا وحيدًا؛ ...

يعد المعامل === معامل تساوي الحالة (Case Equality)، إذ يتحقق من تطابق تعبير نمطي مع سلسلة نصية. ويُستخدم أيضًا في العبارات case. وضع تعبير نمطي حرفي (regular expression literal) عقِب المعامل === يسمح لك بمقارنته مع سلسلة نصية. البنية العامة rxp === str→ true or false‎ القيمة المعادة تعاد القيمة true إن تطابق التعبير النمطي rxp مع السلسلة النصية أو تعاد القيمة false خلاف ذلك. أمثلة مثال على استخدام المعامل ===‎: a = "HELLO" case a when /\A[a-z]*\z/; print "Lower case\n" when /\A[A-Z]*\z/; ...

(PHP 4, PHP 5, PHP 7) تعدّ حلقات for النوع الأكثر تعقيدًا من الحلقات في PHP، وهي مشابهة لنظيرتها في لغة C، وتأخذ الصيغة التالية: for (expr1; expr2; expr3) statement ينفّذ التعبير expr1 مرة واحدة دون قيد أو شرط في بداية الحلقة، وينفّذ التعبير expr2 في بداية كل دورة، فإن كانت النتيجة هي TRUE فتستمر الحلقة في عملها وتنفّذ العبارات المضمّنة فيها، أما إن كانت النتيجة هي FALSE فتتوقف الحلقة عن العمل، أما التعبير expr3 فينفّذ في ...

الكلمة المحجوزة async function تُستخدَم لتعريف دوال غير متزامنة ضمن تعبير (expression). طريقة أخرى لتعريف الدوال غير المتزامنة في JavaScript هي التصريح عنها. البنية العامة async function name([param[, param[, ... param]]]) { statements } name اسم الدالة، ويمكن حذفه وحينئذٍ ستسمى الدالة بالدالة المجهولة؛ واسم الدالة لن يكون متاحًا إلا داخل الدالة نفسها (يمكن أن يستعمل لتنفيذها تعاوديًا [recursively]). param اسم الوسيط المُرَّر إلى الدالة. statements التعابير البرمجية التي تُشكِّل جسم الدالة. الوصف تعابير تعريف الدوال غير المتزامنة تشبه ...

(PHP 4, PHP 5, PHP 7) تعدّ حلقات for النوع الأكثر تعقيدًا من الحلقات في PHP، وهي مشابهة لنظيرتها في لغة C، وتأخذ الصيغة التالية: for (expr1; expr2; expr3) statement ينفّذ التعبير expr1 مرة واحدة دون قيد أو شرط في بداية الحلقة، وينفّذ التعبير expr2 في بداية كل دورة، فإن كانت النتيجة هي TRUE فتستمر الحلقة في عملها وتنفّذ العبارات المضمّنة فيها، أما إن كانت النتيجة هي FALSE فتتوقف الحلقة عن العمل، أما التعبير expr3 فينفّذ في ...

(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. ملاحظة: تؤدي ...

وسوم PHP عندما تُفسِّر PHP ملفًا فهي تبحث عن وسوم البداية والنهاية، وهي ‎<?php و ‎?>‎، والتي تخبر PHP أين يجب أن تُفسِّر الشيفرات، وهذا يعني أنَّ بالإمكان تضمين لغة PHP في مختلف أنواع المستندات، وسيتجاهل المُفسِّر أي شيء خارج وسمَي البداية والنهاية. تسمح PHP بوسم البداية المختصر وهو ‎<?‎ (لكن استعماله غير منصوح به، لأنها لا يعمل إلا إذا فعّلناه باستخدام تعليمة الضبط short_open_tag). إذا كان الملف لا يحتوي إلا على شيفرات PHP، فمن المستحسن حذف وسم النهاية في ...

وسوم PHP عندما تُفسِّر PHP ملفًا فهي تبحث عن وسوم البداية والنهاية، وهي ‎<?php و ‎?>‎، والتي تخبر PHP أين يجب أن تُفسِّر الشيفرات، وهذا يعني أنَّ بالإمكان تضمين لغة PHP في مختلف أنواع المستندات، وسيتجاهل المُفسِّر أي شيء خارج وسمَي البداية والنهاية. تسمح PHP بوسم البداية المختصر وهو ‎<?‎ (لكن استعماله غير منصوح به، لأنها لا يعمل إلا إذا فعّلناه باستخدام تعليمة الضبط short_open_tag). إذا كان الملف لا يحتوي إلا على شيفرات PHP، فمن المستحسن حذف وسم النهاية في ...

على وجه العموم، الدالة هي «برنامجٌ فرعي» (subprogram) الذي يمكن استدعاؤه من شيفرة خارجية (أو داخلية، في حال أردنا استدعاء الدالة تعاوديًا [recursively])؛ وتحتوي الدالة على سلسلةٍ من التعابير البرمجية التي تسمى «جسم الدالة»، ويمكن تمرير قيم إلى الدالة، وتستطيع الدالة أن تعيد قيمةً ما. تُعدّ الدوال في JavaScript على أنَّها كائنات من الصنف الأول (first-class objects)، لأنها تملك خاصيات ودوال مثل بقية الكائنات، لكن ما يميّزها عن بقية الكائنات هو إمكانية استدعائها، إذ إنَّها كائنات من النوع Function. الوصف ...

الكلمة المحجوزة function تُستخدَم لتعريف دالة داخل تعبير (expression). يمكنك أيضًا تعريف الدوال عبر التصريح عنها function declaration أو عبر الدالة البانية Function. البنية العامة var myFunction = function [name]([param1[, param2[, ..., paramN]]]) { statements }; name اسم الدالة، ويمكن حذفه وحينئذٍ ستسمى الدالة بالدالة المجهولة؛ واسم الدالة لن يكون متاحًا إلا داخل الدالة نفسها (يمكن أن يستعمل لتنفيذها تعاوديًا [recursively]). param اسم الوسيط المُرَّر إلى الدالة، العدد الأقصى للوسائط التي يمكن تمريرها إلى الدالة يختلف حسب المحرِّك الذي ...

تُستعمَل الفاصلة المنقوطة ; لإنهاء كل تعبير برمجي في لغة أردوينو C. البنية العامة /* a statement */ ; أمثلة مثالٌ على تعريف متغير: int a = 13; ملاحظات وتحذيرات سيؤدي نسيان إنهاء سطرٍ بفاصلة منقوطة إلى رمي خطأ أثناء تصريف الشيفرة. قد تكون رسالة الخطأ واضحة وصريحة وتشير إلى موقع نسيان الفاصلة في الشيفرة أو قد لا تكون. إن واجهك خطأٌ غامضٌ أو بدى وكأنَّه غير منطقي أثناء تصريف الشيفرة، فتحقَّق أولًا من نسيان الفاصلة المنقوطة في الجوار السابق ...

تعيد الخاصية CASE_INSENSITIVE_ORDER‎ مُقارِنًا (Comparator) يرتب السلاسل النصية دون أخذ حالة الحروف (character case) بالحسبان. تذكر أنّ هذا المُقارِن لا يأخذ إعدادات المحلية بالحسبان، وقد تنتج عن استخدامه نتائج غير مرضية في لمحليَّات معينة. البنية العامة val String.Companion.CASE_INSENSITIVE_ORDER: Comparator<String> الإصدار المطلوب: JVM. القيم المعادة يعاد مُقارِن (Comparator) يرتب السلاسل النصية دون أخذ حالة الحروف (character case) بالحسبان. انظر أيضًا الدالة isLowerCase()‎: تتحقق إن كان الحرف الذي استٌدعي معها حرفًا صغيرًا (lower case). الدالة isUpperCase()‎: تتحقق إن كان الحرف الذي استٌدعي معها حرفًا كبيرًا (upper case). الدالة toUpperCase()‎ : تحوّل الحرف أو ...

(PHP 4, PHP 5, PHP 7) تغيِّر الدالة chown()‎ مالك الملف. الوصف bool chown ( string $filename , mixed $user ) تحاول هذه الدالة تغيير مالك الملف filename إلى المالك الجديد user. المستخدم ذو امتيازات مدير النظام الذي يملك كافَّة صلاحيات الوصول (superuser) قادرٌ وحده على تغيير مالك الملف. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. user اسم المالك الجديد أو رقم مُعرِّفه. القيم المعادة تُعاد القيمة TRUE عند نجاح العملية، والقيمة FALSE خلاف ذلك. أمثلة المثال 1: استعمال الدالة ...

مقدمة يُبسّط Laravel التعامل مع قواعد البيانات بشكل كبير عبر مجموعة متنوعة من الأسندة الخلفية (backends) قواعد البيانات إمّا باستخدام  لغة الاستعلام البنيوية SQL خام أو باستخدام منشئ الاستعلامات الفصيح (fluent query builder)، أو باستخدام رابط الكائنات بالعلاقات Eloquent. يدعم Laravel حاليًا أربع قواعد بيانات: MySQL PostgreSQL SQLite SQL Server الضبط تقع إعدادات قاعدة بيانات تطبيقك في config/database.php. تستطيع في هذا الملف تعريف جميع اتصالات قاعدة بياناتك لإضافةً لتحديد الاتصال الافتراضي. تتوافر أمثلة عن معظم أنظمة قواعد البيانات المدعومة في ...

التصريح عن دالة غير متزامنة (asynchronous function declaration) يُعيد كائنًا من النوع AsyncFunction، يمكن أيضًا إنشاء الدوال غير المتزامنة عبر تعابير تعريف الدوال غير المتزامنة (async function expression). البنية العامة async function name([param[, param[, ... param]]]) { statements } name اسم الدالة param اسم الوسيط المُرَّر إلى الدالة. statements التعابير البرمجية التي تُشكِّل جسم الدالة. القيمة المعادة كائن AsyncFunction الذي يُمثِّل الدالة غير المتزامنة ويُنفِّذ الشيفرة الموجودة ضمنها. الوصف عندما تُستدعى دالة غير متزامنة، فستعيد كائن Promise، وعندما تُعيد ...

(PHP 5 >= 5.3.0, PHP 7) يمكن استخدام عامل goto للانتقال إلى قسم آخر في البرنامج، وتعيّن نقطة الانتقال هذه بواسطة وسم متبوعٍ بنقطتين رأسيتين (:)، وتكون طريقة الانتقال باستخدام العامل goto متبوعًا بالوسم المراد الانتقال إليه. هناك بعض القيود المفروضة على استخدام goto، إذ يجب أن يكون الوسم الهدف في نفس الملف ونفس السياق (context)، بمعنى أنّه لا يمكن الانتقال من داخل الدالة أو التابع إلى الخارج كما لا يمكن الانتقال إلى الداخل. لا يمكن أيضًا الانتقال إلى أي ...

(PHP 5 >= 5.3.0, PHP 7) يمكن استخدام عامل goto للانتقال إلى قسم آخر في البرنامج، وتعيّن نقطة الانتقال هذه بواسطة وسم متبوعٍ بنقطتين رأسيتين (:)، وتكون طريقة الانتقال باستخدام العامل goto متبوعًا بالوسم المراد الانتقال إليه. هناك بعض القيود المفروضة على استخدام goto، إذ يجب أن يكون الوسم الهدف في نفس الملف ونفس السياق (context)، بمعنى أنّه لا يمكن الانتقال من داخل الدالة أو التابع إلى الخارج كما لا يمكن الانتقال إلى الداخل. لا يمكن أيضًا الانتقال إلى أي ...

(PHP 4, PHP 5, PHP 7) بنية if هي واحدة من أهم الميزات المتوفّرة في العديد من اللغات البرمجية، ومن ضمنها PHP. إذ تتيح تنفيذ أجزاء من الشيفرة اعتمادًا على شروط معينة. تعتمد PHP بنية if المعتمدة في لغة C: if (expr) statement تُحسب التعابير -كما ورد في الفصل المتعلّق بالتعابير في هذا الدليل- إلى قيمة منطقية (Boolean)، فإن كانت نتيجة الحساب هي TRUE تنفذ PHP العبارة، وإن كانت نتيجة الحساب هي FALSE تتجاهل اللغة ذلك التعبير. يمكن الحصول ...

(PHP 4, PHP 5, PHP 7) بنية if هي واحدة من أهم الميزات المتوفّرة في العديد من اللغات البرمجية، ومن ضمنها PHP. إذ تتيح تنفيذ أجزاء من الشيفرة اعتمادًا على شروط معينة. تعتمد PHP بنية if المعتمدة في لغة C: if (expr) statement تُحسب التعابير -كما ورد في الفصل المتعلّق بالتعابير في هذا الدليل- إلى قيمة منطقية (Boolean)، فإن كانت نتيجة الحساب هي TRUE تنفذ PHP العبارة، وإن كانت نتيجة الحساب هي FALSE تتجاهل اللغة ذلك التعبير. يمكن الحصول ...

تُجمّع الدّالة compile()‎ شيفرة بايثون مصدريّةً إلى شيفرة أو كائن AST. يُمكن تنفيذ هذه الكائنات عبر استخدام الدّالة exec()‎ أو الدّالة eval()‎. البنية العامة compile(source, filename, mode, flags=0, dont_inherit=False, optimize=-1) المعاملات source الشيفرة المصدريّة المرغوب تجميعها، يُمكن أن تكون قيمة المُعامل سلسلةً نصيّة، أو سلسلة بايتات نصيّة (byte string) أو كانًا من النّوع AST. انظر توثيق الوحدة ast للمزيد من المعلومات حول كائنات AST. filename اسم الملفّ الذي قُرِئَت منه الشيفرة. مرّر قيمةً مفهومةً إن لم تكن الشّيفرة قد قرئَت ...

التعبير البرمجي label يمكن أن يُستخدَم مع التعبير البرمجي break أو continue، وهو يوضع قبل التعابير البرمجية لإضافة لافتة (مُعرِّف) لها يمكن الإشارة إليها. لاحظ أنَّ من غير الشائع استخدام حلقات تكرار مع لافتات (labels)، وتُستخدَم عادةً الدوال بدلًا القيام بقفزات بين حلقات التكرار. البنية العامة label : statement label لافتة للتعبير البرمجي، ويمكن أن تكون أيّ مُعرِّف في JavaScript صالح (وليس كلمةً محجوزةً). statement التعابير البرمجية التي ستُضاف اللافتة إليها، ويمكن استخدام التعبير البرمجي break مع أيّ ...

التصريح عن الدالة المولدة (generator function declaration) يُعرِّف دالة مولدِّةً التي تُعيد الكائن Generator. لاحظ أنَّ التصريح عن الدوال المولدة يكون عبر الكلمة المحجوزة function ويليها رمز النجمة *. يمكن أيضًا تعريف الدوال المولِّدة عبر الدالة البانية GeneratorFunction وعبر تعابير تعريف الدوال المولدة (function* expression). البنية العامة function* name([param[, param[, ... param]]]) { statements } name اسم الدالة param اسم الوسيط المُرَّر إلى الدالة، العدد الأقصى للوسائط التي يمكن تمريرها إلى الدالة يختلف حسب المحرِّك الذي يُفسِّر اللغة. statements ...

المشكلة وجود شروط تنفِّذ إجراءات مختلفة اعتمادًا على نوع الكائن أو خصائصه. الحل إنشاء أصناف فرعية مطابقة لفروع البنية الشرطية. ويُنشأ فيها تابع مشترك وتُنقل إليه الشيفرة البرمجية من الفرع المقابل من الشرطية. ثم تُستبدل البنية الشرطية باستدعاء التابع المناسب. وينتج عن ذلك تنفيذ سليم يتحقق من خلال التعدديّة الشكليّة اعتمادًا على صنف الكائن. مثال قبل إعادة التصميم الصنف Bird يحتوي على التابع getSpeed الذي باستعمال البنية الشرطية switch من النوع type لحساب السرعة بناءً على قيمته: في لغة Java: ...

يعيد التابع casefold?‎ قيمة راية الحساسية لحالة الأحرف (case-insensitive flag). البنية العامة casefold?→ true or false‎ القيمة المعادة تعاد قيمة راية الحساسية لحالة الأحرف (case-insensitive flag). أمثلة مثال على استخدام التابع casefold?‎: /a/.casefold? #=> false /a/i.casefold? #=> true /(?i:a)/.casefold? #=> false‎ انظر أيضًا التابع encoding: يُعيد كائنًا من النوع Encoding، والذي يمثل ترميز الكائن. مصادر قسم التابع casefold?‎ في الصنف ...

يدعى المعامل = في لغة C «معاملَ الإسناد»، إذ يختلف عن المعنى الظاهري المعروف في الرياضيات الذي يشير إلى الموازنة أو المساواة. يخبر معامل الإسناد المتحكم بتقييم التعبير أو القيمة الموجودة في الطرف الأيمن للمعامل = أيًّا كانت وتخزينها في المتغير الموجود في الطرف الأيسر لذاك المعامل. البنية العامة (dataType) variable = value/statement; أمثلة مثالٌ على استعمال المعامل =: int sensVal; // نوعه: عدد صحيح ،sensVal التصريح ...

يدعى المعامل = في لغة C «معاملَ الإسناد»، إذ يختلف عن المعنى الظاهري المعروف في الرياضيات الذي يشير إلى الموازنة أو المساواة. يخبر معامل الإسناد المتحكم بتقييم التعبير أو القيمة الموجودة في الطرف الأيمن للمعامل = أيًّا كانت وتخزينها في المتغير الموجود في الطرف الأيسر لذاك المعامل. البنية العامة (dataType) variable = value/statement; أمثلة مثالٌ على استعمال المعامل =: int sensVal; // نوعه: عدد صحيح ،sensVal التصريح ...

تتحقق الدالة isUpperCase()‎ إن كان الحرف الذي استٌدعي معها حرفًا كبيرًا (upper case). البنية العامة inline fun Char.isUpperCase(): Boolean المنصة المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كان الحرف الذي استٌدعي معها حرفًا كبيرًا، أو القيمة false خلاف ذلك. أمثلة استعمال الدالة isUpperCase()‎ لمعرفة إن كان الحرفان التاليان متساويين: fun main(args: Array<String>) { val x = 'a' ...

تتحقق الدالة isLowerCase()‎ إن كان الحرف الذي استٌدعي معها حرفًا صغيرًا (lower case). البنية العامة inline fun Char.isLowerCase(): Boolean وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كان الحرف الذي استٌدعي معها حرفًا صغيرًا، أو القيمة false خلاف ذلك. أمثلة استعمال الدالة isLowerCase()‎ لمعرفة إن كان الحرفان التاليان متساويين: fun main(args: Array<String>) { val x = 'a' val y = ...

تتحقق الدالة isLowerCase()‎ إن كان الحرف الذي استٌدعي معها حرفًا صغيرًا (lower case). البنية العامة inline fun Char.isLowerCase(): Boolean وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كان الحرف الذي استٌدعي معها حرفًا صغيرًا، أو القيمة false خلاف ذلك. أمثلة استعمال الدالة isLowerCase()‎ لمعرفة إن كان الحرفان التاليان متساويين: fun main(args: Array<String>) { val x = 'a' val y = ...

تتحقق الدالة isUpperCase()‎ إن كان الحرف الذي استٌدعي معها حرفًا كبيرًا (upper case). البنية العامة inline fun Char.isUpperCase(): Boolean المنصة المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن كان الحرف الذي استٌدعي معها حرفًا كبيرًا، أو القيمة false خلاف ذلك. أمثلة استعمال الدالة isUpperCase()‎ لمعرفة إن كان الحرفان التاليان متساويين: fun main(args: Array<String>) { val x = 'a' ...

تصِفُ الخاصيّة Document.readyState حالة تحميل المُستند. البنية العامة var string = document.readyState; القيم يُمكن للخاصيّة أن تحمِل القيم التّاليّة: "loading" المُستند لا يزال قيد التّحميل "interactive" تحميل المُستند قد انتهى، لكنّ الموارد الفرعيّة كالصّور وصفحات الأنماط والإطارات لا تزال قيد التّحميل "complete" انتهى تحميل المُستندِ وجميع موارِده الفرعيّة. هذه الحالة تُشير إلى أنّ الحدث load سيُطلَق فورًا. يُطلَق الحدث readystatechange على كائن المُستند document عند كلّ تغيّر لقيمة هذه الخاصيّة. أمثلة الحالات المُختلفة لجاهزيّة المُستند: switch (document.readyState) { case ...

يعيد المعامل === القيمة true إن كانت قيمةٌ أو كائنٌ ما أحد عناصر المجال (أي تقع ضمنه). المعامل === هو معامل المقارنة الذي تستخدمه عبارات case. البنية العامة rng === obj → true or false‎ ‎القيمة المعادة تعاد القيمة true إن كان الكائن obj أحد عناصر المجال rng (أي يقعع ضمنه)، أو تعاد القيمة false خلاف ذلك. أمثلة مثال على استخدام المعامل ===‎: case 79 when 1..50 then print "low\n" when 51..75 then print "medium\n" when ...

(PHP 4, PHP 5, PHP 7) تنهي break تنفيذ حلقات for أو foreach أو while أو do-while أو بنية switch. تأخذ break معاملًا عدديًا اختياريًا يُحدّد من خلاله عدد البنى المتداخلة التي‏ يجب إيقاف تنفيذها. القيمة الافتراضية لهذا المعامل هي 1، والذي يعني إيقاف تنفيذ البنية الحالية فقط. <?php $arr = array('one', 'two', 'three', 'four', 'stop', 'five'); while (list(, $val) = each($arr)) { if ($val == 'stop') { break; /* يمكن أيضًا كتابة /* ...

(PHP 4, PHP 5, PHP 7) تنهي break تنفيذ حلقات for أو foreach أو while أو do-while أو بنية switch. تأخذ break معاملًا عدديًا اختياريًا يُحدّد من خلاله عدد البنى المتداخلة التي‏ يجب إيقاف تنفيذها. القيمة الافتراضية لهذا المعامل هي 1، والذي يعني إيقاف تنفيذ البنية الحالية فقط. <?php $arr = array('one', 'two', 'three', 'four', 'stop', 'five'); while (list(, $val) = each($arr)) { if ($val == 'stop') { break; /* يمكن أيضًا كتابة /* ...

الكائن SyntaxError يُشير إلى حدوث خطأ عند محاولة تفسير شيفرة ذات بنية غير صحيحة. البنية العامة new SyntaxError([message]) message وسيط اختياري، وهو وصفٌ نصيٌّ للخطأ موجَّهٌ للبشر. الخاصيات والدوال التابعة للدالة البانية SyntaxError الخاصيات SyntaxError.prototype تُمثِّل هذه الخاصية كائن prototype التابعة للكائن SyntaxError. الدوال الدالة البانية SyntaxError لا تملك أيّة دوال تابعة لها مباشرةً، وإنما ترث بعض الخاصيات عبر سلسلة prototype. الكائن prototype الخاصيات SyntaxError.prototype.constructor تُحديد الدالة التي ستُنشِئ كائن prototype لكائنات SyntaxError؛ راجع صفحة الخاصيةObject.prototype.constructor لمزيدٍ من التفاصيل. SyntaxError.prototype.message رسالة ...

تُستخدم الدّالة eval()‎ لتقدير (evaluate) تعبير بايثون. يُقدّر التّعبير المُعطى باستخدام مُعامل الكائنات العامّة globals والكائنات المحليّة locals. البنية العامة eval(expression, globals=None, locals=None) المعاملات expression سلسلة نصيّة تُمثّل تعبير بايثون المُراد تقديره أو كائن شيفرة كذلك الذي تُعيده الدّالة compile()‎. globals مُعامل اختياريّ. قاموس يُمثّل الكائنات العامّة التي ستُمرّر إلى التّعبير. إن مُرّر هذا المُعامل دون الكائن ‎_‎_‎builtins‎_‎_‎، فستُنسَخ الكائنات العامّة الحاليّة وتُمرّر إلى المُعامل قبل مُعالجة التّعبير. ما يعني أنّ التّعبير يحصل طبيعيًّا على كامل حقوق الوصول إلى الوحدة ...

يحوِّل التابع c_str()‎ محتوى السلسلة النصية التي استدعيت معه إلى نمط السلسلة النصية المثالية في C (السلسلة النصية المنتهية بالمحرف null). انتبه إلى أنَّ هذا التابع يعدِّل السلسلة النصية المعطاة عبر الوصول إلى عنوانها الداخلي في الذاكرة، لذا يجب توخي الحذر عند استعماله. تحديدًا، لا يجب عليك تعديل السلسلة النصية عبر المؤشر الذي يعيده هذا التابع. عندما يُعدَّل الكائن String (أو يُحذَف)، يصبح أي مؤشر أعيد مسبقًا عبر الدالة c_str()‎ غير صالحٍ، ولا يجب استعماله بعد ذلك الحين. البنية العامة ...

يقارن التابع casecmp بين رمزين بشكل غير حساس لحالة الأحرف. هذا التابع هو نسخة غير حساسة لحالة الأحرف (Case-insensitive) من المعامل <=>‎. في الوقت الحالي، لا تعمل الحساسية لحالة الأحرف إلا على الأحرف A-Z/a-z، وليس على كل محارف اليونيكود. هذا السلوك مختلف عن التابع casecmp?‎. البنية العامة casecmp(other_symbol)→ -1, 0, +1, or nil‎ المعاملات other_symbol‎ الرمز المراد التحقق من مقارنته مع الرمز المعطى. القيمة المعادة تعاد القيمة ‎-1 أو 0 أو ‎+1 أو بناءً على ما إذا كان الرمز أصغر من أو يساوي أو أكبر من other_symbol. أو ...

يحوِّل التابع c_str()‎ محتوى السلسلة النصية التي استدعيت معه إلى نمط السلسلة النصية المثالية في C (السلسلة النصية المنتهية بالمحرف null). انتبه إلى أنَّ هذا التابع يعدِّل السلسلة النصية المعطاة عبر الوصول إلى عنوانها الداخلي في الذاكرة، لذا يجب توخي الحذر عند استعماله. تحديدًا، لا يجب عليك تعديل السلسلة النصية عبر المؤشر الذي يعيده هذا التابع. عندما يُعدَّل الكائن String (أو يُحذَف)، يصبح أي مؤشر أعيد مسبقًا عبر الدالة c_str()‎ غير صالحٍ، ولا يجب استعماله بعد ذلك الحين. البنية العامة ...

يحوِّل التابع toUpperCase()‎ جميع حروف السلسلة النصية التي استدعيت معه إلى حروف كبيرة (upper-case). بدءًا من الإصدار 1.0، أصبح التابع toUpperCase()‎ يعدِّل السلسلة النصية نفسها بدلًا من إعادة سلسلة نصية أخرى ناتجة عن عملية التحويل. البنية العامة string.toUpperCase() تمثِّل string السلسلة النصية المراد تحويل جميع حروفها إلى الحالة الكبيرة. القيم المعادة لا يعاد أي شيء. أمثلة مثال على استعمال التابع toUpperCase()‎: String stringValue = "Wiki WIKI Wiki Hsoub"; void setup() { Serial.begin(9600); } void loop() { stringValue.toLowerCase(); Serial.println(stringValue3); // wiki wiki ...

يحوِّل التابع toUpperCase()‎ جميع حروف السلسلة النصية التي استدعيت معه إلى حروف كبيرة (upper-case). بدءًا من الإصدار 1.0، أصبح التابع toUpperCase()‎ يعدِّل السلسلة النصية نفسها بدلًا من إعادة سلسلة نصية أخرى ناتجة عن عملية التحويل. البنية العامة string.toUpperCase() تمثِّل string السلسلة النصية المراد تحويل جميع حروفها إلى الحالة الكبيرة. القيم المعادة لا يعاد أي شيء. أمثلة مثال على استعمال التابع toUpperCase()‎: String stringValue = "Wiki WIKI Wiki Hsoub"; void setup() { Serial.begin(9600); } void loop() { stringValue.toLowerCase(); Serial.println(stringValue3); // wiki wiki ...

يحوِّل التابع toLowerCase()‎ جميع حروف السلسلة النصية التي استدعيت معها إلى حروف صغيرة (lower-case). بدءًا من الإصدار 1.0، أصبح التابع toLowerCase()‎ يعدِّل السلسلة النصية نفسها بدلًا من إعادة سلسلة نصية أخرى ناتجة عن عملية التحويل. البنية العامة string.toLowerCase() تمثِّل string السلسلة النصية المراد تحويل جميع حروفها إلى الحالة الصغيرة. القيم المعادة لا يعاد أي شيء. أمثلة مثال على استعمال التابع toLowerCase()‎: String stringValue = "Wiki WIKI Wiki Hsoub"; void setup() { Serial.begin(9600); } void loop() { stringValue.toLowerCase(); Serial.println(stringValue3); // wiki wiki ...

يحوِّل التابع toLowerCase()‎ جميع حروف السلسلة النصية التي استدعيت معها إلى حروف صغيرة (lower-case). بدءًا من الإصدار 1.0، أصبح التابع toLowerCase()‎ يعدِّل السلسلة النصية نفسها بدلًا من إعادة سلسلة نصية أخرى ناتجة عن عملية التحويل. البنية العامة string.toLowerCase() تمثِّل string السلسلة النصية المراد تحويل جميع حروفها إلى الحالة الصغيرة. القيم المعادة لا يعاد أي شيء. أمثلة مثال على استعمال التابع toLowerCase()‎: String stringValue = "Wiki WIKI Wiki Hsoub"; void setup() { Serial.begin(9600); } void loop() { stringValue.toLowerCase(); Serial.println(stringValue3); // wiki wiki ...

يحول التابع toInt()‎ السلسلة النصية التي استدعيت معه إلى عددٍ صحيحٍ. يجب على السلسلة النصية المراد تحويلها أن تبدأ برقم. البنية العامة string.toInt() تمثِّل string السلسلة النصية المراد تحويلها إلى عددٍ صحيحٍ. القيم المعادة يعاد عددٌ طويلٌ يمثِّل ناتج تحويل السلسلة النصية المعطاة. إن لم يكن بالإمكان إجراء عملية التحويل لأنَّ السلسلة النصية تلك لا تبدأ بعددٍ صحيحٍ صالح، فسيُعاد العدد 0 آنذاك. أمثلة مثال على استعمال التابع toInt()‎: String stringValue1 = "12wiki Hsoub"; String stringValue2 = "wiki12Hsoub"; void setup() { Serial.begin(9600); } void ...

يحول التابع toCharArray()‎ كامل السلسلة النصية التي استدعيت معه أو جزءًا منها إلى سلسلة نصية مكوَّنة من مصفوفة من المحارف. البنية العامة string.toCharArray(buf, len) تمثِّل string السلسلة النصية التي يراد نسخها إلى الذاكرة buf ذات الحجم len التي تمثِّل مصفوفةً من المحارف. المعاملات buf الذاكرة المراد نسخ محارف السلسلة النصية المعطاة إليها. تمثِّل هذه الذاكرة مصفوفة من المحارف. len عددٌ صحيحٌ يحدِّد طول الجزء المراد نسخه وتحويله. القيم المعادة لا يعاد أي شيء. أمثلة مثال على استعمال التابع toCharArray()‎: String stringValue ...

يحول التابع toInt()‎ السلسلة النصية التي استدعيت معه إلى عددٍ صحيحٍ. يجب على السلسلة النصية المراد تحويلها أن تبدأ برقم. البنية العامة string.toInt() تمثِّل string السلسلة النصية المراد تحويلها إلى عددٍ صحيحٍ. القيم المعادة يعاد عددٌ طويلٌ يمثِّل ناتج تحويل السلسلة النصية المعطاة. إن لم يكن بالإمكان إجراء عملية التحويل لأنَّ السلسلة النصية تلك لا تبدأ بعددٍ صحيحٍ صالح، فسيُعاد العدد 0 آنذاك. أمثلة مثال على استعمال التابع toInt()‎: String stringValue1 = "12wiki Hsoub"; String stringValue2 = "wiki12Hsoub"; void setup() { Serial.begin(9600); } void ...

يحول التابع toCharArray()‎ كامل السلسلة النصية التي استدعيت معه أو جزءًا منها إلى سلسلة نصية مكوَّنة من مصفوفة من المحارف. البنية العامة string.toCharArray(buf, len) تمثِّل string السلسلة النصية التي يراد نسخها إلى الذاكرة buf ذات الحجم len التي تمثِّل مصفوفةً من المحارف. المعاملات buf الذاكرة المراد نسخ محارف السلسلة النصية المعطاة إليها. تمثِّل هذه الذاكرة مصفوفة من المحارف. len عددٌ صحيحٌ يحدِّد طول الجزء المراد نسخه وتحويله. القيم المعادة لا يعاد أي شيء. أمثلة مثال على استعمال التابع toCharArray()‎: String stringValue ...

تعمل هذه الدوال مع المحارف بشكل عام، إذ تتحقَّق من كون محرف محدَّد ينتمي إلى مجموعةٍ معيَّنة من المحارف. isAlpha()‎ تتحقَّق الدالة isAlpha()‎ إن كان المحرف المُمرَّر إليها محرفًا أبجديًّا. isAlphaNumeric()‎ تتحقَّق الدالة isAlphaNumeric()‎ إن كان المحرف المُمرَّر إليها محرفًا أبجديًّا أو عددًا. isAscii()‎ تتحقَّق الدالة isAscii()‎ إن كان المحرف المُمرَّر إليها أحدَ المحارف Ascii. isControl()‎ تتحقَّق الدالة isControl()‎ إن كان المحرف المُمرَّر إليها أحدَ محارف التحكم (control character). isDigit()‎ تتحقَّق الدالة isDigit()‎ إن كان المحرف المُمرَّر إليها رقمًا. isGraph()‎ ...

لدى لغة روبي العديد من الطرق للتحكم في مسار تنفيذ البرنامج، وكل البنى المذكورة هنا تعيد قيمةً. في الاختبارات الشرطيّة في بنى التحكّم، تعدّ القيمة nil و false على أنّها قيم خطأ، بينما تُعدُّ القيمة true وأيّ كائن آخر على أنه قيم صحيحة. وفي هذا التوثيق، سنستخدم true للتعبير عن القيم الصحيحة و false للتعبير عن القيم الخطأ. بنية If الشرطية أبسط أشكال بنية if الشرطيّة يحتوي على جزأين، الاختبار الشّرطي، والجزء التّنفيذي then. هذه بنية if بسيطة: if true ...

(PHP 4, PHP 5, PHP 7) تقدّم بنية foreach طريقة سهلة للتنقل بين عناصر المصفوفات، وتعمل هذه البنية مع المصفوفات والكائنات فقط، ويؤدي استخدامها مع متغير ذي نوع بيانات مختلف أو متغير غير مهيئ إلى إطلاق خطأ. لهذه البنية صيغتان: foreach (array_expression as $value) statement foreach (array_expression as $key => $value) statement تنتقل الصيغة الأولى عبر المصفوفة بحسب التعبير المقدّم إليها (array_expression). وفي كل دورة تسند اللغة قيمة العنصر الحالي إلى المتغير ‎$value ويتقدّم المؤشر ...

(PHP 4, PHP 5, PHP 7) تقدّم بنية foreach طريقة سهلة للتنقل بين عناصر المصفوفات، وتعمل هذه البنية مع المصفوفات والكائنات فقط، ويؤدي استخدامها مع متغير ذي نوع بيانات مختلف أو متغير غير مهيئ إلى إطلاق خطأ. لهذه البنية صيغتان: foreach (array_expression as $value) statement foreach (array_expression as $key => $value) statement تنتقل الصيغة الأولى عبر المصفوفة بحسب التعبير المقدّم إليها (array_expression). وفي كل دورة تسند اللغة قيمة العنصر الحالي إلى المتغير ‎$value ويتقدّم المؤشر ...

التعبير البرمجي return يؤدي إلى إنهاء تنفيذ الدالة ويُحدِّد قيمةً لتُعيدها الدالة إلى التعبير الذي استدعاها. البنية العامة return [[expression]]; expression التعبير البرمجي الذي ستُعاد قيمته، وإذا لم يُحدَّد فستُعاد القيمة undefined. الوصف عندما يُستخدَم التعبير البرمجي return في جسم الدالة، فسيتوقف تنفيذ الدالة؛ وستُعاد القيمة المعطية (إن وجِدَت) إلى التعبير الذي استدعى الدالة. فعلى سبيل المثال، ستعيد الدالة الآتية مربّع الوسيط x، على أن يكون الوسيط x رقميًا: function square(x) { return x * x; } var demo = ...

تتحقق الدالة isDigit()‎ إن كان المحرف الذي استٌدعيت معه رقمًا أم لا. البنية العامة inline fun Char.isDigit(): Boolean المنصة المطلوبة: JVM. وجود الكلمة المفتاحية inline يدل على أنَّ هذه الدالة مباشرة (للمزيد من التفاصيل، ارجع إلى صفحة الدوال المباشرة (inline functions)). القيم المعادة تعاد القيمة true إن حال كان المحرف المعطى رقمًا، أو القيمة false خلاف ذلك. أمثلة مثالٌ على استعمال الدالة isDigit()‎: fun main(args: Array<String>) { val x = 'a' val y = '5' print(x.isDigit()) ...

المعاملات الرياضية (arithmetic operators) تأخذ قيمًا عدديةً وتُعيد قيمةً عدديةً واحدةً، والمعاملات الرياضية القياسية هي الجمع + والطرح - والضرب * والقسمة /. الجمع (+) معامل الجمع يُنتِج مجموع المدخلات الرقمية، أو يضيف سلسلتين نصيتين إلى بعضها. البنية العامة x + y أمثلة // رقم + رقم -> عملية جمع 1 + 2 // 3 // رقم + قيمة منطقية -> عملية جمع true + 1 // 2 // قيمة منطقية + قيمة منطقية -> عملية جمع false + false // 0 // رقم + سلسلة ...

يعيد التابع downcase نسخةً من السلسلة النصية التي استدعي معها مع استبدال الحروف الكبيرة بنظائرها الصغيرة. استبدال الحروف بحروف أخرى يعتمد على المعامل المُمرَّر إلى التابع، وعلى ترميز السلسلة النصية المعطاة. البنية العامة downcase → new_str downcase([options]) → new_str المعاملات options يُستخدم للتحكم بعملية التبديل ويأخذ إحدى القيم التالية: الخيار الوصف بدون خيار يمثِّل ربط (mapping) محارف اليونيكود (Unicode) الكاملة ذات الحالة الكبيرة والصغيرة مع بعضها لتبديلها، وهذا مناسب لأغلب اللغات (اطلع على الخيار turkic: والخيار lithuanian: في الأسفل، إذ تعد ...

يحوِّل التابع toFloat()‎ السلسلة النصية التي استدعيت معه إلى عددٍ عشري. يجب على السلسلة النصية المراد تحويلها أن تبدأ برقم. إن لم تحوي السلسلة النصية على أي محرف رقمي، فستتوقف عملية التحويل. على سبيل المثال، ستحول السلاسل النصية "123.45"، و "123"، و "123fish" إلى 123.45، و 123.00، و 123.00 على التوالي. انتبه إلى أنَّ السلسلة النصية "123.456" ستحوَّل وتقرَّب إلى 123.46. انتبه أيضًا إلى أنَّ الأعداد العشرية تملك دقة محدودة تتراوح بين 6 و 7 منازل عشرية، لذا ستُقرَّب السلاسل ...

يحوِّل التابع toFloat()‎ السلسلة النصية التي استدعيت معه إلى عددٍ عشري. يجب على السلسلة النصية المراد تحويلها أن تبدأ برقم. إن لم تحوي السلسلة النصية على أي محرف رقمي، فستتوقف عملية التحويل. على سبيل المثال، ستحول السلاسل النصية "123.45"، و "123"، و "123fish" إلى 123.45، و 123.00، و 123.00 على التوالي. انتبه إلى أنَّ السلسلة النصية "123.456" ستحوَّل وتقرَّب إلى 123.46. انتبه أيضًا إلى أنَّ الأعداد العشرية تملك دقة محدودة تتراوح بين 6 و 7 منازل عشرية، لذا ستُقرَّب السلاسل ...

يُعيد التابع encoding كائنًا من النوع Encoding، والذي يمثل ترميز الكائن الذي استُدعي معه. البنية العامة encoding→ encoding‎ القيمة المعادة يعاد كائنٌ من النوع Encoding يمثِّل الترميز المستعمل. انظر أيضًا التابع casefold?‎: يعيد قيمة راية الحساسية لحالة الأحرف (case-insensitive flag). مصادر قسم التابع encoding‎ في الصنف Regexp‎ في توثيق روبي الرسمي.

يستدعي المعامل === كتلة التابع مع تمرير الكائن الواقع على يمينه كوسيط إلى المعامل الواقع على يساره كما هو الحال في Proc.call. هذا يَسمح لكائنٍ من النوع proc أن يكون هدفًا للكتلة when في التعليمة case. البنية العامة proc === obj→ result_of_proc‎ القيمة المعادة تعاد نتيجة الوسيط proc. انظر أيضا التابع ==: يتحقق من تساوي كائنين من النوع Method. مصادر قسم التابع ===‎ في الصنف Method‎ في توثيق روبي الرسمي.

تُستعمَل الكلمة break المفتاحية للخروج من الحلقات for، أو while، أو do...while التكرارية، إذ تتخطى الشيفرة التي بعدها وشروط الحلقة المحددِّة وتخرج منها. تُستعمَل أيضًا للخروج من التعبير switch...case البرمجي. البنية العامة break; أمثلة في الشيفرة التالية، يخرج المتحكم من الحلقة for عندما تتجاوز قيمة الحساس المقاسة عتبة معينة: for (x = 0; x < 255; x ++) { analogWrite(PWMpin, x); sens = analogRead(sensorPin); if (sens > threshold){ ...

تتلخص مهمة عبارة ORDER BY بترتيب النتائج (تصاعديًا أو تنازليًا) ضمن استعلام SELECT وفق عمودٍ (أو أكثر) من الجدول. تحديد نمط الترتيب التصاعدي أو التنازلي تُستخدم الكلمتان المفتاحيتان ASC و DESC لتحديد نمط الترتيب التصاعدي ASC والتنازلي DESC بعدّ الترتيب التصاعدي الحالة الافتراضية للعبارة. ليكن الجدول rivers الآتي موجودًا في قاعدة البيانات: Continent Outflow LengthMiles LengthKm River Serial South America Atlantic Ocean 4345 6992 Amazon 1 Africa Mediterranean 4258 6853 Nile 2 North America Gulf of Mexico 3902 6275 Mississippi ...

التعبير yield*‎ يُستخدَم لتفويض التنفيذ إلى دالة مولِّدة أخرى أو كائن iterable. البنية العامة yield* [[expression]]; expression التعبير الذي سيُعيد كائن iterable. الوصف سيؤدي التعبير yield*‎ إلى المرور على عناصر الكائن ويعطي كل قيمة أعادها هذا الكائن. قيمة التعبير yield*‎ نفسه هي القيمة المُعادة من الكائن iterable عند إغلاقه (أي عندما تكون قيمة الخاصية done هي true). أمثلة تفويض التنفيذ إلى دالة مولِّدة أخرى لاحظ أنَّ القيمة التي تعطيها (yield) الدالة g1()‎ ستُعاد عند استدعاء الدالة next()‎ مثل القيم ...

(PHP 4, PHP 5, PHP 7) تستخدم بنية declare لتعيين موجّهات التنفيذ (execution directives) لكتلة من الشيفرة، وصيغة declare مشابهة لبنى التحكم في تدفق الشيفرة. الوصف declare (directive) statement يتيح الموجه تعيين سلوك كتلة (block). يمكن للغة في الوقت الحاضر أن تتعرف على ثلاثة أنواع من الموجهات فقط: موجه ticks (للمزيد من المعلومات حول موجه ticks انظر أدناه)، وموجه encoding (للمزيد من المعلومات حول موجه encoding انظر أدناه)، وموجه strict_types (للمزيد من المعلومات راجع قسم strict في ...

(PHP 4, PHP 5, PHP 7) تستخدم بنية declare لتعيين موجّهات التنفيذ (execution directives) لكتلة من الشيفرة، وصيغة declare مشابهة لبنى التحكم في تدفق الشيفرة. الوصف declare (directive) statement يتيح الموجه تعيين سلوك كتلة (block). يمكن للغة في الوقت الحاضر أن تتعرف على ثلاثة أنواع من الموجهات فقط: موجه ticks (للمزيد من المعلومات حول موجه ticks انظر أدناه)، وموجه encoding (للمزيد من المعلومات حول موجه encoding انظر أدناه)، وموجه strict_types (للمزيد من المعلومات راجع قسم strict في ...

تتحقَّق الدالة isSpace()‎ إن كان المحرف المُمرَّر إليها فراغًا (space). البنية العامة isSpace(thisChar) المعاملات thisChar المحرف المراد التحقُّق منه. القيم المعادة تعاد القيمة true إن كان المعامل thisChar فراغًا. أمثلة مثالٌ على استعمال الدالة isSpace()‎: if (isSpace(this)) // فراغًا this التحقق إن كان المتغير { Serial.println("المحرف هو فراغ"); } else { Serial.println("ليس المحرف فراغًا"); } انظر أيضًا الدالة isAlpha()‎: تتحقَّق إن كان المحرف المُمرَّر إليها محرفًا أبجديًّا. الدالة isAlphaNumeric()‎: تتحقَّق إن كان المحرف المُمرَّر إليها محرفًا أبجديًّا أو عددًا. الدالة isAscii()‎ : تتحقَّق ...

تتحقَّق الدالة isDigit()‎ إن كان المحرف المُمرَّر إليها رقمًا. البنية العامة isDigit(thisChar) المعاملات thisChar المحرف المراد التحقُّق منه. القيم المعادة تعاد القيمة true إن كان المعامل thisChar رقمًا. أمثلة مثالٌ على استعمال الدالة isDigit()‎: if (isDigit(this)) // رقمًا this التحقق إن كان المتغير { Serial.println("المحرف هو رقم"); } else { Serial.println("ليس المحرف رقمًا"); } انظر أيضًا الدالة isAlpha()‎: تتحقَّق إن كان المحرف المُمرَّر إليها محرفًا أبجديًّا. الدالة isAlphaNumeric()‎: تتحقَّق إن كان المحرف المُمرَّر إليها محرفًا أبجديًّا أو عددًا. الدالة isAscii()‎ : تتحقَّق إن ...

تتحقَّق الدالة isAlpha()‎ إن كان المحرف المُمرَّر إليها محرفًا أبجديًّا. البنية العامة isAlpha(thisChar) المعاملات thisChar المحرف المراد التحقُّق منه. القيم المعادة تعاد القيمة true إن كان المعامل thisChar محرفًا أبجديًّا. أمثلة مثالٌ على استعمال الدالة isAlpha()‎: if (isAlpha(this)) // محرفًا أبجديًّا this التحقق إن كان المتغير { Serial.println("المحرف هو محرف أبجدي"); } else { Serial.println("ليس المحرف محرفًا أبجديًّا"); } انظر أيضًا الدالة isAlphaNumeric()‎: تتحقَّق إن كان المحرف المُمرَّر إليها محرفًا أبجديًّا أو عددًا. الدالة isAscii()‎ : تتحقَّق إن كان المحرف المُمرَّر إليها أحدَ ...

تتحقَّق الدالة isGraph()‎ إن كان المحرف المُمرَّر إليها قابلًا للطباعة (printable) ويحوي بعض المحتوى المرئي (الفراغ قابلٌ للطباعة ولكنه لا يملك محتوى مرئي). البنية العامة isGraph(thisChar) المعاملات thisChar المحرف المراد التحقُّق منه. القيم المعادة تعاد القيمة true إن كان المعامل thisChar قابلًا للطباعة. أمثلة مثالٌ على استعمال الدالة isGraph()‎: if (isGraph(this)) // قابلًا للطباعة this التحقق إن كان المتغير { Serial.println("المحرف هو محرف قابلٌ للطباعة"); } else { Serial.println("ليس المحرف قابلًا للطباعة"); } انظر أيضًا الدالة isAlpha()‎: تتحقَّق إن كان المحرف المُمرَّر ...