萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP sprintf() 函數完整指南:格式化輸出與浮點數控制

前言

在 PHP 開發中,sprintf() 是一個極其強大的字符串格式化函數,它允許開發者根據指定的格式生成字符串。無論是格式化數字、控制浮點數精度、還是構建複雜的輸出模板,sprintf() 都能輕鬆勝任。本文將深入解析其核心用法,重點講解浮點數格式化控制,並揭示一個關於整數與浮點數參數傳遞的「隱形陷阱」。

基本語法

sprintf(string $format, mixed ...$values): string
  • $format:格式化字符串,包含普通字符和格式佔位符(以 % 開頭)。
  • $values:要格式化的變量列表。

浮點數格式化:%f 與 %m.nf 詳解

浮點數輸出是 sprintf() 最常見的應用場景之一。預設使用 %f 會保留小數點後 6 位:

echo sprintf("%f", 3.1415926); // 輸出:"3.141593"

若需自定義總寬度與小數位數,可使用 %m.nf 格式:

  • m:整體佔用寬度(不足左側補空格,默認右對齊)。
  • n:小數點後保留位數(四捨五入)。

實戰範例

// 右對齊,總寬 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 精確控制寬度與精度。
  • 永遠顯式轉型數值類型,避免整數被誤解析為浮點數導致不可移植的 Bug。
copyright © 萬盛學電腦網 all rights reserved