index.html 4.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
  2. <html>
  3. <head>
  4. <meta http-equiv="Content-Language" content="en-us">
  5. <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
  6. <title>The Boost Format library</title>
  7. </head>
  8. <body bgcolor="#FFFFFF" text="#000000">
  9. <table border="1" bgcolor="#007F7F" cellpadding="2" summary="">
  10. <tr>
  11. <td bgcolor="#FFFFFF"><img src="../../boost.png" alt=
  12. "boost.png (6897 bytes)" width="277" height="86"></td>
  13. <td><a href="../../index.htm"><font face="Arial" color=
  14. "#FFFFFF"><big>Home</big></font></a></td>
  15. <td><a href="../libraries.htm"><font face="Arial" color=
  16. "#FFFFFF"><big>Libraries</big></font></a></td>
  17. <td><a href="http://www.boost.org/people/people.htm"><font face="Arial" color=
  18. "#FFFFFF"><big>People</big></font></a></td>
  19. <td><a href="http://www.boost.org/more/faq.htm"><font face="Arial" color=
  20. "#FFFFFF"><big>FAQ</big></font></a></td>
  21. <td><a href="../../more/index.htm"><font face="Arial" color=
  22. "#FFFFFF"><big>More</big></font></a></td>
  23. </tr>
  24. </table>
  25. <h1>Boost Format library</h1>
  26. <p>The format library provides a class for formatting arguments according
  27. to a format-string, as does printf, but with two major differences
  28. :<br></p>
  29. <ul>
  30. <li>format sends the arguments to an internal stream, and so is entirely
  31. type-safe and naturally supports all user-defined types.</li>
  32. <li>The ellipsis (...) can not be used correctly in the strongly typed
  33. context of format, and thus the function call with arbitrary arguments is
  34. replaced by successive calls to an <i>argument feeding</i>
  35. <b>operator%</b></li>
  36. </ul>
  37. <p><br>
  38. You can find more Details in :</p>
  39. <ul>
  40. <li><a href="doc/format.html">Documentation</a> (HTML).</li>
  41. <li>Headers
  42. <ul>
  43. <li><a href="../../boost/format.hpp">format.hpp</a> : user
  44. frontend.</li>
  45. <li><a href="../../boost/format/format_fwd.hpp">format_fwd.hpp</a> :
  46. user forward declarations.</li>
  47. <li><a href=
  48. "../../boost/format/format_class.hpp">format_class.hpp</a> : the
  49. class interface</li>
  50. <li><a href=
  51. "../../boost/format/format_implementation.hpp">format_implementation.hpp</a>:
  52. implementation of the member functions</li>
  53. <li><a href="../../boost/format/feed_args.hpp">feed_args.hpp</a> :
  54. argument feeding helper functions</li>
  55. <li><a href="../../boost/format/free_funcs.hpp">free_funcs.hpp</a> :
  56. free functions definitions</li>
  57. <li><a href="../../boost/format/parsing.hpp">parsing.hpp</a> : code
  58. for parsing format-strings</li>
  59. <li><a href="../../boost/format/group.hpp">group.hpp</a> : auxiliary
  60. struct used to group arguments and manipulators</li>
  61. <li><a href="../../boost/format/exceptions.hpp">exceptions.hpp</a> :
  62. exceptions used by the library</li>
  63. <li><a href="../../boost/format/internals.hpp">internals.hpp</a> :
  64. auxiliary structs stream_format_state and format_item</li>
  65. </ul>
  66. </li>
  67. <li>Sample programs
  68. <ul>
  69. <li>The program <a href=
  70. "./example/sample_formats.cpp">sample_formats.cpp</a> demonstrates
  71. simple uses of <b>format</b>.</li>
  72. <li><a href=
  73. "./example/sample_new_features.cpp">sample_new_features.cpp</a>
  74. illustrates the few formatting features that were added to printf's
  75. syntax such as simple positional directives, centered alignment, and
  76. 'tabulations'.</li>
  77. <li><a href="./example/sample_advanced.cpp">sample_advanced.cpp</a>
  78. demonstrates uses of advanced features, like reusing, and modifying,
  79. format objects, etc..</li>
  80. <li>And <a href=
  81. "./example/sample_userType.cpp">sample_userType.cpp</a> shows the
  82. behaviour of the <b>format</b> library on user-defined types.</li>
  83. </ul>
  84. </li>
  85. </ul>
  86. <hr>
  87. <p><a href="http://validator.w3.org/check?uri=referer"><img border="0" src=
  88. "../../doc/images/valid-html401.png" alt="Valid HTML 4.01 Transitional"
  89. height="31" width="88"></a></p>
  90. <p>Revised
  91. <!--webbot bot="Timestamp" s-type="EDITED" s-format="%d %B, %Y" startspan -->02 December, 2006<!--webbot bot="Timestamp" endspan i-checksum="38510" --></p>
  92. <p><i>Copyright &copy; 2003 Samuel Krempp</i></p>
  93. <p><i>Distributed under the Boost Software License, Version 1.0. (See
  94. accompanying file <a href="../../LICENSE_1_0.txt">LICENSE_1_0.txt</a> or
  95. copy at <a href=
  96. "http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</a>)</i></p>
  97. </body>
  98. </html>