1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/os/ossrv/ossrv_pub/boost_apis/boost/iostreams/compose.hpp Fri Jun 15 03:10:57 2012 +0200
1.3 @@ -0,0 +1,368 @@
1.4 +// (C) Copyright Jonathan Turkanis 2005.
1.5 +// Distributed under the Boost Software License, Version 1.0. (See accompanying
1.6 +// file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt.)
1.7 +
1.8 +// See http://www.boost.org/libs/iostreams for documentation.
1.9 +
1.10 +// Note: bidirectional streams are not supported.
1.11 +
1.12 +#ifndef BOOST_IOSTREAMS_COMPOSE_HPP_INCLUDED
1.13 +#define BOOST_IOSTREAMS_COMPOSE_HPP_INCLUDED
1.14 +
1.15 +#if defined(_MSC_VER) && (_MSC_VER >= 1020)
1.16 +# pragma once
1.17 +#endif
1.18 +
1.19 +#include <algorithm> // min.
1.20 +#include <utility> // pair.
1.21 +#include <boost/config.hpp> // DEDUCED_TYPENAME.
1.22 +#include <boost/iostreams/categories.hpp>
1.23 +#include <boost/iostreams/detail/adapter/direct_adapter.hpp>
1.24 +#include <boost/iostreams/detail/call_traits.hpp>
1.25 +#include <boost/iostreams/detail/closer.hpp>
1.26 +#include <boost/iostreams/detail/enable_if_stream.hpp>
1.27 +#include <boost/iostreams/operations.hpp>
1.28 +#include <boost/iostreams/traits.hpp> // mode_of, is_direct.
1.29 +#include <boost/mpl/if.hpp>
1.30 +#include <boost/ref.hpp>
1.31 +#include <boost/static_assert.hpp>
1.32 +#include <boost/type_traits/is_convertible.hpp>
1.33 +
1.34 +namespace boost { namespace iostreams {
1.35 +
1.36 +namespace detail {
1.37 +
1.38 +template<typename Filter, typename Device>
1.39 +struct composite_mode {
1.40 + typedef typename mode_of<Filter>::type filter_mode;
1.41 + typedef typename mode_of<Device>::type device_mode;
1.42 + typedef is_convertible<filter_mode, dual_use> is_dual_use;
1.43 + typedef typename
1.44 + mpl::if_<
1.45 + is_convertible<device_mode, input>,
1.46 + input,
1.47 + output
1.48 + >::type type;
1.49 +};
1.50 +
1.51 +//
1.52 +// Template name: composite_device.
1.53 +// Description: Provides a Device view of a Filter, Device pair.
1.54 +// Template paramters:
1.55 +// Filter - A model of Filter.
1.56 +// Device - An indirect model of Device.
1.57 +//
1.58 +template< typename Filter,
1.59 + typename Device,
1.60 + typename Mode =
1.61 + BOOST_DEDUCED_TYPENAME composite_mode<Filter, Device>::type >
1.62 +class composite_device {
1.63 +private:
1.64 + typedef typename detail::param_type<Device>::type param_type;
1.65 + typedef typename
1.66 + iostreams::select< // Disambiguation for Tru64.
1.67 + is_direct<Device>, direct_adapter<Device>,
1.68 + is_std_io<Device>, Device&,
1.69 + else_, Device
1.70 + >::type value_type;
1.71 +public:
1.72 + typedef typename char_type_of<Filter>::type char_type;
1.73 + struct category
1.74 + : Mode,
1.75 + device_tag,
1.76 + closable_tag,
1.77 + flushable_tag,
1.78 + localizable_tag,
1.79 + optimally_buffered_tag
1.80 + { };
1.81 + composite_device(const Filter& flt, param_type dev);
1.82 + std::streamsize read(char_type* s, std::streamsize n);
1.83 + std::streamsize write(const char_type* s, std::streamsize n);
1.84 + stream_offset seek( stream_offset off, BOOST_IOS::seekdir way,
1.85 + BOOST_IOS::openmode which =
1.86 + BOOST_IOS::in | BOOST_IOS::out );
1.87 +
1.88 + void close();
1.89 + void close(BOOST_IOS::openmode which);
1.90 + bool flush();
1.91 + std::streamsize optimal_buffer_size() const;
1.92 +
1.93 + template<typename Locale> // Avoid dependency on <locale>
1.94 + void imbue(const Locale& loc)
1.95 + {
1.96 + iostreams::imbue(filter_, loc);
1.97 + iostreams::imbue(device_, loc);
1.98 + }
1.99 +
1.100 + Filter& first() { return filter_; }
1.101 + Device& second() { return device_; }
1.102 +private:
1.103 + Filter filter_;
1.104 + value_type device_;
1.105 +};
1.106 +
1.107 +//
1.108 +// Template name: composite_device.
1.109 +// Description: Provides a Device view of a Filter, Device pair.
1.110 +// Template paramters:
1.111 +// Filter - A model of Filter.
1.112 +// Device - An indirect model of Device.
1.113 +//
1.114 +template<typename Filter1, typename Filter2>
1.115 +class composite_filter {
1.116 +private:
1.117 + typedef reference_wrapper<Filter2> filter_ref;
1.118 +public:
1.119 + typedef typename char_type_of<Filter1>::type char_type;
1.120 + struct category
1.121 + : mode_of<Filter1>::type,
1.122 + filter_tag,
1.123 + multichar_tag,
1.124 + closable_tag,
1.125 + flushable_tag,
1.126 + localizable_tag,
1.127 + optimally_buffered_tag
1.128 + { };
1.129 + composite_filter(const Filter1& filter1, const Filter2& filter2)
1.130 + : filter1_(filter1), filter2_(filter2)
1.131 + { }
1.132 +
1.133 + template<typename Source>
1.134 + std::streamsize read(Source& src, char_type* s, std::streamsize n)
1.135 + {
1.136 + composite_device<filter_ref, Source> cmp(boost::ref(filter2_), src);
1.137 + return iostreams::read(filter1_, cmp, s, n);
1.138 + }
1.139 +
1.140 + template<typename Sink>
1.141 + std::streamsize write(Sink& snk, const char_type* s, std::streamsize n)
1.142 + {
1.143 + composite_device<filter_ref, Sink> cmp(boost::ref(filter2_), snk);
1.144 + return iostreams::write(filter1_, cmp, s, n);
1.145 + }
1.146 +
1.147 + template<typename Device>
1.148 + stream_offset seek( Device& dev, stream_offset off, BOOST_IOS::seekdir way,
1.149 + BOOST_IOS::openmode which =
1.150 + BOOST_IOS::in | BOOST_IOS::out )
1.151 + {
1.152 + composite_device<filter_ref, Device> cmp(boost::ref(filter2_), dev);
1.153 + return iostreams::seek(filter1_, cmp, off, way, which);
1.154 + }
1.155 +
1.156 + template<typename Device>
1.157 + void close( Device& dev,
1.158 + BOOST_IOS::openmode which =
1.159 + BOOST_IOS::in | BOOST_IOS::out )
1.160 + {
1.161 + composite_device<filter_ref, Device> cmp(boost::ref(filter2_), dev);
1.162 + iostreams::close(filter1_, cmp, which);
1.163 + }
1.164 +
1.165 + template<typename Device>
1.166 + bool flush(Device& dev)
1.167 + {
1.168 + composite_device<Filter2, Device> cmp(filter2_, dev);
1.169 + return iostreams::flush(filter1_, cmp);
1.170 + }
1.171 +
1.172 + std::streamsize optimal_buffer_size() const
1.173 + {
1.174 + std::streamsize first = iostreams::optimal_buffer_size(filter1_);
1.175 + std::streamsize second = iostreams::optimal_buffer_size(filter2_);
1.176 + return first < second ? second : first;
1.177 + }
1.178 +
1.179 + template<typename Locale> // Avoid dependency on <locale>
1.180 + void imbue(const Locale& loc)
1.181 + { // To do: consider using RAII.
1.182 + iostreams::imbue(filter1_, loc);
1.183 + iostreams::imbue(filter2_, loc);
1.184 + }
1.185 +
1.186 + Filter1& first() { return filter1_; }
1.187 + Filter2& second() { return filter2_; }
1.188 +private:
1.189 + Filter1 filter1_;
1.190 + Filter2 filter2_;
1.191 +};
1.192 +
1.193 +template<typename Filter, typename FilterOrDevice>
1.194 +struct composite_traits
1.195 + : mpl::if_<
1.196 + is_device<FilterOrDevice>,
1.197 + composite_device<Filter, FilterOrDevice>,
1.198 + composite_filter<Filter, FilterOrDevice>
1.199 + >
1.200 + { };
1.201 +
1.202 +} // End namespace detail.
1.203 +
1.204 +template<typename Filter, typename FilterOrDevice>
1.205 +struct composite : detail::composite_traits<Filter, FilterOrDevice>::type {
1.206 + typedef typename detail::param_type<FilterOrDevice>::type param_type;
1.207 + typedef typename detail::composite_traits<Filter, FilterOrDevice>::type base;
1.208 + composite(const Filter& flt, param_type dev)
1.209 + : base(flt, dev)
1.210 + { }
1.211 +};
1.212 +
1.213 +//--------------Implementation of compose-------------------------------------//
1.214 +
1.215 +// Note: The following workarounds are patterned after resolve.hpp. It has not
1.216 +// yet been confirmed that they are necessary.
1.217 +
1.218 +#ifndef BOOST_IOSTREAMS_BROKEN_OVERLOAD_RESOLUTION //-------------------------//
1.219 +# ifndef BOOST_IOSTREAMS_NO_STREAM_TEMPLATES //-------------------------------//
1.220 +
1.221 +template<typename Filter, typename FilterOrDevice>
1.222 +composite<Filter, FilterOrDevice>
1.223 +compose( const Filter& filter, const FilterOrDevice& fod
1.224 + BOOST_IOSTREAMS_DISABLE_IF_STREAM(FilterOrDevice) )
1.225 +{ return composite<Filter, FilterOrDevice>(filter, fod); }
1.226 +
1.227 +template<typename Filter, typename Ch, typename Tr>
1.228 +composite< Filter, std::basic_streambuf<Ch, Tr> >
1.229 +compose(const Filter& filter, std::basic_streambuf<Ch, Tr>& sb)
1.230 +{ return composite< Filter, std::basic_streambuf<Ch, Tr> >(filter, sb); }
1.231 +
1.232 +template<typename Filter, typename Ch, typename Tr>
1.233 +composite< Filter, std::basic_istream<Ch, Tr> >
1.234 +compose(const Filter& filter, std::basic_istream<Ch, Tr>& is)
1.235 +{ return composite< Filter, std::basic_istream<Ch, Tr> >(filter, is); }
1.236 +
1.237 +template<typename Filter, typename Ch, typename Tr>
1.238 +composite< Filter, std::basic_ostream<Ch, Tr> >
1.239 +compose(const Filter& filter, std::basic_ostream<Ch, Tr>& os)
1.240 +{ return composite< Filter, std::basic_ostream<Ch, Tr> >(filter, os); }
1.241 +
1.242 +template<typename Filter, typename Ch, typename Tr>
1.243 +composite< Filter, std::basic_iostream<Ch, Tr> >
1.244 +compose(const Filter& filter, std::basic_iostream<Ch, Tr>& io)
1.245 +{ return composite< Filter, std::basic_iostream<Ch, Tr> >(filter, io); }
1.246 +
1.247 +# else // # ifndef BOOST_IOSTREAMS_NO_STREAM_TEMPLATES //---------------------//
1.248 +
1.249 +template<typename Filter, typename FilterOrDevice>
1.250 +composite<Filter, FilterOrDevice>
1.251 +compose( const Filter& filter, const FilterOrDevice& fod
1.252 + BOOST_IOSTREAMS_DISABLE_IF_STREAM(FilterOrDevice) )
1.253 +{ return composite<Filter, FilterOrDevice>(filter, fod); }
1.254 +
1.255 +template<typename Filter>
1.256 +composite<Filter, std::streambuf>
1.257 +compose(const Filter& filter, std::streambuf& sb)
1.258 +{ return composite<Filter, std::streambuf>(filter, sb); }
1.259 +
1.260 +template<typename Filter>
1.261 +composite<Filter, std::istream>
1.262 +compose(const Filter& filter, std::istream& is)
1.263 +{ return composite<Filter, std::istream>(filter, is); }
1.264 +
1.265 +template<typename Filter>
1.266 +composite<Filter, std::ostream>
1.267 +compose(const Filter& filter, std::ostream& os)
1.268 +{ return composite<Filter, std::ostream>(filter, os); }
1.269 +
1.270 +template<typename Filter>
1.271 +composite<Filter, std::iostream>
1.272 +compose(const Filter& filter, std::iostream& io)
1.273 +{ return composite<Filter, std::iostream>(filter, io); }
1.274 +
1.275 +# endif // # ifndef BOOST_IOSTREAMS_NO_STREAM_TEMPLATES //--------------------//
1.276 +#else // #ifndef BOOST_IOSTREAMS_BROKEN_OVERLOAD_RESOLUTION //----------------//
1.277 +
1.278 +template<typename Filter, typename Stream>
1.279 +composite<Filter, Stream>
1.280 +compose(const Filter& flt, const Stream& strm, mpl::true_)
1.281 +{ // Bad overload resolution.
1.282 + return composite<Filter, Stream>(flt, const_cast<Stream&>(strm));
1.283 +}
1.284 +
1.285 +template<typename Filter, typename FilterOrDevice>
1.286 +composite<Filter, FilterOrDevice>
1.287 +compose(const Filter& flt, const FilterOrDevice& fod, mpl::false_)
1.288 +{ return composite<Filter, FilterOrDevice>(flt, fod); }
1.289 +
1.290 +template<typename Filter, typename FilterOrDevice>
1.291 +composite<Filter, FilterOrDevice>
1.292 +compose( const Filter& flt, const FilterOrDevice& fod
1.293 + BOOST_IOSTREAMS_DISABLE_IF_STREAM(T) )
1.294 +{ return compose(flt, fod, is_std_io<FilterOrDevice>()); }
1.295 +
1.296 +# if !BOOST_WORKAROUND(__BORLANDC__, < 0x600) && \
1.297 + !BOOST_WORKAROUND(BOOST_MSVC, <= 1300) && \
1.298 + !defined(__GNUC__) // ---------------------------------------------------//
1.299 +
1.300 +template<typename Filter, typename FilterOrDevice>
1.301 +composite<Filter, FilterOrDevice>
1.302 +compose (const Filter& filter, FilterOrDevice& fod)
1.303 +{ return composite<Filter, FilterOrDevice>(filter, fod); }
1.304 +
1.305 +# endif // Borland 5.x, VC6-7.0 or GCC 2.9x //--------------------------------//
1.306 +#endif // #ifndef BOOST_IOSTREAMS_BROKEN_OVERLOAD_RESOLUTION //---------------//
1.307 +
1.308 +//----------------------------------------------------------------------------//
1.309 +
1.310 +namespace detail {
1.311 +
1.312 +//--------------Implementation of composite_device---------------------------//
1.313 +
1.314 +template<typename Filter, typename Device, typename Mode>
1.315 +composite_device<Filter, Device, Mode>::composite_device
1.316 + (const Filter& flt, param_type dev)
1.317 + : filter_(flt), device_(dev)
1.318 + { }
1.319 +
1.320 +template<typename Filter, typename Device, typename Mode>
1.321 +inline std::streamsize composite_device<Filter, Device, Mode>::read
1.322 + (char_type* s, std::streamsize n)
1.323 +{ return iostreams::read(filter_, device_, s, n); }
1.324 +
1.325 +template<typename Filter, typename Device, typename Mode>
1.326 +inline std::streamsize composite_device<Filter, Device, Mode>::write
1.327 + (const char_type* s, std::streamsize n)
1.328 +{ return iostreams::write(filter_, device_, s, n); }
1.329 +
1.330 +template<typename Filter, typename Device, typename Mode>
1.331 +stream_offset composite_device<Filter, Device, Mode>::seek
1.332 + (stream_offset off, BOOST_IOS::seekdir way, BOOST_IOS::openmode which)
1.333 +{ return iostreams::seek(filter_, device_, off, way, which); }
1.334 +
1.335 +template<typename Filter, typename Device, typename Mode>
1.336 +void composite_device<Filter, Device, Mode>::close()
1.337 +{
1.338 + typedef typename mode_of<Device>::type device_mode;
1.339 + BOOST_IOS::openmode which =
1.340 + is_convertible<device_mode, input>() ?
1.341 + BOOST_IOS::in :
1.342 + BOOST_IOS::out;
1.343 + close(which);
1.344 +}
1.345 +
1.346 +template<typename Filter, typename Device, typename Mode>
1.347 +void composite_device<Filter, Device, Mode>::close(BOOST_IOS::openmode which)
1.348 +{
1.349 + bool nothrow = false;
1.350 + external_closer<value_type> close_device(device_, which, nothrow);
1.351 + external_closer<Filter, value_type> close_filter(filter_, device_, which, nothrow);
1.352 +}
1.353 +
1.354 +template<typename Filter, typename Device, typename Mode>
1.355 +bool composite_device<Filter, Device, Mode>::flush()
1.356 +{ // To do: consider using RAII.
1.357 + bool r1 = iostreams::flush(filter_, device_);
1.358 + bool r2 = iostreams::flush(device_);
1.359 + return r1 && r2;
1.360 +}
1.361 +
1.362 +template<typename Filter, typename Device, typename Mode>
1.363 +std::streamsize
1.364 +composite_device<Filter, Device, Mode>::optimal_buffer_size() const
1.365 +{ return iostreams::optimal_buffer_size(device_); }
1.366 +
1.367 +} // End namespace detail.
1.368 +
1.369 +} } // End namespaces iostreams, boost.
1.370 +
1.371 +#endif // #ifndef BOOST_IOSTREAMS_COMPOSE_HPP_INCLUDED