sprintf函数概述
在 STM32 编程中，sprintf函数用于将格式化的数据写入字符串。其函数原型一般是int sprintf(char *str, const char *format,...);，这个函数定义在<stdio.h>头文件中。
其中，str是目标字符串的指针，也就是格式化后的数据将要存储的位置；format是格式化字符串，它规定了数据的格式，类似于printf中的格式字符串；...表示可变参数列表，用于传递要格式化的数据。
在 STM32 中的应用场景
数据格式化输出到字符串：
例如，将一个整数和一个浮点数格式化成一个字符串。假设有一个整数变量int_value = 10和一个浮点数变量float_value = 3.14，可以使用sprintf将它们组合成一个字符串。
char buffer[50];
int int_value = 10;
float float_value = 3.14;
sprintf(buffer, "Integer: %d, Float: %f", int_value, float_value);
这样，buffer字符串中就存储了格式化后的内容"Integer: 10, Float: 3.140000"。这个字符串可以用于在 LCD 显示屏上显示，或者通过串口发送出去等操作。
构建命令字符串：
在与外部设备通信时，比如通过串口向一个设备发送命令。假设要向一个温度传感器发送获取温度的命令，命令格式为"GET_TEMP\n"，可以使用sprintf来构建这个命令字符串。
char command[10];
sprintf(command, "GET_TEMP\n");
// 然后可以通过串口发送这个命令
// 假设已经有一个函数send_serial_data用于发送串口数据
send_serial_data(command, sizeof(command));
注意事项
缓冲区大小限制：
要确保目标字符串str所指向的缓冲区有足够的大小来存储格式化后的内容。如果缓冲区大小不够，会导致缓冲区溢出，可能会覆盖其他内存区域，从而引发程序错误甚至系统崩溃。在上面的例子中，buffer的大小是 50 字节，这个大小要根据实际格式化后的内容长度来合理确定。
格式字符串的正确性：
格式字符串format中的格式控制符（如%d、%f等）要与后面的可变参数的数据类型相匹配。如果不匹配，会导致数据输出错误。例如，如果将一个浮点数用%d格式控制符进行格式化，那么得到的结果将是错误的。
格式化字符串（format）的基本规则
转换说明符：
%d或%i：用于将一个有符号整数转换为十进制字符串形式并插入到目标字符串中。例如：
int num = 10;
char str[20];
sprintf(str, "The number is %d", num);
这会将"The number is 10"存储到str字符串中。
%u：用于将一个无符号整数转换为十进制字符串形式。比如：
unsigned int num = 5;
char str[20];
sprintf(str, "The unsigned number is %u", num);
结果是"The unsigned number is 5"存入str。
%x或%X：将一个无符号整数转换为十六进制小写（%x）或大写（%X）字符串形式。例如：
unsigned int num = 15;
char str[20];
sprintf(str, "The hexadecimal number is %x", num);
会得到"The hexadecimal number is f"，如果用%X则是"The hexadecimal number is F"。
%f：用于将一个浮点数转换为十进制字符串形式（默认小数点后 6 位）。例如：
float num = 3.14;
char str[20];
sprintf(str, "The floating - point number is %f", num);
生成"The floating - point number is 3.140000"。
%c：将一个字符插入到目标字符串中。例如：
char ch = 'A';
char str[20];
sprintf(str, "The character is %c", ch);
得到"The character is A"。
%s：用于将一个字符串插入到目标字符串中。例如：
char source_str[] = "Hello";
char str[20];
sprintf(str, "The string is %s", source_str);
结果是"The string is Hello"。
宽度修饰符和精度修饰符：
宽度修饰符用于指定输出的最小宽度。例如，%5d表示输出一个整数，宽度至少为 5 位，如果不足 5 位则在左边补空格。如：
int num = 3;
char str[20];
sprintf(str, "The number is %5d", num);
会得到"The number is 3"。
精度修饰符主要用于浮点数和字符串。对于浮点数，它指定小数点后的位数；对于字符串，它指定要输出的最大字符数。例如：
float num = 3.14159;
char str[20];
sprintf(str, "The number is %.2f", num);
得到"The number is 3.14"。
对于字符串：
char source_str[] = "Hello World";
char str[20];
sprintf(str, "The string is %.5s", source_str);
会得到"The string is Hello"。
标志字符：
-：用于左对齐输出。例如：
int num = 3;
char str[20];
sprintf(str, "The number is %-5d", num);
结果是"The number is 3 "，与之前的右对齐（默认）情况相反。
+：用于在有符号数前面显示正号或负号。例如：
int num = -3;
char str[20];
sprintf(str, "The number is %+d", num);
得到"The number is -3"，如果num是正数，如3，则会显示"The number is +3"。
0：用于在宽度修饰符指定的宽度范围内，用 0 填充空白部分（主要用于整数和浮点数）。例如：
int num = 3;
char str[20];
sprintf(str, "The number is %05d", num);
会得到"The number is 00003"。
格式化说明符 %3.0f 的含义
%f：表示要格式化一个浮点数，它会把对应的浮点数转换为十进制的字符串形式。
3 是宽度修饰符：它指定了输出的最小宽度为 3 个字符位置（包含小数点和小数部分等，如果有的话）。不过需要注意的是，对于浮点数，宽度修饰符要考虑整个格式化后的长度，包括整数部分、小数点和小数部分等。
0 是精度修饰符：在这里精度为 0，表示小数点后面不保留小数位数，也就是会对浮点数进行取整操作。例如：
如果 valueFloat 的值是 1.23，经过 %3.0f 的格式化后，会得到 1（取整后，并且因为宽度修饰符要求至少占 3 个字符位置，实际输出时会在左边补空格，最终在字符串中存储的内容可能类似 " 1"，当然具体是否补空格以及补多少还取决于 showbuffer 的后续使用等情况）。
如果 valueFloat 的值是 12.34，格式化后会得到 12，在目标字符串中存储形式可能类似 " 12"（同样考虑宽度补位情况）。
2. 格式化字符串各部分含义"%2d-%02X"
%2d：
%d 表示要将对应的参数按照十进制整数的形式进行格式化并插入到目标字符串中。这里的参数就是 alarmNumberCount，它应该是一个整数类型的变量。
2 是宽度修饰符，它指定了输出的最小宽度为 2 个字符位置。如果 alarmNumberCount 的值本身不足 2 位（比如值为 1），那么会在左边补空格，使其占满 2 个字符位置，最终在字符串中呈现的效果类似 " 1"。
-：它是一个普通的字符常量，会原样输出到目标字符串中，起到分隔作用，将前面格式化后的整数和后面格式化后的内容隔开。
%02X：
%X 表示要将对应的参数按照十六进制整数（大写字母表示）的形式进行格式化并插入到目标字符串中。这里对应的参数是 alarmCodeList[num].codeNumber[1]，它大概率是一个整数类型（通常用于存储十六进制相关的数值）。
02 中的 2 同样是宽度修饰符，指定输出的最小宽度为 2 个字符位置，而 0 是填充字符，意思是如果 alarmCodeList[num].codeNumber[1] 的值不足 2 位十六进制数（比如值为 5，十六进制表示为 05），那么会在左边用 0 填充，使其占满 2 个字符位置，最终在字符串中呈现类似 "05" 的效果。
————————————————
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
原文链接：https://blog.csdn.net/KingOne007/article/details/144218341
|
楼主
标题置顶
标题高亮
