| 1 | <html> |
|---|
| 2 | <head> |
|---|
| 3 | <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
|---|
| 4 | <title>Function template operator>></title> |
|---|
| 5 | <link rel="stylesheet" href="boostbook.css" type="text/css"> |
|---|
| 6 | <meta name="generator" content="DocBook XSL Stylesheets V1.68.1"> |
|---|
| 7 | <link rel="start" href="index.html" title="The Boost C++ Libraries"> |
|---|
| 8 | <link rel="up" href="tribool/reference.html#id1288744" title="Header <boost/logic/tribool_io.hpp>"> |
|---|
| 9 | <link rel="prev" href="id765833.html" title="Function template operator<<"> |
|---|
| 10 | <link rel="next" href="tribool/tests.html" title="Testsuite"> |
|---|
| 11 | </head> |
|---|
| 12 | <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> |
|---|
| 13 | <table cellpadding="2" width="100%"> |
|---|
| 14 | <td valign="top"><img alt="boost.png (6897 bytes)" width="277" height="86" src="../../boost.png"></td> |
|---|
| 15 | <td align="center"><a href="../../index.htm">Home</a></td> |
|---|
| 16 | <td align="center"><a href="../../libs/libraries.htm">Libraries</a></td> |
|---|
| 17 | <td align="center"><a href="../../people/people.htm">People</a></td> |
|---|
| 18 | <td align="center"><a href="../../more/faq.htm">FAQ</a></td> |
|---|
| 19 | <td align="center"><a href="../../more/index.htm">More</a></td> |
|---|
| 20 | </table> |
|---|
| 21 | <hr> |
|---|
| 22 | <div class="spirit-nav"> |
|---|
| 23 | <a accesskey="p" href="id765833.html"><img src="images/prev.png" alt="Prev"></a><a accesskey="u" href="tribool/reference.html#id1288744"><img src="images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="images/home.png" alt="Home"></a><a accesskey="n" href="tribool/tests.html"><img src="images/next.png" alt="Next"></a> |
|---|
| 24 | </div> |
|---|
| 25 | <div class="refentry" lang="en"> |
|---|
| 26 | <a name="id1111217"></a><div class="titlepage"></div> |
|---|
| 27 | <div class="refnamediv"> |
|---|
| 28 | <h2><span class="refentrytitle">Function template operator>></span></h2> |
|---|
| 29 | <p>boost::logic::operator>> — Reads a tribool value from a stream. </p> |
|---|
| 30 | </div> |
|---|
| 31 | <h2 xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv-title">Synopsis</h2> |
|---|
| 32 | <div xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="refsynopsisdiv"><pre class="synopsis"> |
|---|
| 33 | <span class="bold"><strong>template</strong></span><<span class="bold"><strong>typename</strong></span> CharT, <span class="bold"><strong>typename</strong></span> Traits> |
|---|
| 34 | <span class="type">std::basic_istream< CharT, Traits > &</span> |
|---|
| 35 | <span class="bold"><strong>operator</strong></span>>>(std::basic_istream< CharT, Traits > & in, <a href="boost/logic/tribool.html" title="Class tribool">tribool</a> & x);</pre></div> |
|---|
| 36 | <div class="refsect1" lang="en"> |
|---|
| 37 | <a name="id1565922"></a><h2>Description</h2> |
|---|
| 38 | <p>When <code class="computeroutput">(out.flags() & std::ios_base::boolalpha) == 0</code> , this function reads a <code class="computeroutput">long</code> value from the input stream <code class="computeroutput">in</code> and converts that value to a tribool. If that value is 0, <code class="computeroutput">x</code> becomes <code class="computeroutput">false</code> ; if it is 1, <code class="computeroutput">x</code> becomes <code class="computeroutput">true</code> ; if it is 2, <code class="computeroutput">becomes</code><code class="computeroutput">indetermine</code> ; otherwise, the operation fails (and the fail bit is set on the input stream <code class="computeroutput">in</code> ).</p> |
|---|
| 39 | <p>When <code class="computeroutput">(out.flags() & std::ios_base::boolalpha) != 0</code> , this function first determines the names of the false, true, and indeterminate values. The false and true names are extracted from the <code class="computeroutput">std::numpunct</code> facet of the input stream's locale (if the C++ standard library implementation supports locales), or from the <code class="computeroutput">default_false_name</code> and <code class="computeroutput">default_true_name</code> functions (if there is no locale support). The indeterminate name is extracted from the appropriate <code class="computeroutput">indeterminate_name</code> facet (if it is available in the input stream's locale), or from the <code class="computeroutput">get_default_indeterminate_name</code> function (if the C++ standard library implementation does not support locales, or the <code class="computeroutput">indeterminate_name</code> facet is not specified for this locale object). The input is then matched to each of these names, and the tribool <code class="computeroutput">x</code> is assigned the value corresponding to the longest name that matched. If no name is matched or all names are empty, the operation fails (and the fail bit is set on the input stream <code class="computeroutput">in</code> ).</p> |
|---|
| 40 | <p></p> |
|---|
| 41 | <p><b xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision"><span class="term">Returns</span></b>: |
|---|
| 42 | |
|---|
| 43 | <code class="computeroutput">in</code></p> |
|---|
| 44 | </div> |
|---|
| 45 | </div> |
|---|
| 46 | <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr> |
|---|
| 47 | <td align="left"></td> |
|---|
| 48 | <td align="right"><small>Copyright © 2002-2004 Douglas Gregor</small></td> |
|---|
| 49 | </tr></table> |
|---|
| 50 | <hr> |
|---|
| 51 | <div class="spirit-nav"> |
|---|
| 52 | <a accesskey="p" href="id765833.html"><img src="images/prev.png" alt="Prev"></a><a accesskey="u" href="tribool/reference.html#id1288744"><img src="images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="images/home.png" alt="Home"></a><a accesskey="n" href="tribool/tests.html"><img src="images/next.png" alt="Next"></a> |
|---|
| 53 | </div> |
|---|
| 54 | </body> |
|---|
| 55 | </html> |
|---|
