Line data Source code
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>
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
67 0 : template<class T> basic_format& operator%(T& x)
68 0 : { return io::detail::feed<CharT, Tr, Alloc, T&>(*this,x); }
69 : #endif
70 :
71 : template<class T>
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>
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 ** //
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
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
96 : 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>
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>
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(__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
|