在 PHP 開發中,sprintf() 是一個極其強大的字符串格式化函數,它允許開發者根據指定的格式生成字符串。無論是格式化數字、控制浮點數精度、還是構建複雜的輸出模板,sprintf() 都能輕鬆勝任。本文將深入解析其核心用法,重點講解浮點數格式化控制,並揭示一個關於整數與浮點數參數傳遞的「隱形陷阱」。
sprintf(string $format, mixed ...$values): string
% 開頭)。浮點數輸出是 sprintf() 最常見的應用場景之一。預設使用 %f 會保留小數點後 6 位:
echo sprintf("%f", 3.1415926); // 輸出:"3.141593"
若需自定義總寬度與小數位數,可使用 %m.nf 格式:
// 右對齊,總寬 9 位,小數 3 位(前面補 3 個空格)
echo sprintf("%9.3f", 3.1415926); // 結果:" 3.142"
// 左對齊(加減號 -),總寬 9 位,小數 3 位(後面補空格)
echo sprintf("%-9.3f", 3.1415926); // 結果:"3.142 "
// 僅指定小數位數,不限制總寬度
echo sprintf("%.3f", 3.1415926); // 結果:"3.142"
請看下面的代碼:
$num = 100;
sprintf("%.2f", $num);
sprintf("%.2f", (double)$num);
乍看之下結果相同(均為 "100.00"),但底層機制截然不同。
參數壓棧時,調用者並不知道格式控制符是 %f;函數執行時,函數本身也不知道棧中實際是整數。 因此,保存整數 $num 的 4 字節會被強行按浮點數格式解析,導致未定義行為(雖然在某些架構上碰巧輸出正確,但極不安全)。
顯式轉型確保類型匹配:
sprintf("%.2f", (float)$num); // 或 (double)$num
sprintf("%.2f", floatval($num));
| 格式符 | 說明 |
|---|---|
| %d / %i | 有符號十進制整數 |
| %u | 無符號十進制整數 |
| %f / %F | 浮點數(區分大小寫僅影響 nan/inf 輸出) |
| %e / %E | 科學計數法 |
| %s | 字符串 |
| %x / %X | 十六進制(小寫/大寫) |
| %% | 字面百分號 |
sprintf() 是格式化輸出的利器,尤其適合報表、日志、模板生成等場景。%m.nf 精確控制寬度與精度。