語法與格式字元
string sprintf(string $format, mixed ...$values): string
| 格式 | 說明 | 範例輸出 |
%% | 百分號字面值 | % |
%b | 二進位 | sprintf('%b', 10) → 1010 |
%c | ASCII 字元 | 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+ 棄用警告)
- 忘記
%% 輸出字面百分號