萬盛學電腦網

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

PHP sprintf() 格式化字串完整指南與實戰範例

語法與格式字元

string sprintf(string $format, mixed ...$values): string
格式說明範例輸出
%%百分號字面值%
%b二進位sprintf('%b', 10) → 1010
%cASCII 字元sprintf('%c', 65) → A
%d有號十進位整數sprintf('%d', -4.5) → -4
%e科學記號 (小寫)sprintf('%e', 12345) → 1.234500e+4
%E科學記號 (大寫)sprintf('%E', 12345) → 1.234500E+4
%u無號整數sprintf('%u', -1) → 4294967295 (32位)
%f浮點數 (區域感知)sprintf('%.2f', 3.14159) → 3.14
%F浮點數 (非區域)同上,不受 locale 影響
%g短科學記號 (自動選擇 %f/%e)sprintf('%g', 123.456) → 123.456
%G大寫版 %g
%o八進位sprintf('%o', 10) → 12
%s字串sprintf('%s', 'hello') → hello
%x十六進位 (小寫)sprintf('%x', 255) → ff
%X十六進位 (大寫)sprintf('%X', 255) → FF

進階格式控制

引數編號與重複使用 (PHP 4.0.6+)

實戰範例

1. XML/JSON 範本產生 (微信回覆範例)

2. SQL 參數化雛形 (教學用,實務請用 PDO)

 '%s' LIMIT %d",
    $status,           // 需自行 addslashes 或參數綁定
    date('Y-m-d', $since),
    $limit
);

3. 格式化檔案大小

 0 ? floor(log($bytes, 1024)) : 0;
    return sprintf("%.*f %s", $precision, $bytes / (1024 ** $exp), $units[$exp]);
}
echo formatBytes(123456789); // 117.74 MB

4. 產生固定長度代碼/單號

5. 進度條顯示

vs printf() / vprintf() / vsprintf()

函式輸出方式參數形式回傳值
sprintf回傳字串列表格式化字串
printf直接輸出列表輸出長度
vprintf直接輸出陣列輸出長度
vsprintf回傳字串陣列格式化字串

效能提示

  • sprintf() 比字串串接 . 慢,但可讀性高、易維護
  • 熱門路徑大量呼叫考慮 vsprintf() 配合預先準備陣列
  • 單純變數插值 "Hello $name" 效能最佳

常見錯誤

  • 格式字元與引數數量不符 → 產生警告、結果截斷
  • %d 對應浮點數會截斷小數,非四捨五入
  • %s 對應 null 會輸出空字串 (PHP 8.1+ 棄用警告)
  • 忘記 %% 輸出字面百分號
copyright © 萬盛學電腦網 all rights reserved