当前位置：首页 > news >正文

sscanf 和 snprintf：格式化处理的利器

news 2026/6/5 14:50:46

前言

在 C/C++ 开发中，字符串的格式化输入输出是最常见的需求之一。sscanf和snprintf这两个函数，一个是“从字符串中读取格式化数据”，一个是“将格式化数据写入字符串”，堪称字符串处理的双子星。本文将从原理、参数、注意事项到实战案例，带你彻底掌握这两个函数。

一、函数原型与头文件

#include <stdio.h> int sscanf(const char *str, const char *format, ...); int snprintf(char *str, size_t size, const char *format, ...);

sscanf：从字符串str中按照format格式提取数据存入后续参数。
snprintf：将格式化结果写入字符串str，最多写入size字节（包含结尾的'\0'）。

二、sscanf 详解

2.1 基本功能

sscanf是scanf的字符串版本，常用于解析固定格式的字符串。

char buf[] = "张三 25 180.5"; char name[20]; int age; float height; sscanf(buf, "%s %d %f", name, &age, &height); printf("姓名：%s，年龄：%d，身高：%.1f\n", name, age, height);

输出：

姓名：张三，年龄：25，身高：180.5

2.2 返回值

sscanf返回成功匹配并赋值的参数个数，失败返回EOF（通常是 -1）。

int ret = sscanf("123 abc", "%d %s", &num, str); printf("匹配个数：%d\n", ret); // 输出 2

通过返回值可以判断解析是否完整，这是健壮代码的关键。

2.3 高级用法：格式限定符

格式	含义
`%*s`	跳过匹配但不赋值
`%[^,]`	匹配除逗号外的任意字符
`%[a-z]`	只匹配小写字母
`%[^]]`	匹配除`]`外的任意字符
`%[^\n]`	匹配到换行符为止
`%*[^:]`	跳过直到冒号之前的内容

2.3.1 实例1：跳过无用部分

char data[] = "ID:10086, Name:Alice"; int id; char name[20]; sscanf(data, "%*[^:]:%d, %*[^:]:%s", &id, name); // %*[^:] 跳过 "ID"，然后匹配冒号后的数字，再跳过 ", Name:" 部分 printf("id=%d, name=%s\n", id, name);

2.3.2 实例2：解析CSV行

char line[] = "苹果,5.8,红色"; char product[20]; float price; char color[10]; sscanf(line, "%[^,],%f,%s", product, &price, color); // %[^,] 读取到逗号前

2.4 常见陷阱

目标缓冲区必须足够大，否则会溢出（sscanf不检查长度）。
字符串匹配会跳过空白，%s遇到空格即停止。
解析失败时，未匹配的变量保持原值（不会自动清零）。

三、snprintf 详解

3.1 基本用法

snprintf是sprintf的安全版本，最重要的区别是限制写入长度。

char buf[20]; int len = snprintf(buf, sizeof(buf), "数值：%d", 12345); printf("写入内容：%s，实际长度：%d\n", buf, len);

3.2 返回值含义

snprintf返回如果缓冲区足够大时应该写入的字符数（不包括结尾的'\0'）。

如果返回值>= size，说明内容被截断了。
如果返回值>= 0且< size，则字符串完整写入。

char small[10]; int need = snprintf(small, sizeof(small), "abcdefghijklmn"); printf("需要 %d 字节，实际写入 %d 字节\n", need, (int)strlen(small)); if (need >= sizeof(small)) { printf("内容被截断了！\n"); }

3.3 动态分配最佳实践

利用返回值可以安全地动态分配足够大的缓冲区

int need = snprintf(NULL, 0, "姓名：%s，年龄：%d", "李四", 30); char *buf = malloc(need + 1); if (buf) { snprintf(buf, need + 1, "姓名：%s，年龄：%d", "李四", 30); printf("%s\n", buf); free(buf); }

3.4 常见陷阱

忘记预留'\0'的空间：size参数必须包含结尾空字符。
返回值被误认为是实际写入长度：实际要取min(返回值, size-1)。
与sprintf混用：永远不要用sprintf，用snprintf替代。

四、实战案例

4.1 案例1：解析配置文件（sscanf）

void parse_config(const char *line) { char key[32], value[64]; if (sscanf(line, "%[^=]=%s", key, value) == 2) { printf("key=[%s], value=[%s]\n", key, value); } } int main() { parse_config("username=admin"); parse_config("timeout=30"); return 0; }

4.2 案例2：格式化网络数据包（snprintf）

typedef struct { char cmd[8]; int seq; char data[64]; } Packet; void build_packet(Packet *pkt, int seq, const char *msg) { snprintf(pkt->cmd, sizeof(pkt->cmd), "DATA"); pkt->seq = seq; snprintf(pkt->data, sizeof(pkt->data), "%s", msg); } void serialize(Packet *pkt, char *out, size_t out_size) { snprintf(out, out_size, "%s,%d,%s", pkt->cmd, pkt->seq, pkt->data); } int main() { Packet pkt; build_packet(&pkt, 100, "hello world"); char buffer[128]; serialize(&pkt, buffer, sizeof(buffer)); printf("序列化结果：%s\n", buffer); return 0; }

4.3 案例3：组合使用：sscanf + snprintf

void process_message(char *msg, char *reply, size_t reply_size) { char cmd[16]; int value; if (sscanf(msg, "%s %d", cmd, &value) == 2) { if (strcmp(cmd, "add") == 0) { snprintf(reply, reply_size, "结果是：%d", value + 10); } else { snprintf(reply, reply_size, "未知命令"); } } else { snprintf(reply, reply_size, "格式错误"); } } int main() { char reply[100]; process_message("add 5", reply, sizeof(reply)); printf("%s\n", reply); return 0; }