PHP マニュアル
前のページ |  | 次のページ

# next

(PHP 3, PHP 4, PHP 5)

next -- 内部配列ポインタを進める

## 説明

mixed next ( array &array )

内部配列ポインタが次の場所を指すようにし、(ポインタ移動後の) その配列値を返します。それ以上要素がない場合は `FALSE` を返します。

next() は、ひとつの違いを除いて current() と同じです。 next() は要素を返す前に内部配列ポインタをひとつ先に進めます。 つまり、次の配列要素を返すとともに内部配列ポインタをひとつ進めるということです。 もし内部配列ポインタをひとつ進めた結果、 要素リストの最後の先まで行ってしまった場合、 next()は `FALSE` を返します。

警告
この関数は論理値 `FALSE` を返す可能性がありますが、`FALSE` として評価される `0` や "" といった値を返す可能性もあります。 詳細については 論理値の セクションを参照してください。この関数の返り値を調べるには ===演算子 を 使用してください。

> 注意: 配列中に boolean `FALSE` の要素が含まれていると、 それを配列の終わりと区別することができません。`FALSE` 要素を含む配列を順に処理するには、each() 関数を参照ください。

例 1. next() および類似関数の使用例

`<?php $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'; ?>`

current()、end()、 prev()、reset()、 および each() も参照ください。

前のページ | ホーム | 次のページ
natsort | 上に戻る | pos