ホーム > PHP関数リファレンス > 配列系 > php reset 配列の内部ポインタを最初の要素にセットして値を取得

UPDATE:2019年12月12日

php reset 配列の内部ポインタを最初の要素にセットして値を取得

PHP4 PHP5 PHP7

php reset 配列の内部ポインタを最初の要素にセットして値を取得

php reset() サンプル

php reset 配列の内部ポインタを最初の要素にセットして値を取得

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

説明	配列の内部ポインタを最初の要素にセットし、要素の値を取得します。 ※配列には各要素に対する現在の位置を指し示す内部ポインタがあります。
引数	array 必須 $array	関数に入力する配列です。
返り値	mixed	配列要素の値を返す。空の配列の場合、FALSE を返す。

サンプル

<?php
$array = array('white','black','red','pink','orange','blue','yellow','green','purple','gray','brown','gold','silver');
echo end($array)."<br>\n"; //silver
echo reset($array)."<br>\n"; //white
?>

<?php

$array = array('white','black','red','pink','orange','blue','yellow','green','purple','gray','brown','gold','silver');

echo end($array)." \n"; //silver

echo reset($array)." \n"; //white

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

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

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

◆ reset() 内容

配列の内部ポインタを最初にセットして値を取得

配列には各要素に対する現在の位置を指し示す内部ポインタがあります。reset()関数 は、配列の内部ポインタを最初の要素にセットし、要素の値を取得します。

現在、内部ポインタが示している要素をカレント（カレント要素）と言います。配列の要素にはキーと値がセットで格納されており、reset は内部ポインタを初期化して最初の要素にセットし、要素の値を取得します。foreachのループ処理や、next()、end()、などによって内部ポインタが最初から移動している場合、reset()関数で最初の要素に戻すことが出来ます。

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

◆ reset() パラメーター

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

◆ reset() 返り値

mixed
配列の内部ポインタを最初の要素にセットして、配列要素の値を返す。空の配列の場合、reset()関数は FALSE を返す。

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

◆ reset() 変更履歴

PHPバージョン	変更内容
–	–

php reset() サンプル

<?php
$array = array('white','black','red','pink','orange','blue','yellow','green','purple','gray','brown','gold','silver');
echo end($array)."<br>\n"; //silver
echo reset($array)."<br>\n"; //white
?>

<?php

$array = array('white','black','red','pink','orange','blue','yellow','green','purple','gray','brown','gold','silver');

echo end($array)." \n"; //silver

echo reset($array)." \n"; //white

実行結果

silver
white

<?php
$array = array();
echo gettype(reset($array))."<br>\n"; //false
?>

<?php

$array = array();

echo gettype(reset($array))." \n"; //false

実行結果

boolean

タグ（＝記事関連ワード）

タグ: PHP, reset, 配列, 関数

日付

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

php getdate 日付や時刻を取得する

php next 配列の内部ポインタを次へ進めて要素の値を取得

このページのトップへ

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

php bin2hex() バイナリデータ（2進法）を16進表現に変換

count_chars() 文字列の文字情報を取得

echo() 1 つ以上の文字列を出力

explode() 文字列を指定文字列で分割

html_entity_decode() HTMLエンティティを適切な文字に戻す

htmlspecialchars_decode() HTMLエンティティを文字に戻す

htmlspecialchars() 文字列をHTML エンティティにエンコード

php strstr を検索【大文字／小文字区別あり】

php crypt 文字列をハッシュ化する（一方向）

php stripslashes 文字列の「バックスラッシュ（ \ ）」を取り除く

php htmlentities 文字列をHTMLエンティティにエンコード

php getdate 日付や時刻を取得する

php checkdate 日付が正しいか調べる

php reset 配列の内部ポインタを最初の要素にセットして値を取得

php end 配列の内部ポインタを最後まで進めて要素の値を取得

php next 配列の内部ポインタを次へ進めて要素の値を取得

php prev 配列の内部ポインタを前へ戻して要素の値を取得

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

php key 配列の現在の内部ポインタの要素のキーを取得

php filter_input POST や GET などの変数をフィルタリングする

php filter_id フィルタの ID を取得する

php filter_input_array POST や GET などの変数を一括フィルタリングする

php filter_var_array 配列で複数のデータをフィルタリングして値をチェックする

php filter_var データをフィルタリングして値をチェックする

php filter_list フィルタ一覧を取得する

php gettype 変数の型情報を取得する

php is_array 変数が配列型かどうかチェックする

php is_bool 変数が論理型かどうかチェックする

php is_float 変数が浮動小数点型かどうかチェックする

php implode() 配列要素を連結して文字列に変換（一繋ぎのテキストになる）

php is_int 変数が整数型かどうかチェックする

php addcslashes 指定文字の前にバックスラッシュを付ける(クォートする)

php is_null 変数がヌル型（NULL型）かどうかチェックする

php stristr 文字列を検索【大文字／小文字区別なし】

php is_string 変数が文字列型かどうかチェックする

php is_object 変数がオブジェクト型かどうかチェックする

php strtoupper 文字列（アルファベット部分）を大文字に変換

php is_numeric 変数が数値か文字列型の数字かどうかチェックする

php is_resource 変数がリソース型かどうかチェックする

php is_scalar 変数がスカラー型かどうかチェックする

php date 日付や時刻の取得

php time 現在日時のタイムスタンプを取得する

php strtotime 日付からタイムスタンプを取得

php mktime 日時からタイムスタンプを取得する

この記事へのコメント

トラックバックurl

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

php getdate 日付や時刻を取得する

php next 配列の内部ポインタを次へ進めて要素の値を取得

このページのトップへ

php reset 配列の内部ポインタを最初の要素にセットして値を取得

php reset 配列の内部ポインタを最初の要素にセットして値を取得

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

◆ reset() 内容

◆ reset() パラメーター

◆ reset() 返り値

◆ reset() 変更履歴

php reset() サンプル

タグ（＝記事関連ワード）

日付

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

この記事へのコメント

トラックバックurl

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