acf_parse_types()


Advanced Custom Fields(ACF)のacf_parse_types()関数は、入力された値を指定したデータ型に変換するために使用されます。

構文

acf_parse_types( mixed $value, string $type );

引数の説明

  • $value (mixed) — 変換したい値を指定します。
  • $type (string) — 変換先のデータ型(例: “string”, “int”, “bool” など)を指定します。

例 1: 数値への変換

値を整数に変換する例です。

<?php
$result = acf_parse_types( '123', 'int' );
echo $result; // 123
?>

例 2: 真偽値への変換

文字列を真偽値に変換する例です。

<?php
$result = acf_parse_types( 'true', 'bool' );
var_dump( $result ); // bool(true)
?>

例 3: 配列への変換

カンマ区切りの文字列を配列に変換する例です。

<?php
$result = acf_parse_types( 'apple,banana,orange', 'array' );
print_r( $result ); // Array ( [0] => apple [1] => banana [2] => orange )
?>

例 4: デフォルト値の適用

無効な値を指定した場合にデフォルト値を使用する例です。

<?php
$result = acf_parse_types( null, 'string' );
echo $result; // ""
?>

例 5: カスタム処理の適用

独自のデータ型を定義して処理を行う例です。

<?php
function custom_type_parser( $value ) {
    return strtoupper( $value );
}
add_filter( 'acf/parse_types/custom', 'custom_type_parser' );

$result = acf_parse_types( 'hello', 'custom' );
echo $result; // "HELLO"
?>

注意事項

  • $typeが正しく指定されていない場合、意図しない結果になる可能性があります。
  • 関数を使用する際には、入力値が期待する型であるか確認してください。