sprintf() 依格式字串產生格式化字串(回傳而非輸出),常用於 SQL 組裝、報表輸出、數值格式化。本文說明語法、格式代碼、與 printf()/echo/print 差異。
語法與回傳值
string sprintf(string $format, mixed ...$values): string
// 回傳格式化後字串
int printf(string $format, mixed ...$values): int
// 直接輸出並回傳長度
常用格式代碼
| 代碼 | 說明 | 範例 |
%s | 字串 | sprintf('%s', 'abc') → 'abc' |
%d | 有號十進位整數 | sprintf('%d', 123) → '123' |
%f | 浮點數(預設小數 6 位) | sprintf('%.2f', 3.14159) → '3.14' |
%x/%X | 十六進位小寫/大寫 | sprintf('%X', 255) → 'FF' |
%b | 二進位 | sprintf('%b', 10) → '1010' |
%c | ASCII 字元 | sprintf('%c', 65) → 'A' |
%% | 字面 % 符號 | |
實務範例:SQL 組裝(防注入配合逃逸)
$query = sprintf(
'INSERT INTO %sUSER (USERNAME, PASSWORD, EMAIL_ADDR, IS_ACTIVE, PERMISSION) VALUES ("%s", "%s", "%s", %d, %d)',
DB_TBL_PREFIX,
mysql_real_escape_string($this->username),
mysql_real_escape_string($this->password),
mysql_real_escape_string($this->emailAddr),
$this->isActive,
$this->permission
);
比較:sprintf vs 字串串接
- 可讀性:格式字串集中,參數對應清晰。
- 型別轉換:自動處理
%d 整數、%f 浮點數格式化。
- 效能:大量字串組裝時
sprintf 通常快於多次 . 串接。
- 安全:仍需自行處理 SQL 逃逸,**現代專案請改用 PDO Prepared Statements**。
echo/print/printf/sprintf 差異表
| 函數 | 回傳值 | 參數數量 | 用途 |
echo | 無 | 多個 | 直接輸出 |
print | 永遠 1 | 單一 | 輸出並可用於表達式 |
printf | 輸出長度 | 格式+多參數 | 格式化輸出 |
sprintf | 格式化字串 | 格式+多參數 | 格式化取得字串 |