C++ 命名需求： FormattedInputFunction

 

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)

 

需求

一个 FormattedInputFunction 是一个执行以下操作的流输入函数

• 构造一个类型为 basic_istream::sentry 的对象，具有自动存储持续时间，并且 noskipws 参数设置为 false，执行以下操作

• 如果 eofbit 或 badbit 在输入流上设置，也设置 failbit，并且如果此输入流的 异常掩码 ((exceptions() & failbit) != 0) 中启用了 failbit 上的异常，则抛出 ios_base::failure.
• 刷新绑定的输出流（如果适用）。
• 如果 ios_base::skipws 标志在此输入流上设置，则从输入流中提取并丢弃字符，直到以下之一变为真

• 输入流上的下一个可用字符不是空格字符，如当前在此输入流中注入的语言环境的 std::ctype 面通过测试。非空格字符不会被提取。
• 到达流的末尾，在这种情况下，将设置 failbit 和 eofbit，并且如果流打开以针对其中一个位进行异常，则抛出 ios_base::failure.

• 通过调用 sentry::operator bool() 检查哨兵的状态，这等效于 basic_ios::good.
• 如果哨兵返回 false 或哨兵的构造函数抛出异常，则不会进行输入。
• 如果哨兵返回 true，则执行输入，就好像通过调用 rdbuf()->sbumpc() 或 rdbuf()->sgetc() 一样。

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

• 无论如何，无论是通过异常终止还是返回，在离开此函数之前都会调用哨兵的析构函数。

标准库

以下标准库函数是 FormattedInputFunctions。

• basic_istream::operator>>(int, long, double, void*, bool)
• operator>>(std::basic_istream, char&)
• operator>>(std::basic_istream, char*)
• operator>>(std::basic_istream, std::bitset)
• operator>>(std::basic_istream, std::string)
• operator>>，当在 std::get_money 的返回值上调用时

缺陷报告

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

DR	应用于	已发布的行为	正确行为
LWG 160	C++98	确定是否捕获的异常 重新抛出的过程提到了一个不存在的函数 exception()	更正为 exceptions()