std::ios_base::iword

来自cppreference.com
< cpp‎ | io‎ | ios base

long& iword( int index );
首先,分配或调整大小的的私人存储(long的动态数组或其他可转位数据结构)足以使index一个有效的索引,然后返回一个引用的私有存储与索引longindex元素.
原文:
First, allocates or resizes the private storage (dynamic array of long or another indexable data structure) sufficiently to make index a valid index, then returns a reference to the long element of the private storage with the index index.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
参考这ios_base对象的任何操作无效,包括iword()的另一个调用,但是存储的值将被保留,因此,阅读从iword(index)使用相同的索引后会产生相同的值,直到下一次调用copyfmt()。该值可以用于任何目的。 xalloc()必须通过以下方式获得的元素的索引,否则本ios_base与其他用户的碰撞可能会发生。新的元素被初始化为0.
原文:
The reference may be invalidated by any operation on this ios_base object, including another call to iword(), but the stored values are retained, so that reading from iword(index) with the same index later will produce the same value (until the next call to copyfmt()). The value can be used for any purpose. The index of the element must be obtained by xalloc(), otherwise collisions with other users of this ios_base may occur. New elements are initialized to 0.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
如果分配失败,调用std::basic_ios<>::setstate(badbit)可能会引发std::basic_ios::failure
原文:
If allocation fails, calls std::basic_ios<>::setstate(badbit) which may throw std::basic_ios::failure
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

目录

[编辑] 注释

典型使用的iword存储是通过用户定义的I / O操纵信息(如自定义格式标志)到用户自定义的operator<<operator>>或用户定义成标准的数据流格式方面充满.
原文:
Typical use of iword storage is to pass information (e.g. custom formatting flags) from user-defined I/O manipulators to user-defined operator<< and operator>> or to user-defined formatting facets imbued into standard streams.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

[编辑] 参数

index -
的元素的索引值
原文:
index value of the element
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

[编辑] 返回值

参考的元素
原文:
reference to the element
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

[编辑] 例外

可能会引发std::ios_base::failure时设置的badbit的.
原文:
May throw std::ios_base::failure when setting the badbit.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

[编辑] 示例

#include <iostream>
#include <string>
 
struct Foo {
    static int foo_xalloc;
    std::string data; 
    Foo(const std::string& s) : data(s) {}
};
 
// allocates the iword storage for use with Foo objects
int Foo::foo_xalloc = std::ios_base::xalloc();
 
// This user-defined operator<< prints the string in reverse if the iword holds 1
std::ostream& operator<<(std::ostream& os, Foo& f)
{
    if(os.iword(Foo::foo_xalloc) == 1)
        return os << std::string(f.data.rbegin(), f.data.rend());
    else
        return os << f.data;
}
 
// This I/O manipulator flips the number stored in iword between 0 and 1
std::ios_base& rev(std::ios_base& os)
{
    os.iword(Foo::foo_xalloc) = !os.iword(Foo::foo_xalloc);
    return os;
}
 
int main()
{
    Foo f("example");
    std::cout << f << '\n' << rev << f << '\n' << rev << f << '\n';
}

输出:

example
elpmaxe
example

[编辑] 另请参阅

如果有必要的话,调整私有存储的大小,并且访问位于提供的下标的void*元素
原文:
resizes the private storage if necessary and access to the void* element at the given index
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
[静态]
返回一个程序范围内唯一的整数,它可以安全用于 PWORD() 和 iword() 的下标
(公开静态成员函数) [编辑]