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

Copy
1<?php
2
3/**
4 * PHP 8における doubleval() 関数と floatval() 関数の関係性について
5 *
6 * PHP 8では、doubleval() 関数は削除されています。
7 * 以前のPHPバージョンでは、doubleval() は floatval() のエイリアス（別名）として存在し、
8 * 両者とも値を浮動小数点数（float）に変換する同じ機能を提供していました。
9 *
10 * PHP 8以降では、値を浮動小数点数に変換する際には floatval() を使用することが推奨されます。
11 * この関数は、mixed型の引数を受け取り、その値を浮動小数点数として解釈して float 型で返します。
12 *
13 * このサンプルコードでは、floatval() を使って様々な型の値を浮動小数点数に変換する例を示します。
14 */
15function demonstrateFloatConversion(): void
16{
17    echo "--- floatval() を使った値の浮動小数点数への変換 ---" . PHP_EOL . PHP_EOL;
18
19    // 整数値を浮動小数点数に変換
20    $intValue = 123;
21    $floatFromInt = floatval($intValue);
22    echo "整数 '{$intValue}' を変換: " . $floatFromInt . " (型: " . gettype($floatFromInt) . ")" . PHP_EOL;
23
24    // 文字列を浮動小数点数に変換
25    // 数値として認識できる部分までが変換されます
26    $stringValue = "456.789";
27    $floatFromString = floatval($stringValue);
28    echo "文字列 '{$stringValue}' を変換: " . $floatFromString . " (型: " . gettype($floatFromString) . ")" . PHP_EOL;
29
30    // 不正な数値文字列の変換
31    // 先頭から数値として認識できる部分のみが変換されます
32    $mixedString = "789abc";
33    $floatFromMixedString = floatval($mixedString);
34    echo "文字列 '{$mixedString}' を変換: " . $floatFromMixedString . " (型: " . gettype($floatFromMixedString) . ")" . PHP_EOL;
35
36    // 非数値文字列の変換
37    // 数値として認識できない文字列は 0.0 に変換されます
38    $nonNumericString = "hello";
39    $floatFromNonNumericString = floatval($nonNumericString);
40    echo "文字列 '{$nonNumericString}' を変換: " . $floatFromNonNumericString . " (型: " . gettype($floatFromNonNumericString) . ")" . PHP_EOL;
41
42    // 真偽値を浮動小数点数に変換
43    // true は 1.0、false は 0.0 になります
44    $boolTrue = true;
45    $floatFromTrue = floatval($boolTrue);
46    echo "真偽値 'true' を変換: " . $floatFromTrue . " (型: " . gettype($floatFromTrue) . ")" . PHP_EOL;
47
48    $boolFalse = false;
49    $floatFromFalse = floatval($boolFalse);
50    echo "真偽値 'false' を変換: " . $floatFromFalse . " (型: " . gettype($floatFromFalse) . ")" . PHP_EOL;
51
52    // null を浮動小数点数に変換
53    // null は 0.0 になります
54    $nullValue = null;
55    $floatFromNull = floatval($nullValue);
56    echo "null 値を変換: " . $floatFromNull . " (型: " . gettype($floatFromNull) . ")" . PHP_EOL;
57
58    // 配列を浮動小数点数に変換
59    // 空の配列は 0.0、非空の配列は 1.0 になります（警告が出る場合もあります）
60    $emptyArray = [];
61    $floatFromEmptyArray = floatval($emptyArray);
62    echo "空の配列 [] を変換: " . $floatFromEmptyArray . " (型: " . gettype($floatFromEmptyArray) . ")" . PHP_EOL;
63
64    $nonEmptyArray = [1, 2, 3];
65    $floatFromNonEmptyArray = floatval($nonEmptyArray);
66    echo "非空の配列 [1, 2, 3] を変換: " . $floatFromNonEmptyArray . " (型: " . gettype($floatFromNonEmptyArray) . ")" . PHP_EOL;
67
68    echo PHP_EOL . "--- doubleval() についての補足 ---" . PHP_EOL;
69    echo "PHP 8環境では、doubleval() 関数を直接呼び出すと、" .
70         "未定義の関数エラー（'Call to undefined function doubleval()'）が発生します。" . PHP_EOL .
71         "代わりに floatval() を使用してください。" . PHP_EOL;
72}
73
74// 関数を実行して結果を表示
75demonstrateFloatConversion();
76

PHP 8において、かつて値を浮動小数点数に変換するdoubleval()関数は、floatval()関数の別名として存在しましたが、現在は削除されています。そのため、PHP 8以降のバージョンでは、値を浮動小数点数（float型）に変換する際にはfloatval()関数を使用することが推奨されます。

floatval()関数は、mixed型の引数、つまり整数、文字列、真偽値、nullなど、様々なデータ型の値を受け取ります。そして、その値を浮動小数点数として解釈し、float型で返します。例えば、整数値はそのまま浮動小数点数に、"456.789"のような数値文字列は456.789に変換されます。trueは1.0に、falseやnull、数値として認識できない文字列（例: "hello"）は0.0に変換されます。また、空の配列は0.0、要素を持つ配列は1.0に変換される挙動を示します。

PHP 8環境でdoubleval()を直接呼び出すと、未定義関数エラーが発生しますのでご注意ください。プログラムで様々な型の値を数値として処理し、特に小数点以下の値が必要な場合には、floatval()関数を適切に利用してください。