C++ 命名要求： UnformattedInputFunction

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名要求

功能测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用程序库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

C++ 命名要求

基本 DefaultConstructible MoveConstructible (C++11) CopyConstructible CopyAssignable MoveAssignable (C++11) Destructible 类型属性 ScalarType PODType TriviallyCopyable (C++11) TrivialType (C++11) StandardLayoutType (C++11)   ImplicitLifetimeType 库范围 BooleanTestable EqualityComparable LessThanComparable Swappable ValueSwappable (C++11) NullablePointer (C++11) Hash (C++11) Allocator FunctionObject Callable Predicate BinaryPredicate Compare

Container Container ReversibleContainer AllocatorAwareContainer SequenceContainer ContiguousContainer (C++17) AssociativeContainer UnorderedAssociativeContainer (C++11)   容器元素 DefaultInsertable (C++11) CopyInsertable (C++11) MoveInsertable (C++11) EmplaceConstructible (C++11) Erasable (C++11) Iterator LegacyIterator LegacyInputIterator LegacyOutputIterator LegacyForwardIterator LegacyBidirectionalIterator LegacyRandomAccessIterator LegacyContiguousIterator (C++17) ConstexprIterator (C++20) 流 I/O FormattedInputFunction UnformattedInputFunction FormattedOutputFunction UnformattedOutputFunction 格式化程序 BasicFormatter (C++20) Formatter (C++20)

随机数 SeedSequence (C++11) RandomNumberEngine (C++11) RandomNumberDistribution (C++11) UniformRandomBitGenerator (C++11) RandomNumberEngineAdaptor (C++11) 并发 BasicLockable (C++11) Lockable (C++11) TimedLockable (C++11) SharedLockable (C++14) SharedTimedLockable (C++14) Mutex (C++11) TimedMutex (C++11) SharedMutex (C++17) SharedTimedMutex (C++14) 范围 RangeAdaptorObject (C++20) RangeAdaptorClosureObject (C++20) 多维视图 LayoutMapping (C++23) LayoutMappingPolicy (C++23) AccessorPolicy (C++23) 其他 CharTraits RegexTraits (C++11)   BitmaskType LiteralType (C++11) NumericType UnaryTypeTrait (C++11) BinaryTypeTrait (C++11) TransformationTrait (C++11) Clock (C++11) TrivialClock (C++11)

 

要求

一个 UnformattedInputFunction 是一个流输入函数，它执行以下操作

1) 使用自动存储持续时间构造一个 basic_istream::sentry 类型的对象，并将 noskipws 参数设置为 true，这将执行以下操作

• 如果 eofbit 或 badbit 在输入流上设置，则也设置 failbit，如果在这个输入流的 异常掩码 ((exceptions() & failbit) != 0) 中启用了 failbit 上的异常，则抛出 ios_base::failure.
• 刷新与 tie() 绑定的输出流（如果适用）。

2) 通过调用 sentry::operator bool() 检查哨兵的状态，这等效于 basic_ios::good.

• 如果运算符返回 false 或哨兵的构造函数抛出异常

• 将输入流中提取的字符数 (gcount) 设置为零。
• 如果调用该函数是为了写入 CharT 数组，则将 CharT()（空字符）写入数组的第一个位置。

• 如果运算符返回 true，则执行输入，就好像通过调用 rdbuf()->sbumpc() 或 rdbuf()->sgetc() 一样。

• 如果达到流的末尾（对 rdbuf()->sbumpc() 或 rdbuf()->sgetc() 的调用返回 Traits::eof()），则设置 eofbit。如果在这个流的 异常掩码 ((exceptions() & eofbit) != 0) 中启用了 eofbit 上的异常，则抛出 ios_base::failure.
• 如果在输入期间抛出异常，则在输入流中设置 badbit。如果在这个流的 异常掩码 ((exceptions() & badbit) != 0) 中启用了 badbit 上的异常，则也会重新抛出该异常。

• 从 basic_ios::clear 抛出的异常不会被捕获或重新抛出。

• 如果在输入期间没有抛出异常，则设置输入流中提取的字符数 (gcount)。

3) 无论是通过异常终止还是返回，哨兵的析构函数都将在离开此函数之前被调用。

标准库

以下标准库函数是 UnformattedInputFunctions。

• std::getline，除了它不修改 gcount。
• basic_istream::operator>>(basic_streambuf*)
• basic_istream::get
• basic_istream::getline
• basic_istream::ignore
• basic_istream::peek
• basic_istream::read
• basic_istream::readsome
• basic_istream::putback，除了它首先清除 eofbit
• basic_istream::unget，除了它首先清除 eofbit
• basic_istream::sync，除了它不修改 gcount
• basic_istream::tellg，除了它不修改 gcount
• basic_istream::seekg，除了它首先清除 eofbit 且不修改 gcount
• std::ws，除了它不修改 gcount

缺陷报告

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

DR	应用于	已发布的行为	正确行为
LWG 61	C++98	不清楚由于 设置 eofbit 和/或 failbit 是否会导致设置 badbit	从 basic_ios::clear 抛出的异常 不会被捕获或重新抛出
LWG 160	C++98	确定是否重新抛出捕获的异常的过程 提到了一个不存在的函数 exception()	更正为 exceptions()
LWG 243	C++98	当 sentry::operator bool() 返回 false 或哨兵对象无法构造时，行为未指定	已指定