PHP/Function/array

(PHP 4, PHP 5, PHP 7)

تنشئ الدالة array()‎ مصفوفة جديدة.

الوصف

array array ([ mixed $... ] )

تنشئ هذه الدالة مصفوفة جديدة. للمزيد من المعلومات حول ماهية المصفوفة اقرأ عن النوع array.

المعاملات

...

يُعرَّف التركيب "الفهرس => القيم" كلًا من الفهرس والقيمة المقابلة وتفصل الفاصلة , بين تلك الأزواج. قد يكون الفهرس من نوع السلاسل النصية أو الأعداد الصحيحة. إذا حُذِفَ الفهرس فسيتولّد فهرس من نوع الأعداد الصحيحة تلقائيًا بدءًا من 0. وإذا كان الفهرس عددًا صحيحًا، فسيكون الفهرس التالي المتولد مساويًا لأكبر مؤشر عدد صحيح + 1. لاحظ أنه عند تعيين فهرسين متطابقَيْن، فإن الأخير يكتب فوق الأول.

يُعد وجود فاصلة زائدة بعد تعيين آخر عنصر في المصفوفة صيغة صحيحة، على الرغم أنه من غير المعتاد فعل ذلك.

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

تُعيد الدالة مصفوفة من المعاملات. يمكن إعطاء المعاملات فهرسًا بواسطة العامل ‎=>‎. للمزيد من المعلومات حول ماهية المصفوفة اقرأ عن النوع array.

أمثلة

يوضح المثال التالي كيفية إنشاء مصفوفة ثنائية الأبعاد، وكيفية تحديد مفاتيح مصفوفات الترابطية (associative arrays) وكيفية تخطي ومتابعة الفهارس الرقمية في المصفوفات العادية.

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

<?php
$fruits = array (
    "fruits"  => array("a" => "orange", "b" => "banana", "c" => "apple"),
    "numbers" => array(1, 2, 3, 4, 5, 6),
    "holes"   => array("first", 5 => "second", "third")
);
?>

المثال 2: فهرس تلقائي مع array()‎

<?php
$array = array(1, 1, 1, 1,  1, 8 => 1,  4 => 1, 19, 3 => 13);
print_r($array);
?>

سوف تكون مُخرجات المثال أعلاه كالتالي:

Array
(
    [0] => 1
    [1] => 1
    [2] => 1
    [3] => 13
    [4] => 1
    [8] => 1
    [9] => 19
)

لاحظ أن الفهرس "3" عُرِّف مرتين، واحتفظ بقيمته النهائية 13. عُرِّف الفهرس 4 بعد الفهرس 8، ولما كان أكبر فهرس هو 8 فأصبح الفهرس المتولِّد التالي (القيمة 19) هو 9.

ينشئ هذا المثال مصفوفة من الفهرس 1.

المثال 3: إنشاء مصفوفة تبدأ من الفهرس 1 مع array()‎

<?php
$firstquarter = array(1 => 'January', 'February', 'March');
print_r($firstquarter);
?>

سوف ينتج المثال أعلاه:

Array
(
    [1] => January
    [2] => February
    [3] => March
)

كما هو الحال مع لغة Perl، يمكنك الوصول إلى قيمة من المصفوفة داخل علامات اقتباس مزدوجة. ومع ذلك، ستحتاج مع PHP إلى وضع مصفوفتك بين الأقواس المعقوفة. المثال 4: الوصول إلى مصفوفة داخل علامات اقتباس مزدوجة

<?php

$foo = array('bar' => 'baz');
echo "Hello {$foo['bar']}!"; // Hello baz!

?>

ملاحظات

ملاحظة: تمثل array()‎ بنيةً من بنى اللغة تُستخدم لتمثيل المصفوفات، وليست دالةً عاديةً.

انظر أيضًا

• الدالة array_pad()‎: ملء المصفوفة بعناصر بقيمة ما لتبلغ الطول المحدد.
• الدالة list()‎: تعيين المتغيرات كما لو كانت مصفوفة.
• الدالة count()‎: عدّ جميع العناصر في مصفوفة.
• الدالة range()‎: إنشاء مصفوفة تحتوي على مجال من العناصر.
• حلقة foreach.
• معلومات حول النوع array.

مصادر

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