next

Advance the internal pointer of an array

&reftitle.description; `mixed` `next` ``array``object```array`

`next` behaves like `current`, with one difference. It advances the internal array pointer one place forward before returning the element value. That means it returns the next array value and advances the internal array pointer by one.

&reftitle.parameters;

`array`

- The `array` being affected.

&reftitle.returnvalues;

Returns the array value in the next place that's pointed to by the internal array pointer, or &false; if there are no more elements.

&return.falseproblem;
&reftitle.changelog;

&Version; | &Description;
&standard.changelog.calling-on-objects;

&reftitle.examples;

### Example use of `next` and friends

    <?php
    $transport = array('foot', 'bike', 'car', 'plane');
    echo $mode = current($transport), PHP_EOL; // $mode = 'foot';
    echo $mode = next($transport), PHP_EOL;    // $mode = 'bike';
    echo $mode = next($transport), PHP_EOL;    // $mode = 'car';
    echo $mode = prev($transport), PHP_EOL;    // $mode = 'bike';
    echo $mode = end($transport), PHP_EOL;     // $mode = 'plane';
    ?>

&reftitle.notes;

The end of an array is indistinguishable from a `bool` &false; element. To properly traverse an array which may contain &false; elements, see the `foreach` function.

To still use `next` and properly check if the end of the array has been reached, verify that the `key` is &null;.

&reftitle.seealso;

- `current`
- `end`
- `prev`
- `reset`
- `each`