四大核心取整函數對比
| 函數 | 行為 | 回傳型別 | 典型用例 |
floor() | 向下取整(捨去小數) | float | 分頁計算、索引邊界 |
ceil() | 向上取整(進位) | float | 分頁總頁數、資源配額 |
round() | 四捨五入(支援精度) | float | 金額計算、評分顯示 |
intval() / (int) | 截斷小數(向零取整) | int | 型別轉換、位元運算前 |
詳細行為與範例
floor() - 向下取整
<?php
echo floor(4.3); // 4
echo floor(9.999); // 9
echo floor(-4.3); // -5 (注意:負數「向下」是更小的數)
echo floor(-4.9); // -5
// 回傳 float,大數值可能超出 int 範圍
var_dump(floor(1e20)); // float(1.0E+20)
?>
ceil() - 向上取整
<?php
echo ceil(4.3); // 5
echo ceil(9.999); // 10
echo ceil(-4.3); // -4 (負數「向上」是更大的數)
echo ceil(-4.9); // -4
// 實際應用:計算總頁數
$totalItems = 105;
$perPage = 20;
$totalPages = (int)ceil($totalItems / $perPage); // 6
?>
round() - 四捨五入(支援精度控制)
<?php
// 基本四捨五入
echo round(3.4); // 3
echo round(3.5); // 4
echo round(3.6); // 4
// 精度控制(第 2 參數)
echo round(3.14159, 2); // 3.14
echo round(3.14159, 3); // 3.142
echo round(1.95583, 2); // 1.96
echo round(1241757, -3); // 1242000 (負精度:對 10 的冪次方取整)
// 銀行家圍入法(PHP 預設模式:PHP_ROUND_HALF_EVEN)
echo round(5.045, 2); // 5.04 (偶數優先)
echo round(5.055, 2); // 5.06
// 強制四捨五入(傳統模式)
echo round(5.045, 2, PHP_ROUND_HALF_UP); // 5.05
echo round(5.055, 2, PHP_ROUND_HALF_UP); // 5.06
echo round(5.045, 2, PHP_ROUND_HALF_DOWN); // 5.04
echo round(5.055, 2, PHP_ROUND_HALF_DOWN); // 5.05
?>
intval() / (int) - 截斷轉換
<?php
// 正數:等同 floor()
echo intval(4.9); // 4
echo (int)4.9; // 4
// 負數:等同 ceil()(向零取整)
echo intval(-4.9); // -4
echo (int)-4.9; // -4
// 字串轉換:從開頭解析數字
echo intval('123abc'); // 123
echo intval('abc123'); // 0
// 基數轉換(第 2 參數)
echo intval('1010', 2); // 10 (二進制)
echo intval('FF', 16); // 255 (十六進制)
echo intval('77', 8); // 63 (八進制)
?>
常見陷阱與最佳實踐
陷阱 1:浮點數精度導致意外結果
<?php
$val = 0.1 + 0.2; // 0.30000000000000004
echo floor($val * 10); // 3 (正確)
echo round($val, 1); // 0.3 (正確)
// 危險:直接比較
if (floor(0.1 + 0.2) === 0.3) {} // false!
// 解決:使用 BCMath 或整數運算(分為單位)
$price1 = 199; // $1.99 存為 199 分
$price2 = 299; // $2.99 存為 299 分
$total = $price1 + $price2; // 498 分,精確
?>
陷阱 2:大數值超出整數範圍
<?php
// 32 位系統:int 最大 2147483647
// 64 位系統:int 最大 9223372036854775807
$large = 1e15;
echo floor($large); // float(1000000000000000)
echo intval($large); // 可能溢位或轉 float
// 安全做法:保持 float 或用 BCMath
echo bcadd('1000000000000000', '1'); // '1000000000000001'
?>
陷阱 3:負數取整方向混淆
<?php
$num = -3.7;
floor($num); // -4 (向下:更小)
ceil($num); // -3 (向上:更大)
round($num); // -4 (四捨五入:遠離零)
intval($num); // -3 (截斷:向零)
// 記憶口訣:
// floor = 地板(最低) ceil = 天花板(最高)
// intval = 截斷小數部分
?>
實戰場景速查表
| 場景 | 推薦函數 | 代碼範例 |
| 分頁總頁數 | ceil() | (int)ceil($total / $perPage) |
| 陣列分塊索引 | floor() | floor($index / $chunkSize) |
| 金額元/分轉換 | round() / 整數運算 | round($yuan * 100) / 儲存分 |
| 評分顯示 (1 位小數) | round($score, 1) | round(4.35, 1) → 4.4 |
| 型別強制轉 int | (int) / intval() | $page = (int)($_GET['page'] ?? 1) |
| 位元運算前轉換 | (int) | $flags = (int)$input |
| 時間戳取整秒 | floor() / intval() | floor(microtime(true)) |
進階:自定義取整函數
<?php
/**
* 靈活取整:支援向上/向下/四捨五入/向零
*/
function custom_round(float $value, int $precision = 0, string $mode = 'half_up'): float {
$factor = 10 ** $precision;
$scaled = $value * $factor;
return match ($mode) {
'floor' => floor($scaled) / $factor,
'ceil' => ceil($scaled) / $factor,
'half_up' => (floor($scaled * 2 + 1) / 2) / $factor, // 模擬 PHP_ROUND_HALF_UP
'half_down' => (ceil($scaled * 2 - 1) / 2) / $factor,
'half_even' => round($value, $precision, PHP_ROUND_HALF_EVEN),
'half_odd' => round($value, $precision, PHP_ROUND_HALF_ODD),
'zero' => intval($scaled) / $factor, // 向零截斷
default => throw new InvalidArgumentException("Unknown mode: $mode"),
};
}
// 測試
echo custom_round(3.14159, 2, 'floor'); // 3.14
echo custom_round(3.14159, 2, 'ceil'); // 3.15
echo custom_round(-3.7, 0, 'zero'); // -3
?>
總結
- floor/ceil:方向固定,回傳 float,大數安全
- round:支援精度與多種模式,金融計算必備
- intval/(int):向零截斷,回傳 int,注意溢位
- 金融計算:避免浮點數,用**整數(分/厘)或 BCMath**
- 負數邏輯:floor 向下(更小),ceil 向上(更大),intval 向零