• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4    <TITLE>Localizable</TITLE>
5    <LINK REL="stylesheet" HREF="../../../../boost.css">
6    <LINK REL="stylesheet" HREF="../theme/iostreams.css">
7</HEAD>
8<BODY>
9
10<!-- Begin Banner -->
11
12    <H1 CLASS="title">Localizable</H1>
13    <HR CLASS="banner">
14
15<!-- End Banner -->
16
17<H2>Description</H2>
18
19<P>
20    A Localizable Filter or Device receives notifications when a stream or stream buffer which contains it has its  <CODE>std::locale</CODE> set using <CODE>std::basic_ios::imbue</CODE> or <CODE>std::basic_streambuf::pubimbue</CODE>.
21</P>
22
23<H2>Refinement of</H2>
24
25<A NAME="types"></A>
26<H2>Associated Types</H2>
27
28<H2>Notation</H2>
29
30<TABLE CELLPADDING="2">
31    <TR><TD><CODE>L</CODE></TD><TD>-</TD><TD>A type which is a model of Localizable</TD></TR>
32    <TR><TD><CODE>z</CODE></TD><TD>-</TD><TD>Object of type <CODE>L</CODE></TD></TR>
33    <TR><TD><CODE>loc</CODE></TD><TD>-</TD><TD>Object of type <CODE>std::locale</CODE></TD></TR>
34</TABLE>
35
36<H2>Valid Expressions / Semantics</H2>
37
38<TABLE CELLPADDING="5" BORDER="1">
39    <TR><TH>Expression</TH><TH>Expression Type</TH><TH>Postcondition</TH></TR>
40    <TR>
41        <TD>
42            <PRE CLASS="plain_code"><CODE><A HREF="../functions/imbue.html">boost::iostreams::imbue</A>(z, loc)</CODE></PRE>
43        </TD>
44        <TD><CODE>void</CODE></TD>
45        <TD><CODE>locale</CODE>-sensitive i/o performed by <CODE>z</CODE> uses a copy of <CODE>loc</CODE> until a subsequent invocation of <CODE>boost::iostreams::imbue</CODE></TD>
46    </TR>
47</TABLE>
48
49<H2>Exceptions</H2>
50
51<P>
52    Errors which occur during the execution of <A CLASS="code" HREF="../functions/imbue.html"><CODE>imbue</CODE></A> are be indicated by throwing exceptions.
53</P>
54
55<H2>Models</H2>
56<UL>
57    <LI>Standard streams and stream buffers.
58    <LI><A HREF="../classes/code_converter.html"><CODE>code_converter</CODE></A>
59</UL>
60
61<!-- Begin Footer -->
62
63<HR>
64
65<P CLASS="copyright">&copy; Copyright 2008 <a href="http://www.coderage.com/" target="_top">CodeRage, LLC</a><br/>&copy; Copyright 2004-2007 <a href="https://www.boost.org/users/people/jonathan_turkanis.html" target="_top">Jonathan Turkanis</a></P>
66<P CLASS="copyright">
67    Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at <A HREF="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</A>)
68</P>
69
70<!-- End Footer -->
71
72</BODY>