PHP/range

(PHP 4, PHP 5, PHP 7)

تنشئ الدالة range()‎‎‎‎‎‎‎‎‎‎ مصفوفةً تحتوي على مجال من العناصر.

الوصف

array range ( mixed $start , mixed $end [, number $step = 1 ]

تنشئ هذه الدالة مصفوفةً تحتوي على مجال (range) من العناصر.

المعاملات

start

أول قيمة في المجال أو محرف البداية.

end

ينتهي المجال عند الوصول إلى القيمة end أو محرف النهاية.

step

إذا ضُبِطَت قيمةٌ للمعامل step، فستُستخدم كمقدار لزيادة العناصر في المجال. ويجب أن تكون قيمة step موجبة. وإذا لم تُحدد فتُفترض step على أنها تساوي القيمة 1.

القيم المعادة

تُعيد الدالة مصفوفة من العناصر من start إلى end شاملة القيمة end.

أمثلة

المثال 1: أمثلة على الدالة range()‎

<?php
// array(0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12)
foreach (range(0, 12) as $number) {
   echo $number;
}
// المعامل step
array()‎
foreach (range(0, 100, 10) as $number) {
   echo $number;
}
// استخدام مجال من الحروف
// array('a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i');
foreach (range('a', 'i') as $letter) {
   echo $letter;
}
// array('c', 'b', 'a');
foreach (range('c', 'a') as $letter) {
   echo $letter;
}
?>

ملاحظات

ملاحظة: عند استخدام مجالات للأحرف، فلا يُسمَح باستخدام أكثر من محرف قيمةً لبداية المجال أو نهايته، وفي حال تمرير سلسلة نصية كمعامل إلى الدالة range()‎ وكانت تحتوي على أكثر من محرف واحد، فلن يُستعمَل إلا أوّل محرف فيها فقط؛ فمثلًا ناتج الدالة range('c', 'a')‎ هو نفسه ناتج الدالة range('cm', 'aw')‎.

انظر أيضًا

• shuffle()‎: خلط عناصر المصفوفة.
• array_fill()‎‎: ملء مصفوفة بالقيم.
• حلقة foreach.

مصادر

• صفحة الدالة range في توثيق PHP الرسمي.