imbue
The function template imbue
is invoked automatically by the Iostreams library when the std::locale
of a library stream or stream buffer is set using std::basic_ios::imbue
or std::basic_streambuf::pubimbue
. When the std::locale
of an instance of stream_buffer
or stream
is set, imbue
is invoked on the underlying Device; when the std::locale
of a filtering_streambuf
or filtering_stream
is set, imbue
is invoked on each Filter and Device in the underlying chain.
<boost/iostreams/detail/imbue.hpp>
<boost/iostreams/detail/operations.hpp>
namespace boost { namespace iostreams { template<typename T> void imbue(T& t, const std::locale& loc); } } // End namespace boost::io
T | - | A model of one of the Filter or Device concepts |
The semantics of imbue
for a Filter or Device type T
depends on its category as follows:
category_of<T>::type | semantics |
---|---|
Convertible to streambuf_tag |
calls t.pubimbue(loc) |
Convertible to localizable_tag but not to streambuf_tag |
calls t.imbue(loc) |
otherwise | no-op |
© Copyright 2008 CodeRage, LLC
© Copyright 2004-2007 Jonathan Turkanis
Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)