menu
ホーム > PHP関数リファレンス > 配列系 > php current 配列の現在の内部ポインタの要素の値を取得

php current 配列の現在の内部ポインタの要素の値を取得

php current 配列の現在の内部ポインタの要素の値を取得 | wepicks!

PHP4 PHP5 PHP7


php current 配列の現在の内部ポインタの要素の値を取得

current() 書式
mixed 配列要素の値 = current(array $array);
配列が空の場合 FALSE を返す
最終要素の次の要素の場合 FALSE を返す

説明配列のカレントの要素(現在内部ポインタが示している要素)の値を取得します。
※配列には各要素に対する現在の位置を指し示す内部ポインタがあります。
引数array 必須 $array関数に入力する配列です。
返り値mixed配列のカレントの要素の値を返す。内部ポインタが配列の最終要素の次を指していたり、入力した配列が空などの場合、返り値は FALSE になります。

サンプル

引数 や 返り値 のデータ型の説明

データ型 引数 や 返り値 のデータ型の説明
引数 や 返り値内容(引数 | 返り値)
string文字列型 を受け入れる。 | 文字列型 を返す。
int整数型 を受け入れる。 | 整数型 を返す。
float浮動小数点数型 を受け入れる。 | 浮動小数点数型 を返す。
bool論理型 を受け入れる。 | 論理型 を返す。
number整数型 または 浮動小数点数型 を受け入れる。 | 整数型 または 浮動小数点数型 を返す。
array配列型 を受け入れる。 | 配列型 を返す。
objectオブジェクト型 を受け入れる。 | オブジェクト型 を返す。
array|object配列型 または オブジェクト型 を受け入れる。 | 配列型 または オブジェクト型 を返す。
mixed複数の データ型 を受け入れる(パラメーター)、或いは、返す(返り値)ことが可能。全てのデータ型ではありません。例えば gettype()関数 は全ての型を受け入れますが、一方、str_replace()関数 は、文字列型 と 配列型 のみを受け入れます。また、reset()関数 や end()関数 は、返り値に 配列型 と 論理型(FALSE)を返します。
voidパラメータ一覧で void が使用されている場合、その関数がパラメータを受け付けないことを表します。 | 返り値の型が void である場合、返り値に意味がないことを表します。
callbackcallback 疑似型がこのドキュメントで使われていたのは、PHP 5.4 で callable タイプヒントが導入される前のことでした。両者はまったく同じ意味です。

◆ current() 内容

配列のカレント要素の値を返す

配列には各要素に対する現在の位置を指し示す内部ポインタがあります。current()関数 は、配列のカレントの要素(現在内部ポインタが示している要素)のを取得します。
配列の要素にはキーと値がセットで格納されており、current は 要素の値を取得します。current は、ポインタを移動させません。current() は、内部ポインタが配列の最終要素の次を指していたり、入力した配列が空などの場合、FALSE を返します。
ポインタは配列作成時に初期化されており、最初の要素を示します。reset()関数 で配列の内部ポインタを先頭の要素にセットすることが出来ます。

配列には、現在配列内のどの要素を指しているかを示す内部ポインタがある

◆ current() パラメーター

内容
必須 array $array関数に入力する配列です。

◆ current() 返り値

mixed
配列のカレントの要素(現在内部ポインタが指し示している要素)の値を返す。内部ポインタが配列の最終要素の次を指していたり、入力した配列が空などの場合、返り値は FALSE になります。

mixed 複数の データ型 を受け入れる(パラメーター)、或いは、返す(返り値)ことが可能。全てのデータ型ではありません。例えば gettype()関数 は全ての型を受け入れますが、一方、str_replace()関数 は、文字列型 と 配列型 のみを受け入れます。また、reset()関数 や end()関数 は、返り値に 配列型 と 論理型(FALSE)を返します。

◆ current() 変更履歴

PHPバージョン変更内容
7.0.0array は常に値で渡されるようになりました。 このバージョンより前は、可能な場合は参照で、それ以外の場合は値で 渡されていました。

php current() サンプル

実行結果
Apple
Banana
Banana
Apple
Strawberry
Strawberry


タグ(=記事関連ワード)

タグ: , , ,

日付

投稿日:2019年7月11日
最終更新日:2019年12月12日

配列関数サンプル

このカテゴリの他のページ

この記事へのコメント

トラックバックurl

https://wepicks.net/phpfunction-array-current/trackback/

page top