浅尝boost之format

快来打我* 2022-04-10 01:22 226阅读 0赞

**概述   
  
     std::string是个很不错的东东，但实际使用时基本在每个程序里都会遇到不愉快的事情：格式化字符串。我甚至由于这个原因在代码里引入平台有关的MFC，ATL等本来不需要在项目中使用的一些重量级的框架，就为了能轻松的做格式化字符串 :-) 。曾尝试过将ATL::CString的format函数提取出来使用，但ATL::CString的底层调用了windows独有函数，无法跨越平台。当然，现在有了boost::format，我们不用再担心了。boost::format重载了'%'操作符，通过多次调用'%'操作符就能将参数非常方便格式化成字符串，并实现了ATL::CString和C\#中的string两者的格式化字符串功能。除了语法刚开始感觉到怪异，功能足以让人感觉到兴奋！ **

在字符串处理中少不了格式化字符串，C++中传统的格式化函数是C语言的sprintf，但它一个很大的问题就是不安全。因此，在stl中引入了stringstream来实现安全格式化，但是stringstream却远不如sprintf来得直观。例如，对如如下代码：

char text[]="hello";    
        bool is_all_lower = boost::algorithm::all(text, is_lower());
    
        char output[128];
        sprintf(output, "<%s> %s in the lower case", text, (is_all_lower? "is": "is not"));

如果把最后两句format的函数用stringstream来写的话，可读性是远不如sprintf的。

stringstream output;
        output << "<" << text << "> "
            << (is_all_lower)? "is": "is not") 
            << " in the lower case";

boost引入了一个提供类似.net中的string.format的方式提供格式化字符串的函数，用它来格式化的话就是如下形式：

boost::format fmt = boost::format("<%s> %s in the lower case") % text % (is_all_lower? "is": "is not");
        string output = fmt.str();

前面的例子中演示的是C风格的格式化字符串，boost.format也提供了类似.net风格的格式化字符串方式：

boost::format fmt = boost::format("<%1%> %2% in the lower case") % text % (is_all_lower? "is":"is not");
        cout << fmt << endl;

这种方式更容易看到参数在格式化字符串中的位置，推荐这种形式。不过它的起始坐标是1而不是0，用惯了.net的string.format的朋友需要注意下。

**一、boost::format工作的方式**   
    
 基本的语法，boost::format( format-string ) % arg1 % arg2 % ... % argN   
    
 下面的例子说明boost::format简单的工作方式

// 方式一 
     cout << boost::format("%s") % "输出内容" << endl; 
     
     // 方式二 
     std::string s; 
     s = str( boost::format("%s") % "输出内容" ); 
     cout << s << endl; 
     
     // 方式三 
     boost::format formater("%s"); 
     formater % "输出内容"; 
     std::string s = formater.str(); 
     cout << s << endl; 
     
     // 方式四 
     cout << boost::format("%1%") % boost::io::group(hex, showbase, 40) << endl;

**二、boost::format实际使用的实例**   
    
 格式化语法： \[ N$ \] \[ flags \] \[ width \] \[ . precision \] type-char

// ATL::CString风格 
     cout << boost::format("\n\n%s" 
     "%1t 十进制 = [%d]\n" 
     "%1t 格式化的十进制 = [%5d]\n" 
     "%1t 格式化十进制，前补'0' = [%05d]\n" 
     "%1t 十六进制 = [%x]\n" 
     "%1t 八进制 = [%o]\n" 
     "%1t 浮点 = [%f]\n" 
     "%1t 格式化的浮点 = [%3.3f]\n" 
     "%1t 科学计数 = [%e]\n" 
     ) % "example :\n" % 15 % 15 % 15 % 15 % 15 % 15.01 % 15.01 % 15.01 << endl; 
     
     // C#::string风格 
     cout << boost::format("%1%" 
     "%1t 十进制 = [%2$d]\n" 
     "%1t 格式化的十进制 = [%2$5d]\n" 
     "%1t 格式化十进制，前补'0' = [%2$05d]\n" 
     "%1t 十六进制 = [%2$x]\n" 
     "%1t 八进制 = [%2$o]\n" 
     "%1t 浮点 = [%3$f]\n" 
     "%1t 格式化的浮点 = [%3$3.3f]\n" 
     "%1t 科学计数 = [%3$e]\n" 
     ) % "example :\n" % 15 % 15.01 << endl;

![None.gif][]输出结果   
![ExpandedBlockStart.gif][]/\*   
![20181219133628124][]example :   
![20181219133628124][] 十进制 = \[15\]   
![20181219133628124][] 格式化的十进制 = \[ 15\]   
![20181219133628124][] 格式化十进制，前补'0' = \[00015\]   
![20181219133628124][] 十六进制 = \[f\]   
![20181219133628124][] 八进制 = \[17\]   
![20181219133628124][] 浮点 = \[15.010000\]   
![20181219133628124][] 格式化的浮点 = \[15.010\]   
![20181219133628124][] 科学计数 = \[1.501000e+001\]   
![20181219133628263][]\*/

**三、boost::format新的格式说明符**   
    
 %\{nt\}   
 当n是正数时，插入n个绝对制表符   
 cout << boost::format("\[%10t\]")  << endl;   
    
 %\{nTX\}   
 使用X做为填充字符代替当前流的填充字符（一般缺省是一个空格）   
 cout << boost::format("\[%10T\*\]")  << endl;

**四、异常处理**

一般写法：

try 
     { 
     cout << boost::format("%d%d") % 1 << endl; 
     } 
     catch(std::exception const & e) 
     { 
     cout << e.what() << endl; 
     
     // 输出内容： 
     // boost::too_few_args: format-string refered to more arguments than were passed 
     }

boost::format的文档中有选择处理异常的办法，不过个人感觉实用性可能不强，下面是文档中的例子

// boost::io::all_error_bits selects all errors 
     // boost::io::too_many_args_bit selects errors due to passing too many arguments. 
     // boost::io::too_few_args_bit selects errors due to asking for the srting result before all arguments are passed 
     
     boost::format my_fmt(const std::string & f_string) 
     { 
     using namespace boost::io; 
     format fmter(f_string); 
     fmter.exceptions( all_error_bits ^ ( too_many_args_bit | too_few_args_bit ) ); 
     return fmter; 
     } 
     cout << my_fmt(" %1% %2% \n") % 1 % 2 % 3 % 4 % 5;

**五、还有其它一些功能，但暂时感觉派不上用处，就不去深究了。**

[None.gif]: /images/20220404/085a33e44d714de8821cfbdfa3ec6749.png
[ExpandedBlockStart.gif]: /images/20220404/212fcf89c54d47b89661a823916c6778.png
[20181219133628124]: /images/20220404/91232587d42a4b5c9e56f6e3bfef05db.png
[20181219133628263]: /images/20220404/118bcc2c86404177b92652b8a2ff7ea7.png