localizable.html 2.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172
  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. <!-- Begin Banner -->
  10. <H1 CLASS="title">Localizable</H1>
  11. <HR CLASS="banner">
  12. <!-- End Banner -->
  13. <H2>Description</H2>
  14. <P>
  15. 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>.
  16. </P>
  17. <H2>Refinement of</H2>
  18. <A NAME="types"></A>
  19. <H2>Associated Types</H2>
  20. <H2>Notation</H2>
  21. <TABLE CELLPADDING="2">
  22. <TR><TD><CODE>L</CODE></TD><TD>-</TD><TD>A type which is a model of Localizable</TD></TR>
  23. <TR><TD><CODE>z</CODE></TD><TD>-</TD><TD>Object of type <CODE>L</CODE></TD></TR>
  24. <TR><TD><CODE>loc</CODE></TD><TD>-</TD><TD>Object of type <CODE>std::locale</CODE></TD></TR>
  25. </TABLE>
  26. <H2>Valid Expressions / Semantics</H2>
  27. <TABLE CELLPADDING="5" BORDER="1">
  28. <TR><TH>Expression</TH><TH>Expression Type</TH><TH>Postcondition</TH></TR>
  29. <TR>
  30. <TD>
  31. <PRE CLASS="plain_code"><CODE><A HREF="../functions/imbue.html">boost::iostreams::imbue</A>(z, loc)</CODE></PRE>
  32. </TD>
  33. <TD><CODE>void</CODE></TD>
  34. <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>
  35. </TR>
  36. </TABLE>
  37. <H2>Exceptions</H2>
  38. <P>
  39. Errors which occur during the execution of <A CLASS="code" HREF="../functions/imbue.html"><CODE>imbue</CODE></A> are be indicated by throwing exceptions.
  40. </P>
  41. <H2>Models</H2>
  42. <UL>
  43. <LI>Standard streams and stream buffers.
  44. <LI><A HREF="../classes/code_converter.html"><CODE>code_converter</CODE></A>
  45. </UL>
  46. <!-- Begin Footer -->
  47. <HR>
  48. <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>
  49. <P CLASS="copyright">
  50. 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>)
  51. </P>
  52. <!-- End Footer -->
  53. </BODY>