Справочник по PHP

Функция поддерживается PHP 4, PHP 5

Курсор массива

reset

Производит сброс курсора массива.

Синтаксис:

mixed reset(array arr)

Функция reset() устанавливает внутренний курсор массива arr на его начало и возвращает значение начального элемента.

Пример использования функции reset():

$array = array("step one", "step two", "step three", "step four");

// by default, the pointer is on the first element

echo current($array) . "
n"; // "step one"


// skip two steps

next($array);

next($array);

echo current($array) . "
n"; // "step three"

// reset pointer, start again on step one

reset($array);

echo current($array) . "
n"; // "step one"

?>

Функция поддерживается PHP 3, PHP 4, PHP 5

end

Производит перенос курсора в конец массива.

Синтаксис:

mixed end(array arr)

Функция end() устанавливает внутренний курсор массива arr на последний элемент и возвращает значение этого элемента.

Пример использования функции end():

$fruits = array("apple", "banana", "cranberry");

echo end($fruits); // cranberry

?>

Функция поддерживается PHP 3

, PHP 4, PHP 5

next

Производит перенос курсора вперед.

Синтаксис:

mixed next(array arr)

Функция next() возвращает значение элемента, на котором в данный момент находится курсор, и перемещает курсор массива на следующий элемент. Возвращает false, если элементов больше не осталось.

Также false возвращается, если встречается элемент с пустым значением, следовательно для корректной работы с массивом, содержащим пустые элементы, лучще использовать функцию each().

Пример использования функции next():

$transport = array("foot", "bike", "car", "plane");

$mode = current($transport); // $mode = "foot";

$mode = next($transport); // $mode = "bike";

$mode = next($transport); // $mode = "car";

$mode = prev($transport); // $mode = "bike";

$mode = end($transport); // $mode = "plane";

?>

Функция поддерживается PHP 3, PHP 4, PHP 5

prev

Производит перенос курсора назад и возвращает предыдущее значени.

Синтаксис:

mixed prev(array arr)

Функция prev() перемещает курсор массива на предыдущий элемент и возвращает его значение. Возвращает false, если элементов больше не осталось.

Также false возвращается, если встречается элемент с пустым значением, следовательно для корректной работы с массивом, содержащим пустые элементы, лучще использовать функцию each().

Пример использования функции prev():

$transport = array("foot", "bike", "car", "plane");

$mode = current($transport); // $mode = "foot";

$mode = next($transport); // $mode = "bike";

$mode = next($transport); // $mode = "car";

$mode = prev($transport); // $mode = "bike";

$mode = end($transport); // $mode = "plane";

?>

Функция поддерживается PHP 3, PHP 4, PHP 5

current

Определение текущего элемента массива.

Синтаксис:

mixed current(array arr)

Каждый массив имеет внутренний указатель(курсор) текущего элемента. Обычно он указывает на первый элемент массива.

Функция current() возвращает значение элемента, на котором в данный момент находится курсор массива, при этом не сдвигая курсор.

Если указатель находиться за пределами массива, или массив пустой, то функция возвратит FALSE.

Пример использования функции current():

$transport = array("foot", "bike", "car", "plane");

$mode = current($transport); // $mode = "foot";

$mode = next($transport); // $mode = "bike";

$mode = current($transport); // $mode = "bike";

$mode = prev($transport); // $mode = "foot";

$mode = end($transport); // $mode = "plane";