［PHP］is_double関数とは？浮動小数点数判定の基本から応用まで完全解説

PHPで数値を扱う際、整数と浮動小数点数を区別したい場面は多々あります。そんな時に使える関数の一つがis_double()です。この記事では、is_double()関数の基本的な使い方から、実際の開発での活用例、そして注意すべき点まで詳しく解説していきます。

is_double関数とは

is_double()は、指定した変数が浮動小数点数（float/double）かどうかを判定するPHP関数です。PHPでは「float」と「double」は同じ型として扱われるため、この関数はis_float()関数のエイリアス（別名）として機能します。

基本的な構文

is_double(mixed $value): bool

引数: 判定したい変数
戻り値: 浮動小数点数の場合はtrue、そうでなければfalse

is_doubleとis_floatの関係

重要なポイントとして、PHPにおいてis_double()とis_float()は完全に同じ機能を持ちます：

<?php
$number = 3.14;

var_dump(is_double($number)); // bool(true)
var_dump(is_float($number));  // bool(true)

// 内部的には同じ関数を呼び出している
echo (is_double($number) === is_float($number)) ? 'Same' : 'Different'; // Same
?>

現在ではis_float()の使用が推奨されており、is_double()は歴史的な理由で残されている関数です。

基本的な使用例

様々なデータ型での動作確認

<?php
// 浮動小数点数 - true
$float1 = 3.14;
$float2 = 2.0;
$float3 = 1.5e3; // 科学記法
var_dump(is_double($float1)); // bool(true)
var_dump(is_double($float2)); // bool(true)
var_dump(is_double($float3)); // bool(true)

// 整数 - false
$integer = 42;
var_dump(is_double($integer)); // bool(false)

// 文字列（数字） - false
$string_number = "3.14";
var_dump(is_double($string_number)); // bool(false)

// その他の型 - false
var_dump(is_double("hello"));    // bool(false)
var_dump(is_double(true));       // bool(false)
var_dump(is_double(null));       // bool(false)
var_dump(is_double([]));         // bool(false)
?>

型変換による動作

<?php
// 整数を浮動小数点数に変換
$int = 10;
$float = (float)$int;

var_dump(is_double($int));   // bool(false)
var_dump(is_double($float)); // bool(true)

// 文字列から浮動小数点数への変換
$string = "3.14159";
$converted = floatval($string);

var_dump(is_double($string));    // bool(false)
var_dump(is_double($converted)); // bool(true)
?>

実際の開発での活用例

1. 数値計算の精度管理

<?php
function calculateWithPrecision($value, $precision = 2)
{
    if (!is_numeric($value)) {
        throw new InvalidArgumentException('Value must be numeric');
    }
    
    // 浮動小数点数の場合は精度を調整
    if (is_double($value)) {
        return round($value, $precision);
    }
    
    // 整数の場合はそのまま返す
    return $value;
}

// 使用例
echo calculateWithPrecision(3.14159);  // 3.14
echo calculateWithPrecision(42);       // 42
echo calculateWithPrecision(2.999);    // 3
?>

2. 金額計算での型チェック

<?php
class PriceCalculator
{
    public function calculateTotal($prices)
    {
        $total = 0;
        $hasFloatValues = false;
        
        foreach ($prices as $price) {
            if (!is_numeric($price)) {
                throw new InvalidArgumentException('All prices must be numeric');
            }
            
            if (is_double($price)) {
                $hasFloatValues = true;
            }
            
            $total += $price;
        }
        
        // 浮動小数点数が含まれている場合は小数点以下2桁で表示
        if ($hasFloatValues) {
            return number_format($total, 2);
        }
        
        return (int)$total;
    }
}

$calculator = new PriceCalculator();

// 浮動小数点数を含む場合
$prices1 = [10, 15.50, 20];
echo $calculator->calculateTotal($prices1); // 45.50

// 整数のみの場合
$prices2 = [10, 15, 20];
echo $calculator->calculateTotal($prices2); // 45
?>

3. データベース値の型判定

<?php
function formatDatabaseValue($value, $fieldType)
{
    switch ($fieldType) {
        case 'decimal':
        case 'float':
            if (is_double($value)) {
                return number_format($value, 2);
            } elseif (is_int($value)) {
                return number_format($value, 2);
            } else {
                return number_format((float)$value, 2);
            }
            
        case 'integer':
            return is_double($value) ? (int)$value : $value;
            
        default:
            return $value;
    }
}

// 使用例
$dbValues = [
    ['value' => 3.14159, 'type' => 'decimal'],
    ['value' => 42, 'type' => 'integer'],
    ['value' => 2.5, 'type' => 'float']
];

foreach ($dbValues as $item) {
    echo formatDatabaseValue($item['value'], $item['type']) . "\n";
}
// 出力:
// 3.14
// 42
// 2.50
?>

4. API レスポンスの型安全性確保

<?php
class ApiResponseValidator
{
    public function validateNumericField($value, $fieldName, $allowFloat = true)
    {
        if (!is_numeric($value)) {
            throw new InvalidArgumentException("{$fieldName} must be numeric");
        }
        
        // 浮動小数点数が許可されていない場合
        if (!$allowFloat && is_double($value)) {
            throw new InvalidArgumentException("{$fieldName} must be an integer");
        }
        
        return true;
    }
    
    public function sanitizeResponse($data)
    {
        $sanitized = [];
        
        foreach ($data as $key => $value) {
            if (is_double($value)) {
                // 浮動小数点数は精度を制限
                $sanitized[$key] = round($value, 6);
            } else {
                $sanitized[$key] = $value;
            }
        }
        
        return $sanitized;
    }
}

$validator = new ApiResponseValidator();

// バリデーション例
try {
    $validator->validateNumericField(3.14, 'price', true);     // OK
    $validator->validateNumericField(3.14, 'quantity', false); // エラー
} catch (InvalidArgumentException $e) {
    echo $e->getMessage(); // quantity must be an integer
}
?>

浮動小数点数の注意点

1. 精度の問題

<?php
// 浮動小数点数の精度問題
$a = 0.1 + 0.2;
var_dump($a);               // float(0.30000000000000004)
var_dump(is_double($a));    // bool(true)

// 比較時の注意
var_dump($a == 0.3);        // bool(false) - 精度の問題
var_dump(abs($a - 0.3) < 0.0001); // bool(true) - 適切な比較方法
?>

2. 無限大とNaN（Not a Number）

<?php
// 無限大
$infinity = INF;
$negative_infinity = -INF;

var_dump(is_double($infinity));          // bool(true)
var_dump(is_double($negative_infinity)); // bool(true)
var_dump(is_infinite($infinity));        // bool(true)

// NaN（Not a Number）
$nan = NAN;
var_dump(is_double($nan)); // bool(true)
var_dump(is_nan($nan));    // bool(true)

// NaNの特殊な性質
var_dump($nan == $nan);    // bool(false) - NaNは自分自身とも等しくない
?>

3. 型の自動変換

<?php
function demonstrateTypeConversion()
{
    $int = 5;
    $float = 2.5;
    
    // 計算結果は浮動小数点数になる
    $result = $int / $float;
    
    echo "Original types:\n";
    var_dump(is_int($int));    // bool(true)
    var_dump(is_double($float)); // bool(true)
    
    echo "Result type:\n";
    var_dump(is_double($result)); // bool(true)
    var_dump($result);           // float(2)
}

demonstrateTypeConversion();
?>

パフォーマンスとベストプラクティス

1. 型チェックの効率的な実装

<?php
function efficientTypeCheck($values)
{
    $intCount = 0;
    $floatCount = 0;
    $otherCount = 0;
    
    foreach ($values as $value) {
        if (is_int($value)) {
            $intCount++;
        } elseif (is_double($value)) {
            $floatCount++;
        } else {
            $otherCount++;
        }
    }
    
    return [
        'integers' => $intCount,
        'floats' => $floatCount,
        'others' => $otherCount
    ];
}

// 使用例
$data = [1, 2.5, 3, 4.7, "hello", 5.0];
$stats = efficientTypeCheck($data);
print_r($stats);
// Array
// (
//     [integers] => 2
//     [floats] => 3
//     [others] => 1
// )
?>

2. 関数選択の指針

<?php
// 推奨: is_float()を使用
function recommendedApproach($value)
{
    if (is_float($value)) {
        return "Float value: " . $value;
    }
    return "Not a float";
}

// 非推奨だが動作する: is_double()を使用
function legacyApproach($value)
{
    if (is_double($value)) {
        return "Double value: " . $value;
    }
    return "Not a double";
}

$testValue = 3.14;
echo recommendedApproach($testValue) . "\n"; // Float value: 3.14
echo legacyApproach($testValue) . "\n";      // Double value: 3.14
?>

他の型判定関数との比較

<?php
function compareTypeFunctions($value)
{
    return [
        'is_double' => is_double($value),
        'is_float' => is_float($value),
        'is_numeric' => is_numeric($value),
        'is_int' => is_int($value),
        'gettype' => gettype($value)
    ];
}

$testValues = [3.14, 42, "3.14", "42", true, null];

foreach ($testValues as $value) {
    echo "Value: " . var_export($value, true) . "\n";
    print_r(compareTypeFunctions($value));
    echo "\n";
}
?>