【PHP8.x】current関数の使い方

<?php

/**
 * current() 関数を使って配列の現在の要素を取得するサンプルコード
 */

// 配列を定義
$fruits = ['apple', 'banana', 'orange'];

// current() 関数を使って現在の要素を取得
$current_fruit = current($fruits);

// 結果を出力
echo "現在の要素: " . $current_fruit . PHP_EOL; // 出力: 現在の要素: apple

// 配列のポインタを次に移動
next($fruits);

// もう一度 current() 関数を使って現在の要素を取得
$current_fruit = current($fruits);

// 結果を出力
echo "現在の要素: " . $current_fruit . PHP_EOL; // 出力: 現在の要素: banana

// 配列のポインタを最後に移動
end($fruits);

// current() 関数を使って現在の要素を取得
$current_fruit = current($fruits);

// 結果を出力
echo "現在の要素: " . $current_fruit . PHP_EOL; // 出力: 現在の要素: orange

// ポインタが範囲外の場合
next($fruits);
$current_fruit = current($fruits);
if ($current_fruit === false) {
    echo "現在の要素は存在しません" . PHP_EOL; //出力: 現在の要素は存在しません
}

?>

current()関数は、PHPの配列において、内部ポインタが指し示している現在の要素を返します。この関数は、引数として配列 $array を参照渡しで受け取ります。つまり、元の配列が直接操作されることはありません。

サンプルコードでは、まず $fruits という配列を定義し、current()関数を使って最初の要素である "apple" を取得しています。next()関数を使うと、配列の内部ポインタが次の要素に進み、current()関数で "banana" が取得できます。同様に、end()関数でポインタを配列の最後に移動させると、current()関数は "orange" を返します。

重要な点として、current()関数は配列の内容を変更せず、あくまで現在のポインタ位置にある要素を返すだけです。また、ポインタが配列の範囲外を指している場合（例えば、next()関数を繰り返し呼び出して配列の末尾を超えた場合）、current()関数は false を返します。サンプルコードでは、このfalseが返るケースをチェックし、要素が存在しないことを確認しています。current()関数は、配列を操作する上で、現在の要素を安全に取得するために非常に役立ちます。配列の要素を順番に処理する際などに活用できます。

<?php

/**
 * current() 関数とタイムスタンプの利用例
 *
 * 配列内の現在要素をタイムスタンプに変換して表示します。
 */
function demonstrateCurrentTimestamp() {
  $timestamps = [
    'event1' => strtotime('2024-01-01'),
    'event2' => strtotime('2024-02-15'),
    'event3' => strtotime('2024-03-20')
  ];

  // 現在の要素を取得
  $currentTimestamp = current($timestamps);

  // タイムスタンプを日付形式に変換して表示
  echo "現在のタイムスタンプ: " . $currentTimestamp . "\n";
  echo "日付形式: " . date('Y-m-d H:i:s', $currentTimestamp) . "\n";

  // 配列の内部ポインタを次に進める
  next($timestamps);

  // 次の要素を取得
  $nextTimestamp = current($timestamps);

   // タイムスタンプを日付形式に変換して表示
  echo "次のタイムスタンプ: " . $nextTimestamp . "\n";
  echo "日付形式: " . date('Y-m-d H:i:s', $nextTimestamp) . "\n";
}

// 関数を実行
demonstrateCurrentTimestamp();

?>

PHPのcurrent()関数は、配列の内部ポインタが指す現在の要素を返します。引数には、参照渡しで配列$arrayを指定します。内部ポインタは、配列内のどの要素が現在アクセスされているかを示すもので、current()関数はこのポインタが指す要素の値を返します。もし内部ポインタが配列の範囲外を指している場合は、current()関数はfalseを返します。

このサンプルコードでは、strtotime()関数を使って日付文字列をタイムスタンプ（Unixエポックからの秒数）に変換し、それを配列に格納しています。current()関数を使って配列の現在の要素（最初の要素）のタイムスタンプを取得し、date()関数を使ってタイムスタンプを人間が読みやすい日付形式に変換して表示しています。

その後、next()関数を使って配列の内部ポインタを次の要素に進め、再度current()関数で次の要素のタイムスタンプを取得し、同様に日付形式に変換して表示しています。この例では、current()関数が配列の内部ポインタの位置に応じて異なる値を返すことを示しています。current()関数は、配列の要素を順番に処理する際に、現在の要素の値を取得するために役立ちます。なお、current()関数は内部ポインタの位置を変更しないため、同じ要素を何度も取得できます。