C语言如何填充字符串实现索引与冒号固定宽度对齐输出

需求说明 #

打印数字索引加冒号的列表时，不同位数的索引后的冒号保持垂直对齐，目标输出效果如下：

...
8  : SOME STUFF
9  : MORE STUFF
10 : MORE STUFF BUT LESS PADDING
...
100: MORE STUFF BUT NO PADDING
...

原有无法实现对齐的代码如下，还存在分号位置错误的语法问题，且格式串中多余的$符号不符合输出要求：

printf("$%d", index);
printf(":"): // 该行无法根据索引长度自动补空格
printf(" some stuff");

实现方案 #

直接利用printf自带的字段宽度格式化参数即可，不需要手动计算拼接空格：

• 格式符中加-代表打印内容左对齐（默认右对齐，不符合数字顶格的需求）
• 格式符后跟的数字代表该字段占用的固定字符宽度，不足宽度的位置自动补空格
• 宽度值设置为需要支持的最大索引的位数即可：比如索引最大为999（3位数）就设为3，最大为9999（4位数）就设为4

固定宽度写法（适配3位以内索引） #

直接合并打印逻辑即可，输出完全匹配对齐要求：

// 索引字段占3位宽度左对齐，后面直接接冒号和内容
printf("%-3d: %s\n", index, "待打印的内容");

实际输出逻辑：

• 1位索引（如8、9）：数字占1位，后面补2个空格再接冒号
• 2位索引（如10、99）：数字占2位，后面补1个空格再接冒号
• 3位索引（如100、999）：数字占满3位，直接接冒号

动态宽度写法（自动适配任意长度索引） #

如果不确定索引的最大位数，可以先计算最大索引的位数作为宽度值，适配任意长度的索引场景：

// 计算最大索引的位数，max_index替换为实际列表的最大索引值
int print_width = snprintf(NULL, 0, "%d", max_index);
// 用*占位符传入动态宽度参数
printf("%-*d: %s\n", print_width, index, "待打印的内容");

内容的提问来源于stack exchange，提问作者staplegun