php sprintf用法

封面图 • 2025-11-06 • PHP

`php sprintf()` 是一个非常常用的函数，用于格式化字符串。它的功能类似于 `printf()`，但 `sprintf()` 不会输出结果，而是返回格式化后的字符串。

---

## ✅ 语法：

```php
string sprintf(string $format, mixed ...$args): string
```

- `$format`：格式化字符串（包含普通文本和格式说明符）。
- `$args`：可变参数，按顺序替换格式说明符。

---

## 📌 常见格式说明符：

| 格式 | 描述 |
|------|------|
| `%d` 或 `%i` | 整数 |
| `%f` | 浮点数 |
| `%s` | 字符串 |
| `%b` | 二进制数 |
| `%o` | 八进制数 |
| `%x` 或 `%X` | 十六进制数（小写或大写） |
| `%c` | 单个字符 |
| `%e` 或 `%E` | 科学记数法（小写或大写） |
| `%u` | 无符号整数 |
| `%n` | 把当前的字符数写入到变量中（不常用） |

---

## 🧪 示例代码：

### 示例 1：基本用法

```php
$name = "Alice";
$age = 25;
$message = sprintf("姓名：%s，年龄：%d", $name, $age);
echo $message; // 输出：姓名：Alice，年龄：25
```

---

### 示例 2：格式化浮点数

```php
$price = 19.99;
$formatted = sprintf("价格：%.2f 元", $price);
echo $formatted; // 输出：价格：19.99 元
```

---

### 示例 3：带宽度和对齐

```php
$name = "John";
$greeting = sprintf("Hello, %-10s", $name); // 左对齐，宽度为10
echo $greeting; // 输出：Hello, John      （后面有空格）
```

---

### 示例 4：使用多个参数

```php
$result = sprintf("今天是 %d 年 %02d 月 %02d 日", 2025, 4, 5);
echo $result; // 输出：今天是 2025 年 04 月 05 日
```

---

### 示例 5：使用十六进制格式

```php
$hex = sprintf("十六进制: %x", 255);
echo $hex; // 输出：十六进制: ff
```

---

## ⚠️ 注意事项：

- 如果你忘记传递参数，或者参数类型不对，可能会导致错误。
- `%n` 可以用来获取当前输出的字符数，但一般不推荐使用。
- 在 PHP 中，`sprintf()` 的格式说明符与 C 语言中的 `printf` 类似，但略有不同（比如支持 Unicode 等）。

---

## 📚 相关函数：

- `printf()`：直接输出格式化字符串。
- `vsprintf()`：类似 `sprintf()`，但接受一个数组作为参数。
- `sprintf()` 和 `printf()` 都可以用于生成 HTML、日志、数据库查询等场景。

---

如果你有具体的应用场景或问题，欢迎告诉我，我可以帮你更详细地解释！