命名空间
变体
操作

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

来自 cppreference.com

[编辑模板]
 
C++
 
数值库
常见数学函数
数学特殊函数 (C++17)
数学常数 (C++20)
基本线性代数算法 (C++26)
浮点环境 (C++11)
复数
数值数组 (valarray)
伪随机数生成
因子运算
(C++17)
(C++17)
插值
(C++20)
(C++20)
饱和运算
(C++26)
(C++26)
(C++26)
(C++26)
(C++26)

通用数值运算
位运算
(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)
 
伪随机数生成
 
std::subtract_with_carry_engine
 
template< class CharT, class Traits >

friend std::basic_ostream<CharT, Traits>&
    operator<<( std::basic_ostream<CharT, Traits>& os,

                const subtract_with_carry_engine& e );
 (1) (自 C++11)
template< class CharT, class Traits >

friend std::basic_istream<CharT, Traits>&
    operator>>( std::basic_istream<CharT, Traits>& is,

                subtract_with_carry_engine& e );
 (2) (自 C++11)
1) 将 e 的当前状态的文本表示形式写入 os，fmtflags 设置为 std::ios_base::dec | std::ios_base::left，填充字符设置为空格字符。
写入后，将恢复 os 的原始 fmtflags 和填充字符。
2) 从 is 中读取引擎状态的文本表示形式（表示为 text），fmtflags 设置为 std::ios_base::dec，并将 e 的状态设置为该状态。
读取后，将恢复 is 的原始 fmtflags。
  • 如果 text 以前没有使用输出流 pr 写入，则行为未定义。
  • 否则，如果以下任何值是 false，则行为未定义
  • is.getloc() == pr.getloc()
  • std::is_same<decltype(is)::char_type,
                 decltype(pr)::char_type>::value
  • std::is_same<decltype(is)::traits_type,
                 decltype(pr)::traits_type>::value
  • 否则，如果 text 不是 decltype(e) 的任何状态的有效文本表示形式，则 e 的状态保持不变，并调用 is.setstate(std::ios_base::failbit)。
  • 否则，给定另一个与 e 类型相同的引擎 eng。如果 text 以前由 pr << eng 写入，并且在 pr << eng 和 is >> e 之间没有对 e 或 eng 的中间调用，则 e == eng 为 true。

这些函数模板对普通的 非限定 或 限定查找 不可见，只能通过 参数相关查找 找到，当 decltype(e) 是参数的关联类时。

内容

[编辑] 参数

os - 要插入数据的输出流
is - 要从中提取数据的输入流
e - 伪随机数引擎

[编辑] 返回值

1) os
2) is

[编辑] 复杂度

1,2) O(r).

[编辑] 异常

2) 可能会抛出 std::ios_base::failure 当设置 std::ios_base::failbit.

缺陷报告

以下行为更改的缺陷报告已追溯应用于之前发布的 C++ 标准。

DR 应用于 发布的行为 正确的行为
LWG 3519 C++11 插入和提取运算符的形式未指定 指定为隐藏的友元
检索自 "https://cppreference.cn/mwiki/index.php?title=cpp/numeric/random/subtract_with_carry_engine/operator_ltltgtgt&oldid=132147"