sprintf 函数用法详解

sprintf 是 C 语言中的一个标准库函数，用于将格式化的数据写入字符串中。与 printf 类似，但 sprintf 不会直接输出到标准输出（如屏幕），而是将结果存储到一个字符数组中。

函数原型

c
int sprintf(char *str, const char *format, ...);


参数说明

1. char *str

   • 指向目标字符数组的指针，用于存储格式化后的字符串。
   • 调用者需要确保该数组有足够的空间来存储结果，否则可能导致缓冲区溢出。

2. const char *format

   • 格式字符串，指定如何格式化后续参数。
   • 支持类似 printf 的格式说明符（如 %d, %s, %f 等）。

3. ...

   • 可变参数，提供要格式化的数据。

返回值

• 返回写入到字符串中的字符数（不包括终止的空字符 ）。
• 如果发生错误，返回负值。

常见格式说明符

| 格式符 | 说明 | 示例 |
|--------|-------------------------------|-----------------------|
| %d | 十进制整数 | 123 |
| %f | 浮点数 | 3.14159 |
| %s | 字符串 | "hello" |
| %c | 单个字符 | 'A' |
| %x | 十六进制整数（小写） | 7b |
| %X | 十六进制整数（大写） | 7B |
| %% | 输出一个百分号 | % |

使用示例

示例 1：基本用法

```c

include

int main() {
char buffer[100];
int num = 42;
float pi = 3.14159;
char name[] = "Alice";

sprintf(buffer, "Number: %d, Pi: %.2f, Name: %s", num, pi, name);
printf("Formatted string: %sn", buffer);

return 0;

}

**输出**：

Formatted string: Number: 42, Pi: 3.14, Name: Alice
```

示例 2：处理字符

```c

include

int main() {
char buffer[50];
char ch = 'A';

sprintf(buffer, "Character: %c", ch);
printf("Formatted string: %sn", buffer);

return 0;

}

**输出**：

Formatted string: Character: A
```

示例 3：十六进制输出

```c

include

int main() {
char buffer[50];
int num = 255;

sprintf(buffer, "Hexadecimal (lowercase): %x", num);
printf("%sn", buffer);

sprintf(buffer, "Hexadecimal (uppercase): %X", num);
printf("%sn", buffer);

return 0;

}

**输出**：

Hexadecimal (lowercase): ff
Hexadecimal (uppercase): FF
```

注意事项

1. 缓冲区大小

   • 确保目标字符数组足够大，以容纳格式化后的字符串和终止符 。
   • 如果缓冲区不足，可能导致缓冲区溢出，进而引发未定义行为。

2. 安全性

   • sprintf 不会检查目标缓冲区的大小，因此容易导致安全问题。
   • 推荐使用更安全的 snprintf，它允许指定写入字符数。

示例：使用 snprintf

```c

include

int main() {
char buffer[20];
int num = 12345;

// 使用 snprintf 限制写入长度
snprintf(buffer, sizeof(buffer), "Number: %d", num);
printf("Formatted string: %sn", buffer);

return 0;

}

**输出**：

Formatted string: Number: 12345
```

常见错误

1. 缓冲区溢出

   • 如果格式化后的字符串长度超过目标缓冲区大小，会覆盖相邻内存，导致程序崩溃或安全漏洞。

2. 未正确终止字符串

   • sprintf 会自动添加 ，但如果缓冲区被手动覆盖，可能导致字符串未正确终止。

• sprintf 是一个强大的工具，用于将格式化数据写入字符串。
• 使用时需特别注意缓冲区大小，避免溢出。
• 推荐使用更安全的 snprintf 替代 sprintf。

通过合理使用 sprintf 或其安全版本，可以高效地处理字符串格式化任务。

（本文地址：https://www.nzw6.com/41656.html）