ceph/src/boost/libs/iostreams/doc/concepts/localizable.html

   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="http://www.coderage.com/turkanis/" 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>