operator<<,>>(std::mersenne_twister_engine)

template< class CharT, class Traits >
friend std::basic_ostream<CharT,Traits>& 
    operator<<( std::basic_ostream<CharT,Traits>& ost, 
                const mersenne_twister_engine& e );

(1)

(since C++11)

template< class CharT, class Traits >
friend std::basic_istream<CharT,Traits>& 
    operator>>( std::basic_istream<CharT,Traits>& ist, 
                mersenne_twister_engine& e );

(2)

(since C++11)

1) Сериализует внутреннее состояние генератора псевдослучайных чисел e в виде последовательности десятичных чисел, разделённых одним или несколькими пробелами, и вставляет его в поток ost. Символ заполнения и флаги форматирования потока игнорируются и не изменяются.

2) Восстанавливает внутреннее состояние генератора псевдослучайных чисел e из сериализованного представления, созданного ранее вызовом operator<< с помощью потока с тем же локализованным окружением и теми же CharT и Traits. Если вход не может быть десериализован, e остаётся неизменным, а failbit генерируется в ist.

Эти шаблоны функций не видны для обычного неквалифицированного или квалифицированного поиска и могут быть найдены только с помощью поиска с учётом аргументов, когда std::mersenne_twister_engine<UIntType,w,n,m,r,a,u,d,s,b,t,c,l,f> является ассоциированным классом аргументов.

Если текстовое представление записывается с использованием os << x и это представление восстанавливается в тот же или другой объект y того же типа с использованием is >> y, то x == y.

Текстовое представление записывается с os.fmtflags установленным в ios_base::dec|ios_base::left и символом заполнения, установленным в пробел. Текстовое представление внутреннего состояния генератора — это набор десятичных чисел, разделённых пробелами.

Параметры

ost	-	выходной поток для вставки данных
ist	-	входной поток для извлечения данных
e	-	генератор псевдослучайных чисел

Возвращаемое значение

1) ost

2) ist

Сложность

Исключения

1) Может выбросить исключение, определяемое реализацией.

2) Может выбросить std::ios_base::failure при установке failbit.

Отчёты о дефектах

Следующие отчёты о дефектах, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

DR	Применимо к	Поведение, как опубликовано	Правильное поведение
LWG 3519	C++11	форма операторов вставки и извлечения была не определена	определена как скрытые друзья

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/numeric/random/mersenne_twister_engine/operator_ltltgtgt