C++ IOS 库 - Pword

描述

它用于获取可扩展数组的指针元素，并返回对对应于内部可扩展数组中索引 idx 的 void* 类型对象的引用。

如果 idx 是新元素的索引，并且内部可扩展数组不够长（或尚未分配），则该函数会将其扩展（或分配）尽可能多的元素，这些元素初始化为空指针。

保证返回的引用至少在对流对象执行另一个操作之前有效，包括对 pword 的另一次调用。一旦执行了另一个操作，引用可能失效，尽管随后对该函数使用相同的 idx 参数的调用会返回对内部可扩展数组中相同值的引用。

内部可扩展数组是 long 类型对象（如果使用成员 iword 访问）或 void* 类型对象（如果使用成员 pword 访问）的通用数组。库可以用多种方式实现此数组：iword 和 pword 可能共享或不共享唯一的数组，甚至可能根本不是数组，而是其他一些数据结构。

声明

以下是 ios_base::pword 函数的声明。

void*& pword (int idx);

参数

idx − 内部可扩展数组的元素索引值，某些实现期望 idx 是成员 xalloc 之前返回的值。

返回值

此值作为对 void* 类型对象的引用返回。

异常

基本保证 − 如果抛出异常，则流处于有效状态。

数据竞争

可能会修改流对象。返回的值也可能用于修改它。对同一流对象的并发访问可能会导致数据竞争。

示例

下面的示例解释了 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)