C++ 浮点数格式化与保留小数位技术讲义

在 C++ 开发和算法竞赛中，浮点数的精度输出是非常高频的需求。处理浮点数显示时，核心在于区分 “有效数字” 与 “小数位数”。

目录

1. 核心概念：默认有效位数 vs 默认小数位
2. 方法一：std::cout 流操作符格式化（推荐 C++ 风格）
3. 方法二：printf 格式化输出（C 风格，高效简洁）
4. 高级进阶：对齐、补零、符号与常用修饰符
5. 踩坑提醒与最佳实践

一、核心概念

在未进行任何格式化干预时，std::cout 和 printf 的默认行为差异极大：

二、方法一：std::cout 流控制

使用 C++ 流控制需要引入头文件 <iomanip>。

1. 核心控制符说明

• std::setprecision(n)：
• 单独使用：设置总的 有效数字位数 为 $n$ 位。
• 配合 std::fixed 使用：设置 小数点后的位数 为 $n$ 位。
• std::fixed：指定以固定小数形式（定点计数法）输出。

2. C++11 代码演示

#include <iostream>
#include <iomanip> // 必须包含此头文件

int main() {
    double pi = 3.1415926535;
    double bigNum = 12345.6789;

    std::cout << "===== 1. 默认状态 =====" << std::endl;
    std::cout << "pi: " << pi << std::endl;         // 输出: 3.14159 (6位有效数字)
    std::cout << "bigNum: " << bigNum << std::endl; // 输出: 12345.7 (6位有效数字)

    std::cout << "\n===== 2. 仅使用 setprecision(n) 控制有效数字 =====" << std::endl;
    std::cout << std::setprecision(3) << pi << std::endl;     // 输出: 3.14 (3位有效数字)
    std::cout << std::setprecision(4) << bigNum << std::endl; // 输出: 1.235e+04 (4位有效数字，超出转科学计数法)

    std::cout << "\n===== 3. std::fixed + std::setprecision(n) 保留固定小数位 =====" << std::endl;
    // 强制转换为定点表示，此后 precision 均代表小数点后的位数
    std::cout << std::fixed; 
    std::cout << "保留 2 位小数: " << std::setprecision(2) << pi << std::endl; // 输出: 3.14
    std::cout << "保留 4 位小数: " << std::setprecision(4) << pi << std::endl; // 输出: 3.1416
    std::cout << "保留 2 位小数: " << std::setprecision(2) << bigNum << std::endl; // 输出: 12345.68

    std::cout << "\n===== 4. 取消 fixed 状态（恢复默认） =====" << std::endl;
    std::cout.unsetf(std::ios::fixed);
    std::cout << std::setprecision(6) << pi << std::endl; // 恢复 6 位有效数字

    return 0;
}

三、方法二：printf 格式化控制

printf 来自 <cstdio>，是 C/C++ 中极为常用的快速格式化输出方法。

1. 格式占位符结构

格式串结构：%[标志][最小宽度][.精度][长度修饰]格式字符 - %.2f：保留 2 位小数。 - %.*f：动态指定小数位数（通过参数传入）。

2. C++11 代码演示

#include <cstdio>

int main() {
    double pi = 3.1415926535;
    float f = 2.5f;

    printf("===== 1. 基础小数保留 =====\n");
    printf("默认 %%f: %f\n", pi);       // 输出: 3.141593 (默认6位小数)
    printf("保留2位: %.2f\n", pi);      // 输出: 3.14
    printf("保留5位: %.5f\n", pi);      // 输出: 3.14159

    printf("\n===== 2. 动态指定小数位数 (%.*f) =====\n");
    for (int prec = 1; prec <= 4; ++prec) {
        // 使用 * 占位，由前面的参数 prec 传入具体精度
        printf("精度为 %d: %.*f\n", prec, prec, pi);
    }

    printf("\n===== 3. double 与 float 的占位符 =====\n");
    // 在 printf 中，float 会自动提升为 double，%f 和 %lf 在 printf 中效果相同
    printf("float 使用 %%.2f: %.2f\n", f);
    printf("double 使用 %%.2lf: %.2lf\n", pi);

    return 0;
}

四、格式化高级控制技术

在实际工程中，除了保留位数，还需要对齐排版、补零和符号显示。

1. 宽度控制与补零（Field Width & Padding）

#include <iostream>
#include <iomanip>
#include <cstdio>

int main() {
    double val = 4.25;

    std::cout << "--- std::cout 控制宽度与补零 ---" << std::endl;
    std::cout << std::fixed << std::setprecision(2);
    // 右对齐，总宽 8 位，不足补空格
    std::cout << "|" << std::setw(8) << val << "|" << std::endl; // 输出: |    4.25|
    // 左对齐
    std::cout << "|" << std::left << std::setw(8) << val << "|" << std::endl; // 输出: |4.25    |
    // 前置补零（恢复右对齐后）
    std::cout << std::right << std::setfill('0');
    std::cout << "|" << std::setw(8) << val << "|" << std::endl; // 输出: |00004.25|

    std::cout << "\n--- printf 控制宽度与补零 ---" << std::endl;
    printf("|%8.2f|\n", val);   // 输出: |    4.25| (右对齐，宽8)
    printf("|%-8.2f|\n", val);  // 输出: |4.25    | (左对齐，宽8)
    printf("|%08.2f|\n", val);  // 输出: |00004.25| (前置补 0，总宽 8)

    return 0;
}

2. 强制显示正负号与末尾 0

• std::showpos / %+f：正数前强制添加 + 号。
• std::showpoint：即使小数部分全为 0，也强制显示小数点。

#include <iostream>
#include <iomanip>
#include <cstdio>

int main() {
    double a = 5.0, b = -3.2;

    // std::cout 方式
    std::cout << std::fixed << std::setprecision(2) << std::showpos;
    std::cout << a << " " << b << std::endl; // 输出: +5.00 -3.20
    std::cout << std::noshowpos; // 关闭符号显示

    // printf 方式
    printf("%+.2f %+.2f\n", a, b);           // 输出: +5.00 -3.20

    return 0;
}

3. 科学计数法（Scientific Notation）

#include <iostream>
#include <iomanip>
#include <cstdio>

int main() {
    double num = 12345.6789;

    // cout
    std::cout << std::scientific << std::setprecision(3) << num << std::endl; 
    // 输出: 1.235e+04

    // printf (%e 科学计数法，%g 自动选择最短格式)
    printf("%.3e\n", num); // 输出: 1.235e+04
    printf("%.4g\n", num); // 输出: 1.235e+04 (有效位数达到后自动转换)

    return 0;
}

五、踩坑提醒与最佳实践

1. std::cout 的状态“粘性”（Sticky State）

• 注意：std::fixed、std::setprecision()、std::setfill() 等流操作符具有持久性，设置后会一直影响后续所有的输出，直到手动修改。
• 特例：std::setw(n) 是一次性的，仅对紧随其后的下一个输出有效。

2. 四舍五入与二进制浮点误差

printf 与 std::cout 在输出小数时均遵循舍入规则，但因计算机底层为 IEEE 754 二进制浮点数，部分十进制小数无法精确表示：

double x = 1.005;
// 1.005 在底层二进制实际存储为 1.0049999999999998934...
// 保留 2 位小数时，可能会向下舍入输出 1.00 而非 1.01
printf("%.2f\n", x); // 可能输出 1.00

解决方案：在涉及财务等强精度场景下，请采用整数（如以“分”为单位）或专用高精度定点数库。

3. C++11 中 std::to_string 的局限性

C++11 引入了 std::to_string(double)，但它无法指定小数位数，其行为等同于 sprintf(buf, "%f", val)，即固定输出 6 位小数：

std::string s = std::to_string(3.14); // 结果为 "3.140000"，无法传参指定位数

若需转为指定小数位的字符串，推荐使用 std::ostringstream：

#include <sstream>
#include <iomanip>
#include <string>

std::string formatDouble(double val, int precision) {
    std::ostringstream oss;
    oss << std::fixed << std::setprecision(precision) << val;
    return oss.str();
}

六、速查总结表

—— 本文来自火龙信奥（义乌睿码科技）：义乌青少年信息学奥赛与编程教育平台，专注 CSP-J/S、NOIP、GESP 竞赛培训，线上线下融合教学，助力编程升学。网址：hlcoding.com