C++ ios 库 - Pword
描述
它用于获取可扩展数组的指针元素，并返回对 void* 类型对象的引用，该对象对应于内部可扩展数组中的索引 idx。
如果 idx 是新元素的索引并且内部可扩展数组不够长（或尚未分配），则该函数将根据需要使用初始化为空指针的尽可能多的元素来扩展它（或分配它）。
保证返回的引用至少在流对象上执行另一个操作之前是有效的，包括对 pword 的另一个调用。一旦执行了另一个操作，引用可能会变得无效，尽管随后使用相同的 idx 参数调用相同的函数会返回对内部可扩展数组中相同值的引用。
内部可扩展数组是 long（如果使用成员 iword 访问）或 void*（如果使用成员 pword 访问）类型的通用对象数组。库可以以多种方式实现这个数组:iword 和 pword 可能共享也可能不共享一个唯一的数组，它们甚至可能不是数组，而是其他一些数据结构。
声明
以下是 ios_base::pword 函数的声明。
void*& pword (int idx);
参数
idx − 内部可扩展数组元素的索引值和一些实现期望 idx 是成员 xalloc 先前返回的值。
返回值
该值作为对 void* 类型对象的引用返回。
异常
Basic guarantee − 如果抛出异常，则流处于有效状态。
数据竞争
可以修改流对象。 返回的值也可以用来修改它。 对同一流对象的并发访问可能会导致数据竞争。
示例
在下面的示例中解释了 ios_base::pword 函数。
#include <iostream>
const int name_index = std::ios::xalloc();
void SetStreamName (std::ios& stream, const char* name) {
stream.pword(name_index) = const_cast<char*>(name);
}
std::ostream& StreamName (std::ostream& os) {
const char* name = static_cast<const char*>(os.pword(name_index));
if (name) os << name;
else os << "(unknown)";
return os;
}
int main() {
SetStreamName(std::cout, "standard output stream");
SetStreamName(std::cerr, "standard error stream");
std::cout << StreamName << '\n';
std::cerr << StreamName << '\n';
std::clog << StreamName << '\n';
return 0;
}
让我们编译并运行上面的程序，这将产生以下结果 −
standard output stream standard error stream (unknown)
