PHP next() Function

PHP Array Reference : Output the value of the current and the next element in the array

Definition and Usage

The next() function moves the internal pointer to, and outputs, the next element in the array.

Related methods:

  • prev() - moves the internal pointer to, and outputs, the previous element in the array
  • current() - returns the value of the current element in an array
  • end() - moves the internal pointer to, and outputs, the last element in the array
  • reset() - moves the internal pointer to the first element of the array
  • each() - returns the current element key and value, and moves the internal pointer forward
  • Syntax

    next(array)

    Parameter Values

    Parameter Description
    array Required. Specifies the array to use

    Technical Details

    Return Value: Returns the value of the next element in the array on success, or FALSE if there are no more elements
    PHP Version: 4+

    More Examples

    Example

    A demonstration of all related methods:

    <?php
    $people = array("Peter", "Joe", "Glenn", "Cleveland");

    echo current($people) . "<br>"; // The current element is Peter
    echo next($people) . "<br>"; // The next element of Peter is Joe
    echo current($people) . "<br>"; // Now the current element is Joe
    echo prev($people) . "<br>"; // The previous element of Joe is Peter
    echo end($people) . "<br>"; // The last element is Cleveland
    echo prev($people) . "<br>"; // The previous element of Cleveland is Glenn
    echo current($people) . "<br>"; // Now the current element is Glenn
    echo reset($people) . "<br>"; // Moves the internal pointer to the first element of the array, which is Peter
    echo next($people) . "<br>"; // The next element of Peter is Joe

    print_r (each($people)); // Returns the key and value of the current element (now Joe), and moves the internal pointer forward
    ?>

    ❮ PHP Array Reference