PHP sprintf 函數控制浮點數格式完整指南

基本浮點數格式化

sprintf("%f", $num) 默認保留小數點後 6 位。

sprintf("%f", 3.1415926);  // "3.141593" (四捨五入)

自定義寬度與精度：%m.nf

• m — 總寬度（含小數點、符號），不足左側填充空格。
• n — 小數點後位數。

sprintf("%9.3f", 3.1415926);   // "    3.142" (右對齊，寬度 9)
sprintf("%-9.3f", 3.1415926);  // "3.142    " (左對齊)
sprintf("%.3f", 3.1415926);    // "3.142" (不指定總寬度)

常見陷阱：整數參數與 %f

$num = 100;
sprintf("%.2f", $num);        // 正確輸出 "100.00"
sprintf("%.2f", (double)$num); // 同樣輸出 "100.00"

原理： PHP 內部會根據格式字符串自動轉換類型，但 C 底層 printf 族函數直接讀取棧內存，若格式與實際參數類型不匹配會導致未定義行為。PHP 封裝層做了類型轉換，故通常安全，但嚴禁在 sprintf 中混用不匹配的類型（如 %d 對應浮點數）。

其他實用格式符

最佳實踐

• 貨幣金額請使用 number_format() 或 Money 庫，避免浮點精度問題。
• 日誌/報表固定欄寬輸出時善用 %m.nf 對齊。
• 結合 vsprintf() 處理數組參數，代碼更整潔。