C++ ios 库 - Iword
描述
它用于获取可扩展数组的整数元素，并返回对 long 类型对象的引用，该对象对应于内部可扩展数组中的索引 idx。
如果 idx 是新元素的索引并且内部可扩展数组不够长（或尚未分配），则该函数使用尽可能多的零初始化元素对其进行扩展（或分配）。
保证返回的引用至少在流对象上执行另一个操作之前是有效的，包括对 iword 的另一个调用。一旦执行了另一个操作，引用可能会变得无效，尽管随后使用相同的 idx 参数调用相同的函数会返回对内部可扩展数组中相同值的引用。
内部可扩展数组是 long（如果使用成员 iword 访问）或 void*（如果使用成员 pword 访问）类型的通用对象数组。库可以以多种方式实现这个数组:iword 和 pword 可能共享也可能不共享一个唯一的数组，它们甚至可能不是数组，而是其他一些数据结构。
声明
以下是 ios_base::iword 函数的声明。
long& iword (int idx);
参数
idx − 内部可扩展数组元素的索引值。 一些实现期望 idx 是成员 xalloc 先前返回的值。
返回值
对内部可扩展数组中索引为 idx 的元素的引用。 该值作为对 long 类型对象的引用返回。否则返回初始化为 0L 的有效 long&，并且（如果流对象继承自 basic_ios）设置坏位状态标志。
异常
Basic guarantee − 如果抛出异常，则流处于有效状态。
数据竞争
可以修改流对象。 返回的值也可以用来修改它。对同一流对象的并发访问可能会导致数据竞争。
示例
在下面的例子中解释了 ios_base::iword 函数。
#include <iostream>
std::ostream& Counter (std::ostream& os) {
const static int index = os.xalloc();
return os << ++os.iword(index);
}
int main() {
std::cout << Counter << ": first line\n";
std::cout << Counter << ": second line\n";
std::cout << Counter << ": third line\n";
std::cerr << Counter << ": error line\n";
return 0;
}
让我们编译并运行上面的程序，这将产生以下结果 −
1: first line 2: second line 3: third line 1: error line
