Namespaces
Variants
Views
Actions

Difference between revisions of "Template:cpp/numeric/random/engine/operator ltltgtgt"

From cppreference.com
(use new list syntax)
(added description of the textual representation of the state)
Line 25: Line 25:
 
If a textual representation is written using {{c|os << x}} and that representation is restored into the same or a different object {{tt|y}} of the same type using {{c|is >> y}}, then {{c|1=x==y}}.
 
If a textual representation is written using {{c|os << x}} and that representation is restored into the same or a different object {{tt|y}} of the same type using {{c|is >> y}}, then {{c|1=x==y}}.
  
−
{{todo|standard also defines what the textual representation consists of}}
+
The textual representation is written with {{c|os.''fmtflags''}} set to {{c|ios_base::dec}}|{{c|ios_base::left}} and the fill character set to the space character.  The textual representation of the engine's internal state is a set of decimal numbers separated by spaces.
  
 
===Parameters===
 
===Parameters===

Revision as of 19:59, 14 February 2013

 
C++
 
Numerics library
Common mathematical functions
Mathematical special functions (C++17)
Mathematical constants (C++20)
Basic linear algebra algorithms (C++26)
Floating-point environment (C++11)
Complex numbers
Numeric array (valarray)
Pseudo-random number generation
Factor operations
(C++17)
(C++17)
Interpolations
(C++20)
(C++20)
Saturation arithmetic
(C++26)
(C++26)
(C++26)
(C++26)
(C++26)

Generic numeric operations
Bit operations
(C++20)    
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++23)
(C++20)
 
Pseudo-random number generation
 

Template:ddcl list begin <tr class="t-dcl ">

<td >
template< class CharT, class Traits, class ResultType,

          ... >
std::basic_ostream<CharT,Traits>&
    operator<<( std::basic_ostream<CharT,Traits>& ost,

                const {{{1}}}<...>& e );
</td>

<td > (1) </td> <td > (since C++11) </td> </tr> <tr class="t-dcl ">

<td >
template< class CharT, class Traits, class ResultType,

          ... >
std::basic_istream<CharT,Traits>&
    operator>>( std::basic_istream<CharT,Traits>& ist,

                {{{1}}}<...>& e );
</td>

<td > (2) </td> <td > (since C++11) </td> </tr> Template:ddcl list end

1) Serializes the internal state of the pseudo-random number engine e as a sequence of decimal numbers separated by one or more spaces, and inserts it to the stream ost. The fill character and the formatting flags of the stream are ignored and unaffected.
2) Restores the internal state of the pseudo-random number engine e from the serialized representation, which was created by an earlier call to operator<< using a stream with the same imbued locale and the same CharT and Traits. If the input cannot be deserialized, e is left unchanged and failbit is raised on ist

If a textual representation is written using os << x and that representation is restored into the same or a different object y of the same type using is >> y, then x==y.

The textual representation is written with os.''fmtflags'' set to ios_base::dec|ios_base::left and the fill character set to the space character. The textual representation of the engine's internal state is a set of decimal numbers separated by spaces.

Contents

Parameters

ost - output stream to insert the data to
ist - input stream to extract the data from
e - pseudo-random number engine

Return value

1) ost
2) ist

Complexity

This section is incomplete

Exceptions

1) (none)
2) May throw std::ios::failure when setting failbit
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=Template:cpp/numeric/random/engine/operator_ltltgtgt&oldid=46034"