• 5.6. 格式化输出库 Boost.Format

    5.6. 格式化输出库 Boost.Format

    Boost.Format 库可以作为定义在文件 cstdio 中的函数 std::printf() 的替代。 std::printf() 函数最初出现在 C 标准中,提供格式化数据输出功能, 但是它既不是类型安全的有不能扩展。 因此在 C++ 应用中, Boost.Format 库通常是数据格式化输出的上佳之选。

    Boost.Format 库在文件 boost/format.hpp 中定义了类 boost::format 。 与函数 std::printf 相似的是,传递给() boost::format 的构造函数的参数也是一个字符串,它由控制格式的特殊字符组成。 实际数据通过操作符 % 相连,在输出中替代特殊字符,如下例所示。

    1. #include <boost/format.hpp>
    2. #include <iostream>
    3.  
    4. int main()
    5. {
    6. std::cout << boost::format("%1%.%2%.%3%") % 16 % 9 % 2008 << std::endl;
    7. }
    • 下载源代码

    Boost.Format 类使用置于两个百分号之间的数字作为占位符,占位符稍后通过 % 操作符与实际数据连接。 以上程序使用数字16、9 和 2009 组成一个日期字符串,以 16.9.2008的格式输出。 如果要月份出现在日期之前,即美式表示,只需交换占位符即可。

    1. #include <boost/format.hpp>
    2. #include <iostream>
    3.  
    4. int main()
    5. {
    6. std::cout << boost::format("%2%/%1%/%3%") % 16 % 9 % 2008 << std::endl;
    7. }
    • 下载源代码

    现在程序显示的结果变成 9/16/2008

    如果要使用C++ 操作器格式化数据,Boost.Format 库提供了函数 boost::io::group()

    1. #include <boost/format.hpp>
    2. #include <iostream>
    3.  
    4. int main()
    5. {
    6. std::cout << boost::format("%1% %2% %1%") % boost::io::group(std::showpos, 99) % 100 << std::endl;
    7. }
    • 下载源代码

    本例的结果显示为 +99 100 +99 。 因为操作器 std::showpos() 通过 boost::io::group() 与数字 99 连接,所以只要显示 99 , 在它前面就会自动加上加号。

    如果需要加号仅在 99 第一次输出时显示, 则需要改造格式化占位符。

    1. #include <boost/format.hpp>
    2. #include <iostream>
    3.  
    4. int main()
    5. {
    6. std::cout << boost::format("%|1$+| %2% %1%") % 99 % 100 << std::endl;
    7. }

    为了将输出格式改为 +99 100 99 ,不但需要将数据的引用符号由 1$ 变为 1% ,还需要在其两侧各添加一个附加的管道符号,即将占位符 %1% 替换为 %|1$+|。

    请注意,虽然一般对数据的引用不是必须的,但是所有占位符一定要同时设置为指定货非指定。 以下例子在执行时会出现错误,因为它给第二个和第三个占位符设置了引用但是却忽略了第一个。

    1. #include <boost/format.hpp>
    2. #include <iostream>
    3.  
    4. int main()
    5. {
    6. try
    7. {
    8. std::cout << boost::format("%|+| %2% %1%") % 99 % 100 << std::endl;
    9. }
    10. catch (boost::io::format_error &ex)
    11. {
    12. std::cout << ex.what() << std::endl;
    13. }
    14. }
    • 下载源代码

    此程序抛出了类型为 boost::io::format_error 的异常。 严格地说,Boost.Format 库抛出的异常为 boost::io::bad_format_string。 但是由于所有的异常类都继承自 boost::io::format_error 类,捕捉此类型的异常会轻松一些。

    以下例子演示了不引用数据的方法。

    1. #include <boost/format.hpp>
    2. #include <iostream>
    3.  
    4. int main()
    5. {
    6. std::cout << boost::format("%|+| %|| %||") % 99 % 100 % 99 << std::endl;
    7. }
    • 下载源代码

    第二、第三个占位符的管道符号可以被安全地省略,因为在这种情况下,他们并不指定格式。这样的语法看起来很像 std::printf ()的那种。

    1. #include <boost/format.hpp>
    2. #include <iostream>
    3.  
    4. int main()
    5. {
    6. std::cout << boost::format("%+d %d %d") % 99 % 100 % 99 << std::endl;
    7. }
    • 下载源代码

    虽然这看起来就像 std::printf() ,但是 Boost.Format 库有类型安全的优点。 格式化字符串中字母 'd' 的使用并不表示输出数字,而是表示 boost::format 类所使用的内部流对象上的 std::dec() 操作器,它可以使用某些对 std::printf() 函数无意义的格式字符串,如果使用 std::printf() 会导致程序在运行时崩溃。

    1. #include <boost/format.hpp>
    2. #include <iostream>
    3.  
    4. int main()
    5. {
    6. std::cout << boost::format("%+s %s %s") % 99 % 100 % 99 << std::endl;
    7. }
    • 下载源代码

    尽管在 std::printf() 函数中,字母 's' 只用于表示类型为 const char* 的字符串,然而以上程序却能正常运行。 因为在 Boost.Format 库中,这并不代表强制为字符串,它会结合适当的操作器,调整内部流的操作模式。 所以即使在这种情况下, 在内部流中加入数字也是没问题的。