PHP Manual
Prev | Chapter 6. Types | Next

# Arrays

Arrays actually act like both hash tables (associative arrays) and indexed arrays (vectors).

## Single Dimension Arrays

PHP supports both scalar and associative arrays. In fact, there is no difference between the two. You can create an array using the list() or array() functions, or you can explicitly set each array element value.

    $a[0] = "abc";
    $a[1] = "def";
    $b["foo"] = 13;

You can also create an array by simply adding values to the array. When you assign a value to an array variable using empty brackets, the value will be added onto the end of the array.

    $a[] = "hello"; // $a[2] == "hello"
    $a[] = "world"; // $a[3] == "world"

Arrays may be sorted using the asort(), arsort(), ksort(), rsort(), sort(), uasort(), usort(), and uksort() functions depending on the type of sort you want.

You can count the number of items in an array using the count() function.

You can traverse an array using next() and prev() functions. Another common way to traverse an array is to use the each() function.

## Multi-Dimensional Arrays

Multi-dimensional arrays are actually pretty simple. For each dimension of the array, you add another [key] value to the end:

    $a[1]      = $f;               # one dimensional examples
    $a["foo"]  = $f;

    $a[1][0]     = $f;             # two dimensional
    $a["foo"][2] = $f;             # (you can mix numeric and associative indices)
    $a[3]["bar"] = $f;             # (you can mix numeric and associative indices)

    $a["foo"][4]["bar"][0] = $f;   # four dimensional!

In PHP3 it is not possible to reference multidimensional arrays directly within strings. For instance, the following will not have the desired result:

    $a[3]['bar'] = 'Bob';
    echo "This won't work: $a[3][bar]";

In PHP3, the above will output `This won't work: Array[bar]`. The string concatenation operator, however, can be used to overcome this:

    $a[3]['bar'] = 'Bob';
    echo "This will work: " . $a[3][bar];

In PHP4, however, the whole problem may be circumvented by enclosing the array reference (inside the string) in curly braces:

    $a[3]['bar'] = 'Bob';
    echo "This will work: {$a[3][bar]}";

You can "fill up" multi-dimensional arrays in many ways, but the trickiest one to understand is how to use the array() command for associative arrays. These two snippets of code fill up the one-dimensional array in the same way:

    # Example 1:

    $a["color"]	= "red";
    $a["taste"]	= "sweet";
    $a["shape"]	= "round";
    $a["name"]	= "apple";
    $a[3]		= 4;

    # Example 2:
    $a = array(
         "color" => "red",
         "taste" => "sweet",
         "shape" => "round",
         "name"  => "apple",
         3       => 4
    );

The array() function can be nested for multi-dimensional arrays:

    <?
    $a = array(
         "apple"  => array(
              "color"  => "red",
              "taste"  => "sweet",
              "shape"  => "round"
         ),
         "orange"  => array(
              "color"  => "orange",
              "taste"  => "tart",
              "shape"  => "round"
         ),
         "banana"  => array(
              "color"  => "yellow",
              "taste"  => "paste-y",
              "shape"  => "banana-shaped"
         )
    );

    echo $a["apple"]["taste"];    # will output "sweet"
    ?>

Prev | Home | Next
Strings | Up | Objects