1 // ---------------------------------------------------------------------------- 2 // format_class.hpp : class interface 3 // ---------------------------------------------------------------------------- 4 5 // Copyright Samuel Krempp 2003. Use, modification, and distribution are 6 // subject to the Boost Software License, Version 1.0. (See accompanying 7 // file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) 8 9 // See http://www.boost.org/libs/format for library home page 10 11 // ---------------------------------------------------------------------------- 12 13 #ifndef BOOST_FORMAT_CLASS_HPP 14 #define BOOST_FORMAT_CLASS_HPP 15 16 17 #include <vector> 18 #include <string> 19 20 #include <boost/optional.hpp> // to store locale when needed 21 22 #include <boost/format/format_fwd.hpp> 23 #include <boost/format/internals_fwd.hpp> 24 #include <boost/format/internals.hpp> 25 #include <boost/format/alt_sstream.hpp> 26 27 namespace boost { 28 29 template<class Ch, class Tr, class Alloc> 30 class basic_format 31 { 32 typedef typename io::CompatTraits<Tr>::compatible_type compat_traits; 33 public: 34 typedef Ch CharT; // borland fails in operator% if we use Ch and Tr directly 35 typedef std::basic_string<Ch, Tr, Alloc> string_type; 36 typedef typename string_type::size_type size_type; 37 typedef io::detail::format_item<Ch, Tr, Alloc> format_item_t; 38 typedef io::basic_altstringbuf<Ch, Tr, Alloc> internal_streambuf_t; 39 40 41 explicit basic_format(const Ch* str=NULL); 42 explicit basic_format(const string_type& s); 43 basic_format(const basic_format& x); 44 basic_format& operator= (const basic_format& x); 45 void swap(basic_format& x); 46 47 #if !defined(BOOST_NO_STD_LOCALE) 48 explicit basic_format(const Ch* str, const std::locale & loc); 49 explicit basic_format(const string_type& s, const std::locale & loc); 50 #endif 51 io::detail::locale_t getloc() const; 52 53 basic_format& clear(); // empty all converted string buffers (except bound items) 54 basic_format& clear_binds(); // unbind all bound items, and call clear() 55 basic_format& parse(const string_type&); // resets buffers and parse a new format string 56 57 // ** formatted result ** // 58 size_type size() const; // sum of the current string pieces sizes 59 string_type str() const; // final string 60 61 // ** arguments passing ** // 62 template<class T> operator %(const T & x)63 basic_format& operator%(const T& x) 64 { return io::detail::feed<CharT, Tr, Alloc, const T&>(*this,x); } 65 66 #ifndef BOOST_NO_OVERLOAD_FOR_NON_CONST operator %(T & x)67 template<class T> basic_format& operator%(T& x) 68 { return io::detail::feed<CharT, Tr, Alloc, T&>(*this,x); } 69 #endif 70 71 template<class T> operator %(volatile const T & x)72 basic_format& operator%(volatile const T& x) 73 { /* make a non-volatile copy */ const T v(x); 74 /* pass the copy along */ return io::detail::feed<CharT, Tr, Alloc, const T&>(*this, v); } 75 76 #ifndef BOOST_NO_OVERLOAD_FOR_NON_CONST 77 template<class T> operator %(volatile T & x)78 basic_format& operator%(volatile T& x) 79 { /* make a non-volatile copy */ T v(x); 80 /* pass the copy along */ return io::detail::feed<CharT, Tr, Alloc, T&>(*this, v); } 81 #endif 82 83 #if defined(__GNUC__) 84 // GCC can't handle anonymous enums without some help 85 // ** arguments passing ** // operator %(const int & x)86 basic_format& operator%(const int& x) 87 { return io::detail::feed<CharT, Tr, Alloc, const int&>(*this,x); } 88 89 #ifndef BOOST_NO_OVERLOAD_FOR_NON_CONST operator %(int & x)90 basic_format& operator%(int& x) 91 { return io::detail::feed<CharT, Tr, Alloc, int&>(*this,x); } 92 #endif 93 #endif 94 95 // The total number of arguments expected to be passed to the format objectt expected_args() const96 int expected_args() const 97 { return num_args_; } 98 // The number of arguments currently bound (see bind_arg(..) ) 99 int bound_args() const; 100 // The number of arguments currently fed to the format object 101 int fed_args() const; 102 // The index (1-based) of the current argument (i.e. next to be formatted) 103 int cur_arg() const; 104 // The number of arguments still required to be fed 105 int remaining_args() const; // same as expected_args() - bound_args() - fed_args() 106 107 108 // ** object modifying **// 109 template<class T> bind_arg(int argN,const T & val)110 basic_format& bind_arg(int argN, const T& val) 111 { return io::detail::bind_arg_body(*this, argN, val); } 112 basic_format& clear_bind(int argN); 113 template<class T> modify_item(int itemN,T manipulator)114 basic_format& modify_item(int itemN, T manipulator) 115 { return io::detail::modify_item_body<Ch,Tr, Alloc, T> (*this, itemN, manipulator);} 116 117 // Choosing which errors will throw exceptions : 118 unsigned char exceptions() const; 119 unsigned char exceptions(unsigned char newexcept); 120 121 #if !defined( BOOST_NO_MEMBER_TEMPLATE_FRIENDS ) \ 122 && !BOOST_WORKAROUND(BOOST_BORLANDC, <= 0x570) \ 123 && !BOOST_WORKAROUND( _CRAYC, != 0) \ 124 && !BOOST_WORKAROUND(__DECCXX_VER, BOOST_TESTED_AT(60590042)) 125 // use friend templates and private members only if supported 126 127 #ifndef BOOST_NO_TEMPLATE_STD_STREAM 128 template<class Ch2, class Tr2, class Alloc2> 129 friend std::basic_ostream<Ch2, Tr2> & 130 operator<<( std::basic_ostream<Ch2, Tr2> & , 131 const basic_format<Ch2, Tr2, Alloc2>& ); 132 #else 133 template<class Ch2, class Tr2, class Alloc2> 134 friend std::ostream & 135 operator<<( std::ostream & , 136 const basic_format<Ch2, Tr2, Alloc2>& ); 137 #endif 138 139 template<class Ch2, class Tr2, class Alloc2, class T> 140 friend basic_format<Ch2, Tr2, Alloc2>& 141 io::detail::feed_impl (basic_format<Ch2, Tr2, Alloc2>&, T); 142 143 template<class Ch2, class Tr2, class Alloc2, class T> friend 144 void io::detail::distribute (basic_format<Ch2, Tr2, Alloc2>&, T); 145 146 template<class Ch2, class Tr2, class Alloc2, class T> friend 147 basic_format<Ch2, Tr2, Alloc2>& 148 io::detail::modify_item_body (basic_format<Ch2, Tr2, Alloc2>&, int, T); 149 150 template<class Ch2, class Tr2, class Alloc2, class T> friend 151 basic_format<Ch2, Tr2, Alloc2>& 152 io::detail::bind_arg_body (basic_format<Ch2, Tr2, Alloc2>&, int, const T&); 153 154 private: 155 #endif 156 typedef io::detail::stream_format_state<Ch, Tr> stream_format_state; 157 // flag bits, used for style_ 158 enum style_values { ordered = 1, // set only if all directives are positional 159 special_needs = 4 }; 160 161 void make_or_reuse_data(std::size_t nbitems);// used for (re-)initialisation 162 163 // member data --------------------------------------------// 164 std::vector<format_item_t> items_; // each '%..' directive leads to a format_item 165 std::vector<bool> bound_; // stores which arguments were bound. size() == 0 || num_args 166 167 int style_; // style of format-string : positional or not, etc 168 int cur_arg_; // keep track of wich argument is current 169 int num_args_; // number of expected arguments 170 mutable bool dumped_; // true only after call to str() or << 171 string_type prefix_; // piece of string to insert before first item 172 unsigned char exceptions_; 173 internal_streambuf_t buf_; // the internal stream buffer. 174 boost::optional<io::detail::locale_t> loc_; 175 }; // class basic_format 176 177 } // namespace boost 178 179 180 #endif // BOOST_FORMAT_CLASS_HPP 181