نتائج البحث

يفك التابع ترميز البايتات الممرّرة إليه إلى سلسلة نصية. البنية العامة bytes.decode(encoding="utf-8", errors="strict") المعاملات encoding يحدّد هذا المعامل الترميز الذي سيستخدمه التابع في عمله، ويأخذ القيمة الافتراضية 'utf-8'. وللاطلاع على قائمة بالترميزات المتاحة راجع قسم الترميزات القياسية. ملاحظة: يسمح تمرير المعامل encoding إلى السلسلة النصية بفك ترميز أي كائن شبيه بالبايت bytes-like object على نحو مباشر، دون الحاجة إلى إنشاء كائن بايتات أو كائن مصفوفة بايتات مؤقت. errors يحدّد المعامل error الطريقة المطلوبة للتعامل مع الأخطاء. يأخذ هذا المعامل القيمة ...

يفك التابع ترميز البايتات الممرّرة إليه إلى سلسلة نصية. البنية العامة bytes.decode(encoding="utf-8", errors="strict") المعاملات encoding يحدّد هذا المعامل الترميز الذي سيستخدمه التابع في عمله، ويأخذ القيمة الافتراضية 'utf-8'. وللاطلاع على قائمة بالترميزات المتاحة راجع قسم الترميزات القياسية. ملاحظة: يسمح تمرير المعامل encoding إلى السلسلة النصية بفك ترميز أي كائن شبيه بالبايت bytes-like object على نحو مباشر، دون الحاجة إلى إنشاء كائن بايتات أو كائن مصفوفة بايتات مؤقت. errors يحدّد المعامل error الطريقة المطلوبة للتعامل مع الأخطاء. يأخذ هذا المعامل القيمة ...

يُعيد التابع stat المعلومات الداخلية للمتعقب. المحتويات المعادة مُتعلقة بالتنفيذ (implementation). وقد تتغير في المستقبل. هذا التابع مخصوص بتصحيح (debugging) الصنف TracePoint نفسه. البنية العامة stat → obj‎ القيمة المعادة تعاد المعلومات الداخلية للمتعقب. انظر أيضًا التابع new: يُعيد متعقبًا جديدًا. التابع trace: ينشِّط التعقب تلقائيًا. مصادر قسم التابع stat‎ في الصنف TracePoint‎ في توثيق روبي الرسمي.

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

(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 في ...

القاعدة ‎@font-face في CSS تسمح للمطورين بتحديد خطوط خاصة لعرض النص الموجود في صفحات الويب، وذلك بالسماح للمطورين بتعريف خطوط خاصة بهم، والقاعدة ‎@font-face أدت إلى فتح المجال أمام المطورين لاستخدام أي خطٍ يشاؤون بدل أن يكونوا محدودين ببعض الخطوط المثبتة على حاسوب الزوار. @font-face { /* تعليمات تعريف الخط الجديد */ } أمثلة كما سنذكر في قسم «البنية العامة»، يجب تحديد قيمة للواصف font-family و src على الأقل لتعريف القاعدة ‎@font-face كما في المثال الآتي: @font-face { ...

تعيد الدالة floor()‎ العدد الصحيح الأقرب والأصغر من العدد الممرَّر إليها. البنية العامة floor($number) المعاملات ‎$number العدد المراد تقريبه إلى أصغر عدد صحيح. القيم المعادة يُعاد العدد الصحيح الأصغر والأقرب للعدد ‎$number. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن لم يكن المعامل ‎$number عددًا. أمثلة مثال عن استخدام الدالة floor()‎ لضبط قيمة العرض (width): .selector { width: floor(10.6px) // 10px } سيُصرّف المثال السابق إلى شيفرة CSS الآتية: .selector { width: 10px; } انظر أيضًا الدالة round()‎: تقرِّب العدد الممرَّر إليها. الدالة ()ceil‎: تعيد أقرب عدد ...

(PHP 4, PHP 5, PHP 7) تحصي الدالة array_count_values()‎ عدد مرات تكرار كل قيمة موجودة داخل المصفوفة. الوصف array array_count_values ( array $array ) تنشئ الدالة array_count_values()‎ مصفوفةً جديدةً تحتوي على القيم الموجودة بالمصفوفة المُمَرََرة بالمعامل array كمفاتيح، وعدد مرات تكرار كل قيمة في هذه المصفوفة كقيم مرتبطة بتلك المفاتيح. المعاملات array مصفوفة تحتوي على قيم تحصي هذه الدالة عدد مرات تكرار كل واحدة منها. القيم المعادة تعيد الدالة مصفوفة جديدة من القيم الموجودة بالمصفوفة المُمَرََرة، ويرتبط مع كل قيمة ...

تقرِّب الدالة round()‎ العدد الممرَّر إليها إلى أقرب عدد صحيح. البنية العامة round($number) المعاملات ‎$number العدد المراد تقريبه. القيم المعادة يُعاد العدد الصحيح الأقرب للعدد ‎$number. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن لم يكن ‎$number عددًا. أمثلة مثال عن استخدام الدالة round()‎  لضبط قيمة العرض (width): .selector { width: round(10.4px); // 10px height: round(10.6px); // 11px } سيُصرّف المثال السابق إلى شيفرة CSS الآتية: .selector { width: 10px; height: 11px; } انظر أيضًا الدالة floor()‎: تعيد أقرب عدد صحيح أصغر من العدد ...

تعيد الدالة ()alpha‎ قيمة مكوّن قناة الشفافيَّة (alpha) للون الممرَّر إليها. تكون قيمته عادةً 1 إلا في حال تعديلها. البنية العامة alpha($color) المعاملات ‎$color اللون الذي ستُستخرج قيمة قناة الشفافيَّة له. القيم المعادة تُعاد قيمةُ مُكوّنِ قناة الشفافيَّة، وتنحصر بين 0 و 1. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن لم يكن المعامل ‎$color لونًا. أمثلة أمثلة نموذجية عن استخدام الدالة alpha()‎: alpha(#f00); // ...

تعيد الدالة max()‎ القيمة الأكبر من بين مجموعة الأعداد الممرَّرة إليها. تقبل هذه الدالة عددًا غير محدَّد من المعاملات. البنية العامة max($numbers...) المعاملات ‎$numbers مجموعة من الأعداد المراد معرفة القيمة الكبرى لها. القيم المعادة يُعاد العدد الأكبر من بين الأعداد ‎$numbers الممرَّرة. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن لم يكن أيٌّ قيمة من قيم المعاملات ‎$numbers عددًا، أو كان لتلك القيم واحدات غير متماثلة. أمثلة مثال عن استخدام الدالة max()‎  لضبط قيمة العرض (width): .selector { width: max(10px, 40px) // 40px } سيُصرّف ...

تعيد الدالة ()complement مكمّل اللون (complement of a color) الممرَّر إليها، وتكافئ استدعاء الدالة adjust_hue(color, 180deg)‎. البنية العامة complement($color) المعاملات ‎$color القيمة اللونيَّة المراد الحصول على القيمة المكملة لها. القيم المعادة تُعاد القيمة اللونيَّة المكملة للون ‎$color. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن لم يكن ‎$color لونًا. أمثلة المثال الآتي سيضبط لون العنصر (color) إلى اللون البنفسجي (purple)، الذي هو مُكمِّل اللون الأخضر، وذلك بتمرير القيمة green إلى الدالة complement()‎: .selector { color: complement(green); // purple } ستصرّف الشيفرة السابقة إلى شيفرة ...

تعيد الدالة min()‎ القيمة الأصغر من بين مجموعة من الأعداد الممرَّرة إليها. تقبل هذه الدالة عددًا غير محدَّد من المعاملات. البنية العامة min($numbers...) المعاملات ‎$numbers مجموعة من الأعداد المراد معرفة القيمة الصغرى لها. القيم المعادة يُعاد العدد الأصغر من بين الأعداد ‎$numbers الممرَّرة الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن لم يكن أيٌّ قيمة من قيم المعاملات ‎$numbers عددًا، أو كان لتلك القيم واحدات غير متماثلة. أمثلة مثال عن استخدام الدالة min()‎  لضبط قيمة العرض (width): .selector { width: min(10px, 40px) // ...

تعيد الدالة map_keys()‎ قائمة تحتوي على مفاتيح الخريطة (map) الممرَّرة إليها فقط. البنية العامة map_keys($map) المعاملات ‎$map الخريطة المراد الحصول على مفاتيحها فقط. القيم المعادة تُعاد قائمة تحتوي على مفاتيح الخريطة ‎$map فقط، وتُفصل تلك المفاتيح بفواصل (comma). الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن لم يكن المعامل ‎$map خريطة. أمثلة مثال عن استخدام الدالة map_keys()‎: map-keys(("foo": 1, "bar": 2)) // "foo", "bar" انظر أيضًا الدالة map_values()‎: تُعيد قائمة تحتوي على قيم الخريطة فقط. الدالة map_merge()‎: تدمج خريطتين في خريطة واحدة. الدالة ...

(PHP 4, PHP 5, PHP 7) تحصي الدالة array_count_values()‎ عدد مرات تكرار كل قيمة موجودة داخل المصفوفة. الوصف array array_count_values ( array $array ) تنشئ الدالة array_count_values()‎ مصفوفةً جديدةً تحتوي على القيم الموجودة بالمصفوفة المُمَرََرة بالمعامل array كمفاتيح، وعدد مرات تكرار كل قيمة في هذه المصفوفة كقيم مرتبطة بتلك المفاتيح. المعاملات array مصفوفة تحتوي على قيم تحصي هذه الدالة عدد مرات تكرار كل واحدة منها. القيم المعادة تعيد الدالة مصفوفة جديدة من القيم الموجودة بالمصفوفة المُمَرََرة، ويرتبط مع كل قيمة ...

(PHP 5 >= 5.1.0, PHP 7) تُأَخِّرُ الدالةُ time_sleep_until()‎ تنفيذَ البرنامج حتى الوقت المحدد. الوصف bool time_sleep_until ( float $timestamp ) تُأَخِّرُ الدالةُ time_sleep_until()‎ تنفيذَ البرنامج حتى تحقيق الزمن المضاف للمعامل timestamp. المعاملات timestamp المعامل timestamp هو الزمن الذي ينبغي أن يعمل البرنامج عنده. القيم المعادة تعيد الدالة time_sleep_until()‎ القيمة TRUE عند نجاح تنفيذها، أو القيمة FALSE عند حدوث خطأ. سجل التغييرات الإصدار الوصف 5.3.0 صارتْ الدالةُ time_sleep_until()‎ الآن مُتاحةً على منصات ويندوز. الأخطاء والاستثناءات إذا كان الزمن المحدد للمعامل timestamp ...

يوفر الصنف TracePoint وظائف Kernel.set_trace_func على شكل واجهة برمجية كائنية (Object-Oriented API). مثال يمكننا استخدام المتعقبات (كائنات الصنف TracePoint) لجمع المعلومات بخصوص الاستثناءات: trace = TracePoint.new(:raise) do |tp| p [tp.lineno, tp.event, tp.raised_exception] end #=> #<TracePoint:disabled> trace.enable #=> false 0 / 0 #=> [5, :raise, #<ZeroDivisionError: divided by 0>]‎ الأحداث إذا لم تحدِّد نوع الأحداث التي تريد الاستماع إليها، فسيشمل المتعقب TracePoint جميع الأحداث المتاحة. ملحوظة: لا تعتمد على مجموعة الأحداث الحالية، إذ أن هذه القائمة عرضةٌ للتغيير. بدلًا من ذلك، يُنصَح بتحديد نوع ...

يمكن تعريف الدالة باستخدام الصيغة التالية: المثال 1: صيغة التعريف عن الدوال <?php function foo($arg_1, $arg_2, /* ..., */ $arg_n) { echo "Example function.\n"; return $retval; } ?> يمكن إضافة أي نوع من الشيفرة داخل الدالة، بل ويمكن إضافة دوالّ أخرى أو تعريف أصناف داخل الدالة. تتبع أسماء الدوالّ نفس القواعد المتبّعة في اللغة للتسمية. يبدأ الاسم الصحيح للدالة بحرف أو شرطة سفلية، متبوعًا بأيّ عددٍ من الحروف أو الأرقام أو الشرطات السفلية. ويمكن التعبير عن هذه الصيغة باستخدام التعابير النمطية بالصورة التالية: ‎[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*‎. نصيحة: راجع ...

يمكن تعريف الدالة باستخدام الصيغة التالية: المثال 1: صيغة التعريف عن الدوال <?php function foo($arg_1, $arg_2, /* ..., */ $arg_n) { echo "Example function.\n"; return $retval; } ?> يمكن إضافة أي نوع من الشيفرة داخل الدالة، بل ويمكن إضافة دوالّ أخرى أو تعريف أصناف داخل الدالة. تتبع أسماء الدوالّ نفس القواعد المتبّعة في اللغة للتسمية. يبدأ الاسم الصحيح للدالة بحرف أو شرطة سفلية، متبوعًا بأيّ عددٍ من الحروف أو الأرقام أو الشرطات السفلية. ويمكن التعبير عن هذه الصيغة باستخدام التعابير النمطية بالصورة التالية: ‎[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*‎. نصيحة: راجع ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة fileperms()‎ الأذونات الحاليَّة لملف محدَّد. الوصف int fileperms ( string $filename ) تعيد هذه الدالة الأذونات التي تخصُّ الملف filename. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. القيم المعادة تُعاد أذونات الملف filename في الصيغة العدديَّة. الأرقام المُعادة التي تمثِّل الأذونات هي نفسها التي تحاول الدالة chmod()‎ تغييرها (راجع شرح المعامل mode في تلك الدالة)، وتتضمَّن أحيانًا القيمة المُعادة في بعض المنصات معلوماتٍ عن نوع الملف filename أيضًا. يوضِّح المثال 2 كيفيَّة ...

يُنشئ التّابع new:: كائنًا جديدًا من الصنف Encoding::Converter. التّرميز المصدر والتّرميز الوجهة يجب أن يكونا إما سلسلةً نصّيةً أو كائنًا من الصّنف Encoding. يقبل التّابع new:: اختياريًّا أن يمرر إليه خيارٌ من النوع hash أو integer. عندما يكون من النوع hash، فمن الممكن أن يحتوي على ‎:invalid => nil وغيرها. وعندما يكون من النوع integer، فإنه يجب أن يكون منطقيًّا (logical)، أو أحد الثوابت المعرَّفة مثل Encoding::Converter::INVALID_REPLACE وغيرها. تكون بنية الخيار الممرر إلى التابع عندما يكون من النوع hash بالشكل: ...

الكائن JSON يحتوي على الدوال التي تُفسِّر صيغة JavaScript Object Notation (اختصارًا JSON) وتحوّل القيم إلى صيغة JSON. ليس الغرض من هذا الكائن هو تهيئته أو بناؤه (عبر المعامل new)، وليس له عملٌ خاصٌ به باستثناء وجود دالتين تابعتين له. الوصف صيغة JSON هي صيغة لتخزين الكائنات والمصفوفات والأعداد والسلاسل النصية والقيم المنطقية والقيمة null؛ وهي مبنية على صيغة JavaScript لكنها تختلف عنها، فبعض شيفرات JavaScript ليست صالحةً في JSON، وبعض شيفرات JSON ليس صالحةً في JavaScript. الجدول الآتي يعرض ...

تجعل الدالة ()lighten اللون أكثر سطوعًا (lightness) إذ يمرَّر إليها لونًا وعددًا يتراوح بين ‎0% و ‎100% ثمَّ تعيد بعدئذ ذلك اللون بعد زيادة السطوع بحسب القيمة الأخيرة. البنية العامة #lighten ($color, $amount) المعاملات ‎$color قيمة اللون المراد تعديله. ‎$amount قيمة السطوع المراد زيادتها، وتتراوح بين ‎0% و ‎100%. القيم المعادة يُعاد اللون ‎$color بعد زيادة إضاءته بحسب القيمة ‎$amount. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن كان أحد المعاملات من النوع الخطأ، أو إن كانت قيمة المعامل ‎$amount خارج المجال المسموح. ...

تجعل الدالة ()opacify  (تٌسمّى أيضًا fade_in) اللون أكثر عتامةً. يمرَّر إليها لونًا وعددًا بين 0 و 1 ثمَّ تعيد ذلك اللون بعد زيادة عتامته بحسب القيمة الأخيرة. البنية العامة opacify($color, $amount) المعاملات ‎$color اللون المراد زيادة عتامته. ‎$amount قيمة عددية تتراوح بين 0 و 1 تمثِّل مقدار زيادة العتامة. القيم المعادة يعاد اللون ‎$color بعد زيادة عتامته بمقدار ‎$amount. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن كانت قيمة المعامل ‎$amount خارج المجال المسموح، أو كان أحد المعاملين من النوع الخطأ. أمثلة ...

يُعيد التابع to_a مصفوفة تتألف من 14 عنصرًا تحوي معلومات حول سلسلة التعليمات التي استدعي معها. البنية العامة to_a → ary‎ القيمة المعادة تعاد مصفوفة تتألف من 14 عنصرًا يمثلون سلسلة التعليمات بالبيانات التالية: magic سلسلة نصية تحدد تنسيق (format) البيانات. دائمًا تكون YARVInstructionSequence/SimpleDataFormat. major_version الإصدار الرئيسي لسلسلة التعليمات. minor_version الإصدار الثانوي لسلسلة التعليمات. format_type عدد يمثل تنسيق البيانات. تكون دائمًا 1. misc جدول Hash يحتوي على: ‎:arg_size: العدد الإجمالي للوسائط التي يأخذها التابع أو الكتلة (تساوي 0 إن لم تكن ...

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

تتحقَّق الدالة map_has_key()‎ إن كانت الخريطة (map) الممرَّرة إليها تحتوي على مفتاح معيّن وهذا المفتاح مرتبط بقيمة ما. البنية العامة map_has_key($map, $key) المعاملات ‎$map الخريطة المراد التحقٌّق من وجود قيمة مرتبطة بالمفتاح ‎$key فيها. ‎$key المفتاح الذي سيُبحث عنه في الخريطة ‎$map. القيم المعادة تُعاد القيمة TRUE إذا كان المفتاح موجودًا في الخريطة ‎$map ومرتبطًا بقيمة ما، أو القيمة FALSE خلا ذلك. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن لم يكن المعامل ‎$map خريطة. أمثلة مثال عن استخدام الدالة map_has_key()‎: map-has-key(("foo": 1, ...

(PHP 4, PHP 5, PHP 7) تتحقَّق الدالة is_link()‎ إن كان الملف وصلةً رمزيَّةً أم لا. الوصف bool is_link ( string $filename ) تتحقَّق هذه الدالة فيما إذا كان الملف filename هو وصلة رمزيَّة. المعاملات filename مسار الملف المراد التحقُّق منه. القيم المعادة تُعاد القيمة TRUE إن كان الملف filename موجودًا ونوعه هو وصلة رمزيَّة، أو تُعاد القيمة FALSE خلاف ذلك أو عند وجود خطأ. أمثلة المثال 1: التحقُّق إن كان الملف المُنشأ وصلةً رمزيَّة <?php $link = 'uploads'; if (is_link($link)) { ...

تحوّل الدالة to_upper_case()‎ جميع حروف السلسلة النصيَّة الممرَّرة إليها إلى حروف كبيرة (uppercase). البنية العامة to_upper_case($string) المعاملات ‎$string السلسلة النصّيَّة المراد تحويل جميع حروفها إلى حالة الحروف الكبيرة. القيم المعادة تُعاد السلسلة النصيَّة ‎$string بعد تحويل جميع حروفها إلى حروف كبيرة. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن لم تكن ‎$string سلسلة نصيَّة. أمثلة مثال نموذجي عن استخدام الدالة to_upper_case()‎: to_upper_case(abcd); // ABCD انظر أيضًا الدالة to_lower_case()‎: تحوِّل جميع حروف السلسلة النصيَّة الممرَّرة إليها إلى حروف كبيرة. الدالة str_insert()‎: تضيف سلسلةً نصيةً ...

المهام الفرعية (Threads، وتدعى "الخيوط" أيضًا) هي الطريقة التي تنفذ بها روبي البرمجة المتزامنة (concurrent programming). البرامج التي تتطلب تنفيذ عدة مهام فرعية يمكنها استخدام الصنف Thread. على سبيل المثال، يمكننا إنشاء مهمة فرعية جديدة منفصلة عن المهمة الرئيسية باستخدام التابع new. thr = Thread.new { puts "Whats the big deal" }‎ ثم يمكننا إيقاف تنفيذ المهمة الفرعية الرئيسية مؤقتًا إلى حين إنتهاء المهمة الفرعية خاصتنا باستخدام التابع join: thr.join #=> "Whats the big deal"‎ في حال عدم استدعاء التابع join قبل ...

يُعيد التابع abort_on_exception حالة الشرط العام "المقاطعة عند حدوث استثناء؟" (abort on exception). القيمة الافتراضية هي false أي "لا". عند إعطائه القيمة true أي "نعم"، فستوقف أي مهمة فرعية عند حدوث استثناء، وسيُطلق ذلك الاستثناء مجددًا في المهمة الفرعية الرئيسية (main thread). يمكن أيضًا تحديده بواسطة الراية DEBUG$ أو خيار سطر الأوامر ‎-d. يوجد أيضًا تابع نسخة (instance method) لتعيين هذا الخيار في مهمة فرعية معينة، راجع صفحة abort_on_exception لمزيد من المعلومات. البنية العامة abort_on_exception→ true or false‎ القيمة المعادة تعاد ...

مقدمة سنُغطّي في هذا القسم آلية استنتاج الأنواع في TypeScript، خاصّةً أين وكيف تُستنتَج الأنواع. الأساسيات هناك العديد من الأماكن في TypeScript التي يُستعمَل فيها استنتاج الأنواع لتوفير معلومات النوع عندما لا تكون هناك حاشية نوع (type annotation) صريحة. على سبيل المثال، في الشيفرة التالية let x = 3; سيُستَنتَجُ نوع المتغيّر ‎x‎ على أنّه النوعُ ‎number‎. استنتاج الأنواع هذا يكون عند تهيئة (initializing) المتغيرات والعناصر، أو عند ضبط قيم افتراضيّة للمعاملات، أو عند تحديد النوع المُعادِ لدالةٍ ما. يكون ...

يُمثِّل العنصر <img> صورةً في المستند. مثال عن استخدام العنصر <img> لعرض صورة مع تحديد نص بديل لها (عبر الخاصية alt): <img src="wiki-logo.png" alt="Wiki Hsoub Logo"> مثال عن استخدام العنصر <img> لعرض صورة مع تحديد نص بديل لها (عبر الخاصية alt) داخل العنصر مما يسمح بالنقر على الصورة للانتقال: <a href="wiki.hsoub.com"><img src="wiki-logo.png" alt="Wiki Hsoub Logo"></a> بطاقة العنصر تصنيفات المحتوى عنصر تنظيمي أو عنصر عادي أو عنصر يحتوي وسائط مضمّنة أو عنصر تفاعلي. المحتوى المسموح لا يوجد، فهذا العنصر فارغ. الوسم المختصر ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة filemtime()‎ وقت آخر تعديل أُجري على الملف. الوصف int filemtime ( string $filename ) تعيد هذه الدالة وقت آخر مرَّةٍ أُضيفت فيها بيانات إلى الملف filename أي وقت آخر تعديل أُجري على محتوى ذاك الملف. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. القيم المعادة يُعاد وقت آخر تعديل طُبِّقَ على محتوى الملف filename أو القيمة FALSE عند حصول أي خطأ. الوقت الذي يُعاد يكون على شكل بصمة وقت (Unix timestamp) وهو مناسب ...

(PHP 4, PHP 5, PHP 7) تنشئ الدالة mkdir()‎ مجلَّدًا جديدًا. الوصف bool mkdir ( string $pathname [, int $mode = 0777 [, bool $recursive = FALSE [, resource $context ]]] ) تحاول هذه الدالة إنشاء مجلَّد جديد في المسار pathname المُعطى. المعاملات pathname مسار المجلَّد المُراد إنشاؤه. mode أذونات المجلَّد الجديد، وقيمة هذا المعامل الإفتراضيَّة هي 0777 أي أوسع مجال لأذونات الوصول للمجلَّد. للمزيد من المعلومات حول الأذونات، راجع صفحة الدالة chmod()‎. ملاحظة: يُتجاهل المعامل mode على منصات ويندوز. الجدير ...

تعيد الدالة map_values()‎ قائمة تحتوي على قيم الخريطة (map) الممرَّرة إليها فقط (دون المفاتيح). ملاحظة: قد تحتوي هذه القائمة على قيم مكرّرة إن كان لعدَّة مفاتيح القيمة نفسها. البنية العامة map_values($map) المعاملات ‎$map الخريطة المراد الحصول على قيمها فقط. القيم المعادة تُعاد قائمة تحتوي على قيم الخريطة ‎$map فقط، وتُفصل تلك القيم بفواصل (comma). الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن لم يكن المعامل ‎$map خريطة. أمثلة مثال عن استخدام الدالة map_values()‎: map-values(("foo": 1, "bar": 2)) // 1, 2 map-values(("foo": 1, "bar": 2, "baz": 1)) // 1, ...

تعيد الدالة ()invert عكس اللون الممرَّر إليها. أي تعكس قيم المركبات الحمراء والخضراء والزرقاء للون الممرَّر إليها دون المساس بقيمة الشفافيَّة (opacity). البنية العامة invert($color) invert($color, $weight: 100%) المعاملات ‎$color اللون المراد الحصول على معاكسه. ‎$weight الوزن النسبي للون المعكوس. القيم المعادة تُعاد قيمة اللون المعاكس للون ‎$color. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن لم يكن ‎$color لونًا أو لم يكن ‎$weight نسبة مئوية. أمثلة مثال عن استخدام الدالة ()invert لعكس لون النص color ولون الخلفية background-color مع استخدام للوزن النسبي ‎$weight: .original ...

تعيد الدالة ()opacity قيمة مكوِّن الشفافيَّة (opacity) للون الممرَّر إليها. قيمتها غالبًا تساوي 1 إلا في حال عدِّلت. البنية العامة opacity($color) المعاملات ‎$color اللون المراد معرفة قيمة مكوِّن الشفافيَّة فيه. القيم المعادة تُعاد قيمة مكوِّن الشفافيِّة (alpha) للون ‎$color، وتتراوح بين 0 و1. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن لم يكن ‎$color لونًا. أمثلة أمثلة نموذجية عن استخدام الدالة opacity()‎: opacity(red); // 1 opacity(rgba(255, 0, ...

تزيل الدالة unquote()‎ علامات الاقتباس من السلسلة النصيَّة الممرَّرة إليها. إن كانت تلك السلسلة غير مُقتبسة، فستُعيدها الدالة دون تغيير. البنية العامة unquote($string) المعاملات ‎$string  سلسلة نصّيَّة مقتبسة. القيم المعادة تُعاد السلسلة النصيَّة ‎$string بعد إزالة علامات الاقتباس منها. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن لم يكن المعامل ‎$string سلسةً نصّيةً. مثال مثال عن استخدام الدالة unquote()‎ لضبط قيمة اللون (color): .selector { color: unquote("red") // red } سيُصرّف المثال السابق إلى شيفرة CSS الآتية: .selector { color: red; } انظر أيضًا الدالة quote()‎: ...

تعيد الدالة unit()‎ الوحدة (أو الوحدات) المرتبطة بالعدد الممرَّر إليها. تُرتَّب الوحدات المعقَّدة بالترتيب الهجائي بحسب البسط والمقام. البنية العامة unit($number) المعاملات ‎$number العدد المراد إعادة وحدته. القيم المعادة تُعاد سلسلة نصيَّة غير مقتبسة تحتوي على وحدة العدد ‎$number. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إذا لم يكن المعامل ‎$number عددًا. أمثلة أمثلة نموذجية عن استخدام الدالة unit()‎: unit(100); // "" unit(100px); ...

تعيد الدالة map_get()‎ القيمة الموجودة في الخريطة (map) والمرتبطة بالمفتاح المُعطى. إن لم تحتوي الخريطة على ذلك المفتاح، فستعيد الدالة القيمة العدميَّة null. البنية العامة map_get($map, $key) المعاملات ‎$map الخريطة المراد جلب القيمة المرتبطة بالمفتاح ‎$key منها. ‎$key المفتاح المراد البحث عنه في الخريطة ‎$map. القيم المعادة تُعاد القيمة المرتبطة بالمفتاح ‎$key في الخريطة ‎$map، أو القيمة العدمية null إن لم تحتوي الخريطة على ذلك المفتاح. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن لم يكن المعامل ‎$map خريطة. أمثلة مثال عن ...

تجعل الدالة ()transparentize (تسمى أيضًا fade_out) اللون أكثر شفافيَّةً. يمرَّر إليها لونًا وعددًا بين 0 و 1 ثمَّ تعيد ذلك اللون بعد تخفيض عتامته (opacity) بحسب القيمة الأخيرة. البنية العامة transparentize($color, $amount) المعاملات ‎$color اللون المراد إنقاص عتامته. ‎$amount قيمة عددية تتراوح بين 0 و 1 تمثِّل مقدار إنقاص العتامة. القيم المعادة يعاد اللون ‎$color بعد تخفيض عتامته بمقدار ‎$amount. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن كانت قيمة المعامل ‎$amount خارج المجال المسموح، أو كان أحد المعاملين من النوع الخطأ. أمثلة مثال عن استخدام ...

تغيّر الدالة ()rgba قيمة شفافيَّة لون معيّن أو تُنشئ لونًا انطلاقا من تمرير قيمة المكوِّنات: الأحمر والأخضر والأزرق وقناة الشفافيَّة (alpha). البنية العامة rgba($red, $green, $blue,$alpha) rgba($color,$alpha) المعاملات ‎$red قيمة المكوِّن الأحمر في اللون، ويجب أن تتراوح بين 0 و 255 أو بين ‎ 0%‎و ‎100%. ‎$green قيمة المكوِّن الأخضر في اللون، ويجب أن تتراوح بين 0 و 255 أو بين ‎ 0%‎و ‎100%. ‎$blue قيمة المكوِّن الأزرق في اللون، ويجب أن تتراوح بين 0 و 255 أو بين ‎ 0%‎و ...

يًكرّر التابع each_child الكتلة المعطاة على جميع سلاسل التعليمات المنحدرة مباشرة من سلسلة التعليمات التي استُدعي معها. ترتيب التكرار يرتبط بطريقة التقديم (implementation) وبالإصدار المُستخدم، لذلك عليك ألا تعوّل على ترتيب معين. البنية العامة each_child{|child_iseq| ...} → iseq‎ القيمة المعادة تعاد سلسلة تعليمات الناتجة عن تنفيذ الكتلة على جميع سلاسل التعليمات المنحدرة مباشرة من سلسلة التعليمات المعطاة. انظر أيضًا التابع eval: يقيّم سلسلة التعليمات المعطاة ويُعيد النتيجة. مصادر قسم التابع each_child‎ في الصنف InstructionSequence‎ في توثيق روبي الرسمي.

يستدعى هذا التابع عند استخدام التابع datetime.astimezone()‎ بالطريقة الافتراضية. وعند استدعائه من هناك، يكون dt.tzinfo هو الكائن نفسه self، ويُنظر إلى بيانات التاريخ والوقت في الكائن dt على أنّها تعرض الوقت حسب التوقيت العالمي المنسّق. البنية العامة ‎tzinfo.fromutc(dt) الهدف من التابع formutc()‎ هو تعديل بيانات الوقت والتاريخ وإعادة كائن datetime مكافئ حسب التوقيت المحليّ للكائن نفسه self. يجب على الأصناف الفرعية من tzinfo أن تكون قادرةً على وراثة طريقة الاستخدام الافتراضية للتابع fromutc()‎ دون أي مشاكل، وذلك لأنّ هذا التابع ...

تُضمَّن الوحدة Kernel من طرف الصنف Object، لذلك فتوابعها متاحة في كل كائنات روبي. توابع نسخ الصنف Kernel مُوثّقة في صفحة الصنف Object، أما توابع الوحدة Kernel فهي مُوثقة هنا. تستدعى هذه التوابع بدون مستقبل (receiver)، وبالتالي يمكن استدعاؤها وفق الشكل الدالي: sprintf "%.1f", 1.234 #=> "1.2" توابع الصنف العامة (Public Class Methods) Array يعيد المعامل الممرَّر إليه على شكل مصفوفة (Array). Complex يعيد ناتج التعبير x + i * y؛ حيث i هو الوحدة التخيلية للعدد العقدي. Float Hash يعيد ناتج التعبير x + ...

تنشئ هذه الدالة البانية لكائنات weakref إشارة ضعيفة إلى الكائن المعطى. البنية العامة weakref.ref(object[, callback]) المعاملات object الكائن المراد إنشاء إشارة ضعيفة إليه. callback في حال توفّر قيمة للمعامل callback ولم يأخذ القيمة None وكان كائن weakref المعاد حيًّا، فسيُستدعى callback عندما يوشك الكائن على أن يُنهى، وسيمرّر كائن الإشارة الضعيفة كمعامل وحيد للاستدعاء الخلفي، ولن يكون الكائن المشار إليه متاحًا بعد ذلك. يمكن إنشاء إشارات ضعيفة متعددة للكائن الواحد، وتُستدعى الاستدعاءات الخلفية المسجّلة لكل إشارة ضعيفة حسب ترتيب التسجيل، ...

يكتب التّابع Document.writeln‎()‎ سلسلةً نصيّةً متبوعةً بمحرف سطرٍ جديدٍ (newline character) على المستند. البنية العامة document.writeln(line); line سلسلة نصيّة تحتوي على سطر النّص المرغوب إضافته. مثال document.writeln("<p>أدخل كلمة المرور</p>"); ملاحظات التّابع Document.writeln‎()‎ مشابه للتّابع Document.write‎()‎ لكنّه يُضيف سطرًا جديدًا. كما هو الحال مع التّابع Document.write‎()‎ فالتّابع Document.writeln‎()‎ لا يعمل كذلك في مستندات XHTML، وستحصل على خطأ NS_ERROR_DOM_NOT_SUPPORTED_ERR يفيد بأنّ العمليّة غير مدعومة في سطر أوامر الأخطاء. يحدث هذا عن محاولة فتح ملفّ محليّ ذو الامتداد ‎.‎xhtml أو أي مستندٍ مُقدَّمٍ ...

يسجّل هذا التابع كائن استدعاء خلفيٍّ، وينفّذ هذا الكائن في كل محاولة للوصول إلى عمود في جدول ضمن قاعدة البيانات. البنية العامة set_authorizer(authorizer_callback) ‎ المعاملات authorizer_callback كائن استدعاء خلفي يُنفّذ في كل محاولة للوصول إلى أعمدة الجداول في قاعدة البيانات. يجب أن يعيد الاستدعاء الخلفية النتيجة SQLITE_OK إن كان الوصول مسموحًا به، والنتيجة SQLITE_DENY إن كان المطلوب تجاهل جملة SQL بأكملها مع إطلاق خطأ، والنتيجة SQLITE_IGONRE إن كن المطلوب التعامل مع العمود على أنّه يحمل القيمة NULL. هذه الثوابت متاحة ...

(PHP 4 >= 4.2.0, PHP 5, PHP 7) تغير الدالة array_change_key_case()‎ حالة الأحرف اللاتينية لكل المفاتيح الموجودة بالمصفوفة. الوصف تعيد هذه الدالة مصفوفة تحتوي علي كل مفاتيح المصفوفة التي تم تمريرها كمعامل للدالة بعد تحويل حالة أحرفها اللاتينية إلى كبيرة أو صغيرة. لاحظ أنَّ المفاتيح العددية ستبقى كما هي دون تعديل.  المعاملات array المصفوفة التي ستعمل عليها الدالة. case حالة الأحرف اللاتينية. إما كبيرة CASE_UPPER أو صغيرة CASE_LOWER (الحالة الافتراضية).  القيم المعادة تعيد هذه الدالة مصفوفةً تحتوي على مفاتيحٍ قد ...

(PHP 4, PHP 5, PHP 7) تزيل الدالة array_pop()‎ العنصر الأخير في نهاية المصفوفة وتُعيد قيمته. الوصف mixed array_pop ( array &$array ) تدفع دالة array_pop()‎ العنصر الأخير من المصفوفة array وتُعيد قيمته، وتقلل من طول المصفوفة array بمقدار عنصر واحد. ملاحظة: تعيد هذه الدالة ضبط مؤشر المصفوفة بعد استعمالها باستخدام الدالة reset()‎. المعاملات array المصفوفة المراد الحصول على قيمة العنصر منها. القيم المعادة تُعيد قيمة العنصر الأخير من المصفوفة array. إذا كانت المصفوفة array فارغة (أو ليست مصفوفة)، فستعيد الدالةُ ...

(PHP 4, PHP 5, PHP 7) تتحقَّق الدالة is_file()‎ إن كان الملف ملفًّا عاديًّا. الوصف bool is_file ( string $filename ) تتحقَّق هذه الدالة فيما إذا كان الملف filename ملفًّا عاديًّا. المعاملات filename مسار الملف المراد التحقُّق منه. القيم المعادة تُعاد القيمة TRUE إن كان الملف filename موجودًا وهو ملفٌّ عاديٌّ، أو القيمة FALSE خلاف ذلك أو عند وجود خطأ. ملاحظة: لمَّا كان نوع الأعداد الصحيحة في PHP هو ذات إشارة (signed) وأغلب المنصات تستعمل الأعداد الصحيحة بطول 32 بت، فقد ...

(PHP 4, PHP 5, PHP 7) تزيل الدالة array_pop()‎ العنصر الأخير في نهاية المصفوفة وتُعيد قيمته. الوصف mixed array_pop ( array &$array ) تدفع دالة array_pop()‎ العنصر الأخير من المصفوفة array وتُعيد قيمته، وتقلل من طول المصفوفة array بمقدار عنصر واحد. ملاحظة: تعيد هذه الدالة ضبط مؤشر المصفوفة بعد استعمالها باستخدام الدالة reset()‎. المعاملات array المصفوفة المراد الحصول على قيمة العنصر منها. القيم المعادة تُعيد قيمة العنصر الأخير من المصفوفة array. إذا كانت المصفوفة array فارغة (أو ليست مصفوفة)، فستعيد الدالةُ ...

(PHP 4 >= 4.2.0, PHP 5, PHP 7) تغير الدالة array_change_key_case()‎ حالة الأحرف اللاتينية لكل المفاتيح الموجودة بالمصفوفة. الوصف تعيد هذه الدالة مصفوفة تحتوي علي كل مفاتيح المصفوفة التي تم تمريرها كمعامل للدالة بعد تحويل حالة أحرفها اللاتينية إلى كبيرة أو صغيرة. لاحظ أنَّ المفاتيح العددية ستبقى كما هي دون تعديل.  المعاملات array المصفوفة التي ستعمل عليها الدالة. case حالة الأحرف اللاتينية. إما كبيرة CASE_UPPER أو صغيرة CASE_LOWER (الحالة الافتراضية).  القيم المعادة تعيد هذه الدالة مصفوفةً تحتوي على مفاتيحٍ قد ...

يُعيد التابع path مسار سلسلة التعليمات التي استُدعي معها، أو يعيد <compiled> إذا تم تقييم سلسلة التعليمات انطلاقًا من سلسلة نصية. البنية العامة path() القيمة المعادة يعاد مسار سلسلة التعليمات المعطاة، أو يعاد <compiled> إذا تم تقييم سلسلة التعليمات انطلاقًا من سلسلة نصية. أمثلة مثال على استخدام التابع path‎ مع irb: iseq = RubyVM::InstructionSequence.compile('num = 1 + 2') #=> <RubyVM::InstructionSequence:<compiled>@<compiled>> iseq.path #=> "<compiled>"‎ مثال آخر على استخدام التابع path‎ مع compile_file: # /tmp/method.rb def hello puts "hello, world" end # in irb > iseq = RubyVM::InstructionSequence.compile_file('/tmp/method.rb') > iseq.path ...

تُعيد الخاصية document.head العنصر <head> الخاصّ بالمُستند الحالي. إن كان للمُستند أكثر من عنصر <head> واحد، فالقيمة المُعادة ستُمثّل العنصر الأول. البنية العامة var objRef = document.head; مثال // نضع ما يلي // في ملفّ // HTML // <head id="my-document-head"> var aHead = document.head; alert(aHead.id); // "my-document-head"; alert( document.head === document.querySelector("head") ); // true ملاحظات الخاصيّة document.head للقِراءة فقط. مُحاولة ضبط قيمة لها سيفشَل دون أي أخطاء، أو سيرمي خطأ TypeError في مُتصفّح Firefox في حالة كان المستند في نمط strict. دعم المتصفحات الميزة Chrome Edge ...

تُدرج الدالة str_insert()‎ سلسلةً نصيةً داخل أخرى عند موضع محدَّد. لاحظ أن رقم ترتيب العنصر الأول في Sass هو 1، والعنصر الثاني هو 2، وهكذا على عكس بعض اللغات. البنية العامة str_insert($string, $insert, $index) المعاملات ‎$string السلسلة النصّيَّة التي سيضاف إليها سلسلة نصيَّة أخرى. ‎$insert السلسلة النصّية المراد إضافتها. ‎$index الموضع الذي ستُدرج فيه السلسلة ‎$insert ضمن السلسلة ‎$string. إن كانت قيمة هذا المعامل سالبة، فسيحسب موضع إضافة السلسلة النصيَّة $insert بدءًا من نهاية السلسلة ‎‎$string. إن كانت القيمة المعطاة تشير إلى موضع خارج حدود ...

تمزج الدالة mix()‎ بين لونين إذ تأخذ تحديدًا متوسط كلِّ مكوِّن من مكونات RGB لكلا اللونين لتعطي اللون الناتج، ويمكن اختياريًّا تحديد نسبة المزج. تؤخذ شفافيَّة اللون بالحسبان عند تعديل ومزج المكونات بحسب نسبتها. يحدِّد المعامل ‎$weight الكمية التي ستمزج من اللون الأول مع اللون الثاني. القيمة الافتراضيًة لذاك المعامل هي ‎50%‎، أي يكون اللون الناتج حاصل مزج نصف اللون الأول مع نصف اللون الثاني. أمَّا إن كانت قيمته ‎25%‎ فتعني أنَّه يجب مزج ربع (‎25%‎) اللون الأول مع ثلاثة ...

تعيد الدالة str_slice()‎ جزءًا من السلسلة النصيَّة الممرَّرة إليها والذي يبدأ وينتهي عند موضع محدَّد. لاحظ أن رقم ترتيب العنصر الأول في Sass هو 1، والعنصر الثاني هو 2، وهكذا على عكس بعض اللغات. البنية العامة str_slice($string, $start-at, $end-at: -1) المعاملات ‎$string  السلسلة النصّيَّة المراد استخراج سلسلة نصيَّة فرعيَّة منها. ‎$start-at موضع الحرف الأول من السلسلة النصيَّة الفرعيَّة المراد الحصول عليها. إذا كانت قيمة هذا المعامل سالبة، فسيحسب موضع بداية تلك السلسلة بدءًا من نهاية السلسلة النصيَّة ‎‎$string. ‎$end-at موضع الحرف الأخير من السلسلة ...

تقدّم هذه الوحدة أصناف معالجة أساسية لاستخدام مخدّمات وبوابات WSGI. تعالج هذه الأصناف الجزء الأكبر من عملية التواصل مع تطبيق WSGI ما دامت في بيئة مشابهة لبيئة CGI وإلى جانب تدفّقات المدخلات والمخرجات والأخطاء. الصنف wsgiref.handlers.CGIHandler يمكن الاستفادة من هذا الصنف عند الحاجة إلى تشغيل تطبيق WSGI كشيفرة CGI، حيث يمكن ببساطة تنفيذ التعبير CGIHandler().run(app)‎، إذ يمثل المعامل app كائن تطبيق WSGI الذي ترغب في تنفيذه. الصنف wsgiref.handlers.IISCGIHandler هذا الصنف هو بديل خاص للصنف CGIHandler، ويستخدم لنشر التطبيقات على مخدّم ...

الأعداد العشرية (ذات الفاصلة العائمة floating point) هي الأعداد التي تتضمن فاصلة عشرية أو علامة أسية: >>> x = 2.5 >>> y = -1.609 >>> z = 3e4 >>> print(z) 30000.0 >>> a = 10. >>> b = .001 >>> c = 0e0 >>> print(a, b, c) 10.0 0.001 0.0 يمكن الحصول على معلومات حول دقّة الأعداد العشرية والتمثيل الداخلي لها في الحاسوب الذي يعمل عليه البرنامج عن طريق مكتبة sys.float_info: >>> import sys >>> sys.float_info sys.float_info(max=1.7976931348623157e+308, max_exp=1024, max_10_exp=308, min=2.2250738585072014e-308, min_exp=-1021, min_10_exp=-307, dig=15, mant_dig=53, epsilon=2.220446049250313e-16, radix=2, rounds=1) التحويل إلى الأعداد العشرية ...

الأعداد العشرية (ذات الفاصلة العائمة floating point) هي الأعداد التي تتضمن فاصلة عشرية أو علامة أسية: >>> x = 2.5 >>> y = -1.609 >>> z = 3e4 >>> print(z) 30000.0 >>> a = 10. >>> b = .001 >>> c = 0e0 >>> print(a, b, c) 10.0 0.001 0.0 يمكن الحصول على معلومات حول دقّة الأعداد العشرية والتمثيل الداخلي لها في الحاسوب الذي يعمل عليه البرنامج عن طريق مكتبة sys.float_info: >>> import sys >>> sys.float_info sys.float_info(max=1.7976931348623157e+308, max_exp=1024, max_10_exp=308, min=2.2250738585072014e-308, min_exp=-1021, min_10_exp=-307, dig=15, mant_dig=53, epsilon=2.220446049250313e-16, radix=2, rounds=1) التحويل إلى الأعداد العشرية ...

التصريح بالتفكيك قد تحتاج في بعض الأحيان لتفكيك الكائن (object) إلى عددٍ من المتغيِّرات، مثل: val (name, age) = person تٌسمَّى الصيغة السابقة بالتصريح بالتفكيك والذي يُنشِئ أكثر من متغيِّر بنفس الوقت (وهما المتغيِّرانname و age) حيث يُسمح باستخدامهما بشكلٍ مستقلٍ تمامًا كما في الشيفرة الآتية: println(name) println(age) إذ يُترجَم التصريح بالتفكيك كما يلي: val name = person.component1() val age = person.component2() حيث تُعدُّ الدالتان component1()‎ و component2()‎ مثالًا عن الاصطلاحات الأساسيّة المُستخدَمة في لغة Kotlin (راجع المُعامِلات مثل + و * وحلقات for و... ...

تعريف الحزم (Package) يُكتب توصيف الحزمة (package) في بداية الملف المصدريّ (source file) بالشكل الآتي: package my.demo import java.util.* // ... ولا يُشترط التوافق ما بين الحزمة (package) والمجلد الذي توجد فيه (directory)، إذ من الممكن أن تتوضع الملفات المصدريّة عشوائيًّا في نظام الملفات. المزيد عن الحزم (packages). تعريف الدوال (Function) إن كانت الدالة بمتحولين من نوع Int وتعيد قيمةً بنوع Int أيضًا، فسيصبح تعريفها بالشكل: fun sum(a: Int, b: Int): Int {   return a + b } أما الشيفرة الآتية فهي لتعريف دالةٍ باسم sum ...

(PHP 4, PHP 5, PHP 7) تتحقَّق الدالة is_writable()‎ إن كان الملف قابلًا للكتابة أو لا. الوصف bool is_writable ( string $filename ) تتحقَّق هذه الدالة فيما إذا كان الملف filename موجودًا وقابلًا للكتابة. تسمح الدالة بأن تكون قيمة المعامل filename اسم مجلَّد للتأكُّد من أنَّ هذا المجلَّد قابلٌ للكتابة. تذكَّر دومًا أنَّ PHP قد تصل إلى الملف باستعمال مُعرِّف المستخدم (UID) إلا أنَّ خادم الويب يعمل على أنَّه "nobody" غالبًا. على أي حال، لا تؤخذ قيود الوضع الآمن بالحسبان قبل ...

تحذف الدّالة delattr()‎ الخاصيّة المُعطاة من الكائن (إن سمَح الكائن بحذف الخاصيّة). البنية العامة delattr(object, name) المعاملات object الكائن المرغوب حذف خاصيّةٍ من خاصيّاته. name سلسلة نصيّة تُمثّل اسم الخاصيّة المرغوب حذفها. القيمة المعادة القيمة None كبقيّة الدّوال التي لا تُعيد أي قيمة صراحةً في بايثون. أمثلة المثال التّالي يوضّح كيفيّة عمل هذه الدّالة، لاحظ أنّها مُشابهة للكلمة المفتاحيّة del التي تحذف الكائنات: >>> class A: ... def __init__(self, a=1, b=2): ... ...

التعبير البرمجي debugger يؤدي إلى تفعيل وظيفة التنقيح (debugging functionality) المتاحة، مثل بداية نقطة المقاطعة (breakpoint)؛ لكن إن لم يكن هنالك منقِّح أو وظيفة تنقيح متاحة فلن يكون لهذا التعبير أي أثر. البنية العامة debugger; أمثلة الشيفرة الآتية فيها التعبير البرمجي debugger الذي يؤدي إلى استدعاء المنقِّح (إن كان موجودًا) عند تنفيذ الدالة function potentiallyBuggyCode() { debugger; // شيفرة غير مستقرة فيها علل يجب تنقيحها } دعم المتصفحات الميزة Chrome Firefox Internet Explorer Opera Safari ...

يُعيد التابع absolute_path المسار المطلق لسلسلة التعليمات المعطاة، أو يعيد القيمة nil إذا تم تقييم سلسلة التعليمات التي استُدعي معها انطلاقًا من سلسلة نصية. البنية العامة absolute_path() القيمة المُعادة يُعيد التابع absolute_path المسار المطلق لسلسلة التعليمات. أمثلة مثال على استعمال التابع absolute_path مع استخدام التابع compile_file: # /tmp/method.rb def hello puts "hello, world" end # in irb > iseq = RubyVM::InstructionSequence.compile_file('/tmp/method.rb') > iseq.absolute_path #=> /tmp/method.rb‎ انظر أيضًا التابع of: يُعيد سلسلة التعليمات التي تحوي الكائن Proc أو Method المعطى. التابع base_label: يُعيد التسمية الأساسية (base label) لسلسلة التعليمات ...

تستدعي الدالة apply()‎ بُنية (block) الدالة المُحدَّدة وذلك بجعل قيمة this كمستقبِلٍ (receiver) لها وتُعيد قيمة this. البنية العامة inline fun <T> T.apply(block: T.() -> Unit): T يُلاحَظ وجود الكلمة المفتاحية inline للدلالة على أن هذه الدالة مباشرة، وللمزيد من التفاصيل راجع توثيق الدوال المباشرة (inline functions). المعاملات block الكتلة البرمجية المراد استدعاؤها وتنفيذها. القيم المعادة يعاد الكائن المعطى بعد تعديله. أمثلة تستدعي الشيفرة الآتية الدالة apply()‎ عبر الكائن person المُنشَأ من الصنف Person الذي يحتوي على بيانات أوليّة لكلٍ من ...

يُحدِّد العنصر <link> العلاقات بين المستند الحالي وبين مورد خارجي (external resource)؛ من استخدامات هذا الوسم تتضمن تعريف علاقة بين الصفحات للتنقل بينها، بيد أنَّ أكثر استخدامات هذا العنصر شيوعًا هو تضمين صفحات الأنماط. استخدام الشكل الآتي للعنصر <link> لتضمين صفحة أنماط في المستند: <link href="style.css" rel="stylesheet"> بطاقة العنصر تصنيفات المحتوى البيانات الوصفية المحتوى المسموح لا يوجد، فهذا العنصر فارغ. الوسم المختصر لمّا كان هذا العنصر فارغًا، فيجب توفير وسم البداية وحذف وسم النهاية. العناصر الأب أي عنصر يقبل وجود ...

تمثّل الأرقام العشرية ذات الفاصلة العائمة float في الحاسوب باستخدام كسور النظام الثنائي binary (الأساس 2)، فعلى سبيل المثال، الكسر العشري 0.125 يمتلك القيمة 1/10 + 2/100 + 5/1000، وبنفس الطريقة يمتلك الكسر الثنائي 0.001 القيمة 0/2 + 0/4 + 1/8. يمتلك هذا الكسران القيمة ذاتها، ولكن الفرق الوحيد بينهما هو أنّ الأول مكتوب بواسطة التمثيل الكسري ذي الأساس 10، أما الثاني فممثل بالأساس 2. ولكن لا يمكن تمثيل معظم الكسور العشرية ككسور ثنائية مضبوطة، ونتيجة لذلك، فإنّ الأعداد العشرية ...

تمثّل الأرقام العشرية ذات الفاصلة العائمة float في الحاسوب باستخدام كسور النظام الثنائي binary (الأساس 2)، فعلى سبيل المثال، الكسر العشري 0.125 يمتلك القيمة 1/10 + 2/100 + 5/1000، وبنفس الطريقة يمتلك الكسر الثنائي 0.001 القيمة 0/2 + 0/4 + 1/8. يمتلك هذا الكسران القيمة ذاتها، ولكن الفرق الوحيد بينهما هو أنّ الأول مكتوب بواسطة التمثيل الكسري ذي الأساس 10، أما الثاني فممثل بالأساس 2. ولكن لا يمكن تمثيل معظم الكسور العشرية ككسور ثنائية مضبوطة، ونتيجة لذلك، فإنّ الأعداد العشرية ...

ناقشنا بعض خيارات صدفة Bash التي قد تفيدك في تنقيح برامج Bash، وسننظر الآن في مزيد من تلك الخيارات بتفصيل أكثر. عرض الخيارات استخدم خيار o- لأمر set لعرض كل خيارات الصدفة: hsoub:~> set -o allexport off braceexpand on emacs ...

يقيّم (Evaluates) التابع eval سلسلة التعليمات المعطاة ويُعيد النتيجة. البنية العامة eval → obj‎ القيمة المعادة يعاد ناتج تقييم سلسلة التعليمات المعطاة. أمثلة مثال على استخدام التابع eval‎: RubyVM::InstructionSequence.compile("1 + 2").eval #=> 3‎ انظر أيضًا التابع each_child: يًكرّر تنفيذ الكتلة المعطاة على جميع سلاسل التعليمات المنحدرة مباشرة من سلسلة التعليمات التي استُدعي معها. مصادر قسم التابع eval‎ في الصنف InstructionSequence‎ في توثيق روبي الرسمي.

(PHP 4 >= 4.3.0, PHP 5, PHP 7) تبحث الدالة glob()‎ عن مسارات محدَّدة لملفات أو مجلَّدات والتي تتطابق مع نمط مُعطى. الوصف array glob ( string $pattern [, int $flags = 0 ] ) تبحث هذه الدالة عن جميع المسارات التي تُطابق النمط pattern وفقًا للقواعد التي تستخدمها المكتبة libc للدالة glob()‎، والتي تشبه نظيرتها المستخدمة من قبل أشهر الصدفات (shells). المعاملات pattern التعبير النمطي المُعطى. الرمز ~ (المَدَّة [tilde]) غير مدعوم، كما أنَّه لا يُجرى أي عملية استبدال للمعاملات. ...

يحول التابع inspect سلسلة التعليمات التي استُدعي معها إلى سلسلة نصية قابلة للقراءة تتضمن أيضًا الاسم والمسار. البنية العامة inspect() القيمة المعادة تعاد سلسلة نصية قابلة للقراءة لسلسلة التعليمات المعطاة، التي تتضمن أيضًا الاسم والمسار. انظر أيضًا التابع first_lineno: يعيد رقم أول سطر في المصدر حيث تم تحميل تسلسل التعليمات الحالي. التابع label: يُعيد تسمية (label) سلسلة التعليمات. مصادر قسم التابع inspect‎ في الصنف InstructionSequence‎ في توثيق روبي الرسمي.

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

المعامل typeof يُعيد سلسلةً نصية تُشير إلى نوع القيمة التي تليه. البنية العامة typeof operand operand تعبير يُمثِّل كائنًا أو نوع بيانات أوليّ الذي نريد إعادة نوعه. الوصف الجدول الآتي يُلخِّص القيم التي يمكن أن يُعيدها المعامل typeof: النوع النتيجة undefined "undefined" null "object" (انظر الأمثلة) Boolean "boolean" Number "number" String "string" Symbol (جديد في ECMAScript 2015) "symbol" Function "function" أي كائن آخر "object" أمثلة // الأعداد typeof 37 === 'number'; typeof 3.14 === 'number'; typeof(42) === 'number'; typeof Math.LN2 === 'number'; typeof Infinity === ...

تعيد الدالة abs()‎ القيمة المطلقة لعددٍ مُمرِّرٍ إليها. البنية العامة abs($number)‎ المعاملات ‎$number العدد المراد إعادة القيمة المطلقة له. القيم المعادة يُعاد عدد صحيح من النوع Number يُمثِّل القيمة المطلقة للمعامل ‎$number المُمرَّر إلى الدالة. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إذا لم يكن المعامل ‎$number عددًا. أمثلة مثال عن استخدام الدالة abs()‎ لضبط قيمة الحواشي (padding) والهوامش (margin) إلى 20px: .selector { padding: abs(-20px); // 20px margin: abs(20px); // 20px } سيُصرّف المثال السابق إلى شيفرة CSS الآتية: .selector ...

(PHP 4, PHP 5, PHP 7) تتحقَّق الدالة is_readable()‎ إن كان الملف قابلًا للقراءة. الوصف bool is_readable ( string $filename ) تتحقَّق هذه الدالة فيما إذا كان الملف filename موجودًا وقابلًا للقراءة. المعاملات filename مسار الملف المراد التحقُّق منه. القيم المعادة تُعاد القيمة TRUE إن كان الملف filename موجودًا وقابلًا للقراءة، أو تُعاد القيمة FALSE خلاف ذلك أو عند وجود خطأ. أمثلة المثال 1: استعمال الدالة is_readable()‎ <?php $filename = 'test.txt'; if (is_readable($filename)) { echo 'The file is readable'; } else ...

تعيد الدالة map_remove()‎ خريطة (map) جديدة بعد حذف مفاتيح معيّنة من الخريطة الممرَّرة إليها. تُعيد الدالة map_remove()‎ خريطة جديدة، مثل جميع دوال الخرائط، بدلًا من تعديل معاملاتها موضعيًا. البنية العامة map_remove($map, $keys...) المعاملات ‎$map الخريطة المراد حذف مفاتيح محدَّدة منها. ‎$keys المفاتيح المراد حذفها من الخريطة ‎$map. القيم المعادة تُعاد خريطة الخريطة ‎$map بعد حذف المفاتيح ‎$keys منها. الأخطاء والاستثناءات سيُرمى الخطأ ArgumentError إن لم يكن المعامل ‎$map خريطةً. أمثلة مثال عن استخدام الدالة map_remove()‎: map-remove(("foo": 1, "bar": 2), "bar") // ("foo": 1) map-remove(("foo": ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة lstat()‎ معلومات عن ملف أو وصلة رمزيَّة. الوصف array lstat ( string $filename ) تجمع هذه الدالة بعض المعلومات الإحصائيَّة عن الملف أو الوصلة الرمزيَّة التي يشير إليها المعامل filename. المعاملات filename مسار الملف أو الوصلة الرمزيَّة. القيم المعادة تُعاد مصفوفة تحتوي على معلومات إحصائيَّة عن الملف أو الوصلة الرمزيَّة. بنية تلك المصفوفة مشروحة بالتفصيل في توثيق الدالة stat()‎. هذه الدالة مطابقة تمامًا للدالة stat()‎ باستثناء أنَّه إن كان المعامل filename وصلة رمزيَّة، ...

تعيد الدالة ()set_nth قائمة جديدة، بناءً على القائمة المُمرَّرة، بعد تبديل القيمة المعطاة مكان قيمة العنصر ذي الترتيب ‎$n. لاحظ أن رقم ترتيب العنصر الأول في Sass هو 1، والعنصر الثاني هو 2، وهكذا على عكس بعض اللغات. البنية العامة set_nth($list, $n, $value) المعاملات ‎$list القائمة التي ستُنسخ والتي ستُغيّر قيمة العنصر ذي الترتيب ‎$n فيها. ‎$n رقم ترتيب العنصر المراد تغييره. إن كانت قيمة هذا المعامل سالبة، فسيحسب موضع العنصر بدءًا من نهاية القائمة. أي يبدأ العد بشكل عكسي انطلاقًا من آخر عنصر ...

(PHP 4, PHP 5, PHP 7) تُأَخِّرُ الدالةُ sleep()‎ تنفيذَ البرنامج. الوصف int sleep ( int $seconds ) تُأَخِّرُ الدالةُ sleep()‎ تنفيذ البرنامج لعدد محدد من الثواني. المعاملات seconds زمن الإيقاف بالثواني. القيم المعادة تعيد الدالة sleep()‎ القيمة 0 عند نجاح تنفيذها، أو القيمة FALSE عند حدوث خطأ. إذا قُطِعَتْ عملية الاستدعاء بواسطة إشارة، فستعيد الدالة sleep()‎ قيمةً غير صفرية. في نظام ويندوز، ستكون هذه القيمة دائمًا 192 (قيمة WAIT_IO_COMPLETION ثابتة داخل ويندوز API). في الأنظمة الأخرى، ستكون القيمةُ المعادة عددَ ...

(PHP 4, PHP 5, PHP 7) تتحقَّق الدالة is_dir()‎ إن كان مسار الملف أو المجلَّد المُمرَّر إليها مجلَّدًا أم لا. الوصف bool is_dir ( string $filename ) تتحقَّق هذه الدالة فيما إذا كان الملف filename هو مجلَّد. المعاملات filename مسار الملف المراد التحقُّق منه. إن كان المعامل filename مسارًا نسبيًّا، فسيُتحقَّق منه نسبةً إلى مجلَّد العمل الحالي. إن كان المعامل filename وصلةً رمزيَّة أو صلبة، فسيُستبين المسار الذي تُشير إليه تلك الوصلة حينئذٍ ويُتحقَّق منه. إن كان الوضع الآمن أو  الخيار ...

تغيّر الدالة ()change_color خاصِّيَّة واحدة أو أكثر من خاصِّيَّات اللون المعطى وهي: الأحمر والأخضر والأزرق والتشبُّع (saturation) والصبغة (hue) والشفافيَّة. تُحدَّد الخاصِّيَّات على شكل وسائط مُسمّاة، وتُعوَِّض القيم الممرَّرة مكان القيم الحاليَّة لتلك الخاصِّيَّات في اللون. جميع الخاصِّيَّات اختياريَّة. مع ذلك، لا يمكنك تغيير خاصِّيَّات RGB (أي الخاصِّيَّة ‎ $redو ‎$green و ‎$blue) و خاصّيَّات HSL (أي الخاصِّيَّة ‎$hue و ‎$saturation و ‎$lightness و ‎$alpha) في نفس الوقت. البنية العامة scale_color($color, [$red], [$green], [$blue], [$hue], [$saturation], [$lightness], [$alpha])‎ المعاملات ‎$color اللون المراد ...

يُسلسل (serialize) التابع to_binary سلسلة التعليمات التي استُدعي معها على هيئة سلسلة نصية ثنائية (binary). يتم إنشاء سلسلة تعليمات بعد تحويلها باستعمال هذا التابع بواسطة التابع load_from_binary. لاحظ أن البيانات الثنائية المترجمة ليست محمولة (portable). لا يمكنك نقل هذه البيانات الثنائية إلى جهاز آخر. كما لا يمكنك استخدام البيانات الثنائية التي تم إنشاؤها بواسطة إصدار آخر من روبي. البنية العامة to_binary(extra_data = nil) → binary str‎ المعاملات extra_data سيتم حفظ المعامل extra_data المعطى مع البيانات الثنائية. يمكنك الوصول إلى هذه البيانات ...

(PHP 4, PHP 5, PHP 7) تعيد الدالة filetype()‎ نوع الملف المحدَّد. الوصف string filetype ( string $filename ) تعيد هذه الدالة نوع الملف filename. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. القيم المعادة يُعاد نوع الملف filename. القيم المتوقَّعة لنوع الملف هي إمَّا أنبوبة مسماة (FIFO وتدعى أحيانًا named pipe) أو ملف محرفي خاص (char) أو مجلد (dir) أو ملف كتلي خاص (block) أو وصلة رمزية (link) أو ملف عادي (file) أو مقبس (socket) أو نوع غير معروف (unknown). ...

مقدمة عقود Laravel هي مجموعة من الواجهات (interfaces) التي تعرِّف الخدمات المركزية التي يوفرها إطار العمل. على سبيل المثال، يعرِّف العقد Illuminate\Contracts\Queue\Queue  الدوال اللازمة لصف الأعمال في الطوابير، بينما يعرِّف عقد Illuminate\Contracts\Mail \Mailer الدوال اللازمة لإرسال رسائل البريد الإلكتروني. لكل عقد تعريف استخدام (implementation) يوفره إطار العمل. على سبيل المثال، يوفِّر Laravel تعريف استخدام للطابور لعدة أنواع من المشغلات (drivers) كما يوفِّر تعريف استخدام للمُرسِل مشغل بواسطة SwiftMailer. توجد كل عقود Laravel في مستودعات في GitHub. هذا يوفر نقطة مرجعية سريعة لكل ...

يعيد التابع التاريخ الموافق للعدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد 1 موافقًا للتاريخ 1 كانون الثاني (يناير) سنة 1 ميلادية. البنية العامة date.fromordinal(ordinal) المعاملات ordinal العدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد 1 موافقًا للتاريخ 1 كانون الثاني (يناير) سنة 1 ميلادية. القيمة المعادة يعيد التابع التاريخ الموافق للعدد الترتيبي في التقويم التنبؤي الكريكوري. ن كانت قيمة المعامل ordinal المعطاة تقع خارج النطاق ‎1 <= ordinal <= date.max.toordinal()‎ فإنّ اللغة تطلق الخطأ ValueError. لو فرضنا ...

يعيد التابع كائن datetime الذي يتضمن التاريخ والوقت الموافقين للعدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد 1 موافقًا للتاريخ 1 كانون الثاني (يناير) سنة 1 ميلادية. البنية العامة datetime.fromordinal(ordinal) المعاملات ordinal العدد الترتيبي في التقويم التنبؤي الكريكوري، حيث يكون العدد 1 موافقًا للتاريخ 1 كانون الثاني (يناير) سنة 1 ميلادية. القيمة المعادة يعيد التابع التاريخ والوقت الموافقين للعدد الترتيبي في التقويم التنبؤي الكريكوري. ن كانت قيمة المعامل ordinal المعطاة تقع خارج النطاق ‎1 <= ordinal <= date.max.toordinal()‎ فإنّ ...

(PHP 4, PHP 5, PHP 7) تجلب الدالة filectime()‎ آخر وقت جرى فيه تعديل مؤشِّر الفهرسة (inode) لملف محدَّد. الوصف int filectime ( string $filename ) تعيد هذه الدالة آخر وقت جرى فيه تعديل مؤشر الفهرسة (inode) للملف filename. المعاملات filename مسار الملف الذي ستُجرى عليه العمليَّة. القيم المعادة يُعاد وقت آخر تعديل جرى على الملف filename أو تُعاد القيمة FALSE عند فشل العمليَّة. الوقت الذي يُعاد يكون على شكل بصمة وقت (Unix timestamp). أمثلة المثال 1: استعمال الدالة filectime()‎ <?php $filename ...

الدالة encodeURIComponent()‎ تُرمِّز مكوِّن من مكونات روابط URI (اختصار للعبارة Uniform Resource Identifier) بتبديل كل نسخة من محارف معيّنة بعبارة مُهرَّبة (escape sequences) أو أكثر والتي تُمثِّل ترميز UTF-8 للمحرف المعني. البنية العامة encodeURIComponent(str); str سلسلة نصية تُمثِّل مكوِّنًا من مكوِّنات رابط URI. القيمة المعادة سلسلة نصية تُمثِّل النسخة المُرمَّزة من مكوِّن رابط URI. الوصف الدالة encodeURIComponent تُهرِّب (escape) جميع المحارف ما عدا: A-Z a-z 0-9 - _ . ! ~ * ' ( ) تختلف الدالة encodeURIComponent عن الدالة encodeURI ...

تزيد الدالة adjust_color()‎ أو تقلِّل خاصِّيَّة واحدة أو أكثر من خاصِّيَّات لون محدَّد. يمكنها أن تُغيّر شفافيَّة وتشبّع وقيمة اللون الأحمر والأخضر والأزرق. تُحدّد الخاصِّيَّات على شكل وسائط مُسمّاة لتُضاف أو تُنقص من القيمة الحاليَّة لخاصِّيَّة اللون تلك. جميع الخاصِّيّات اختياريِّة. على أي حال، لا يمكنك تحديد كلّ من خاصِّيَّات RGB‏ (‎$red و ‎$green و ‎$blue) وخاصِّيَّات HSL ‏(‎$hue و ‎$saturation و ‎$lightness و ‎$alpha) في نفس الوقت. البنية العامة adjust_color($color, [$red], [$green], [$blue], [$hue], [$saturation], [$lightness], [$alpha])‎ المعاملات ‎$color ...

يُعيد التابع label تسمية (label) سلسلة التعليمات التي استُدعي معها، أو يعيد <main> إن كان التسلسل في المستوى الأعلى (top level)، أو يعيد <compiled> إذا تم تقييمها من سلسلة نصية. البنية العامة label() القيمة المعادة تعاد تسمية (label) سلسلة التعليمات المعطاة، أو يعاد <main> إن كان التسلسل في المستوى الأعلى (at the top level)، أو يعاد <compiled> إذا تم تقييمها من سلسلة نصية. أمثلة مثال على استخدام التابع label‎ مع irb: iseq = RubyVM::InstructionSequence.compile('num = 1 + 2') #=> <RubyVM::InstructionSequence:<compiled>@<compiled>> iseq.label #=> "<compiled>"‎ مثال آخر ...

تدمج الدالة map_merge()‎ خريطتين (maps) في خريطة واحدة جديدة. المفاتيح في الخريطة الثانية ‎$map2 ستكون لها الأسبقيَّة على المفاتيح في الخريطة الأولى ‎$map1. هذه هي أفضل طريقة لإضافة قيم جديدة إلى خريطة. جميع مفاتيح الخريطة الناتجة سيكون لها نفس الترتيب كما في الخريطة الأولى ‎$map1، وستوضع المفاتيح الجديدة للخريطة الثانية ‎$map2 في نهاية تلك الخريطة الناتجة. تُعيد الدالة map_merge()‎ خريطة جديدة، مثل جميع دوال الخرائط، بدلًا من تعديل معاملاتها موضعيًا. البنية العامة map_merge($map1, $map2) المعاملات ‎$map1 الخريطة الأولى. ‎$map2 الخريطة ...

تبدِّل الدالة selector_replace()‎ المعامل ‎$replacement مكان نُسخ (instances) المعامل ‎$original أينما وجدت في المحدِّد ‎$selector المعطى. تعمل الدالة عبر استخدام القاعدة ‎@extend واستبعاد المحدِّد الأصلي. هذا يعني أنّه يمكن استخدامها للأداء عمليات تبديل معقدة. البنية العامة selector_replace($selector, $original, $replacement) المعاملات ‎$selector المحدِّد الذي سيُبدَّل داخله المحدَّد ‎$original مع المحدِّد ‎$replacement. يمكن أن يكون عبارةً عن سلسلة نصيَّة أو قائمة من سلاسل نصيَّة أو قائمة من قوائم من سلاسل نصيَّة كما تُعاد باستعمال الرمز &. ‎$original المحدِّد المراد استبداله. يمكن أن ...

(PHP 4 >= 4.2.0, PHP 5, PHP 7) تقسم الدالة array_chunk()‎ المصفوفة إلى أجزاء صغيرة.  الوصف array array_chunk ( array $array , int $size [, bool $preserve_keys = FALSE ] ) تقسم هذه الدالة المصفوفة إلى مصفوفات أصغر كل منها يحتوي على عدد من العناصر يساوي قيمة المعامل ‎$size. قد تحتوي المصفوفة الصغيرة الأخيرة على عددٍ من العناصر أقل من قيمة المعامل ‎$size. المعاملات array المصفوفة التي ستعمل عليها الدالة. size حجم كل مصفوفة جزئية مقتطعة من المصفوفة الأصلية. preserve_keys ...

تعيد الدالة selector_extend()‎ نسخةً جديدةً من المحدِّد ‎$selector مع توسعة ‎$extendee بواسطة ‎$extender. النتيجة تشبه الكود البرمجي التالي: $selector { ... } $extender { @extend $extendee } البنية العامة selector_extend($selector, $extendee, $extender) المعاملات ‎$selector المحدِّد الذي سيُوسع داخله المحدِّد ‎$extendee بواسطة المعامل ‎$extender. يمكن أن يكون عبارةً عن سلسلة نصيَّة، أو قائمة من سلاسل نصيَّة، أو قائمة من قوائم من سلاسل نصيَّة مثلما تُعاد باستعمال الرمز &. ‎$extendee المحدِّد الذي سيُوسع. يمكن أن يكون عبارةً عن سلسلة نصية، أو قائمة من ...