acf_maybe_get()

WordPressの関数acf_maybe_get()は、指定されたキーが存在するかどうかを確認しながら配列から値を取得するための関数です。

構文

acf_maybe_get( array $array, string|int $key, mixed $default = null )

引数の説明:

• $array (array) — 値を取得する対象となる配列。
• $key (string|int) — 配列から取得するキー。
• $default (mixed) — 指定されたキーが存在しない場合に返されるデフォルト値（省略可能）。

例 1: 配列から値を取得

配列内のキーが存在する場合、その値を取得します。

<?php
$array = array( 'name' => 'WordPress', 'type' => 'CMS' );
$name = acf_maybe_get( $array, 'name', 'デフォルト値' );
echo $name; // 結果: WordPress
?>

例 2: 存在しないキーの取得

指定されたキーが存在しない場合、デフォルト値が返されます。

<?php
$array = array( 'name' => 'WordPress', 'type' => 'CMS' );
$version = acf_maybe_get( $array, 'version', '不明' );
echo $version; // 結果: 不明
?>

例 3: ネストされた配列の値を取得

ネストされた配列から値を取得する場合にも使用できます。

<?php
$array = array( 'settings' => array( 'theme' => 'twentytwentyone' ) );
$theme = acf_maybe_get( $array['settings'], 'theme', 'デフォルトテーマ' );
echo $theme; // 結果: twentytwentyone
?>

例 4: 数値キーを使用する場合

数値キーを持つ配列から値を取得します。

<?php
$array = array( 0 => '最初', 1 => '2番目', 2 => '3番目' );
$value = acf_maybe_get( $array, 1, 'デフォルト値' );
echo $value; // 結果: 2番目
?>

例 5: デフォルト値がオブジェクトの場合

デフォルト値にオブジェクトを使用する場合も可能です。

<?php
$default = (object) array( 'key' => 'デフォルト' );
$array = array( 'data' => (object) array( 'key' => '値' ) );
$result = acf_maybe_get( $array, 'unknown', $default );
echo $result->key; // 結果: デフォルト
?>