std::ios_base:: iword

먼저, private 저장소(dynamic array of long 또는 다른 인덱스 가능한 데이터 구조)를 index 가 유효한 인덱스가 되도록 충분히 할당하거나 크기를 조정한 후, long 요소 중 index 인덱스를 가진 private 저장소 요소에 대한 참조를 반환합니다.

이 참조는 이 ios_base 객체에 대한 모든 연산(다른 iword() 호출 포함)으로 무효화될 수 있지만, 저장된 값들은 유지됩니다. 따라서 동일한 인덱스로 나중에 iword ( index ) 을 읽으면 다음 std::basic_ios::copyfmt() 호출까지 동일한 값을 생성합니다. 이 값은 어떤 목적으로든 사용될 수 있습니다. 요소의 인덱스는 이전 xalloc() 호출을 통해 얻어야 하며, 그렇지 않으면 동작이 정의되지 않습니다. 새로운 요소들은 ​ 0 ​ 으로 초기화됩니다.

함수가 실패할 경우(할당 실패로 인한 가능성 있음) 그리고 * this 가 basic_ios<> 객체 또는 하위 객체의 기본 클래스 하위 객체인 경우, std:: basic_ios <> :: setstate ( badbit ) 를 호출하며, 이는 std::ios_base::failure 를 발생시킬 수 있습니다.

참고 사항

iword 저장소의 일반적인 사용법은 사용자 정의 I/O 조정자에서 사용자 정의 operator<< 및 operator>> 로 정보(예: 사용자 정의 서식 플래그)를 전달하거나 표준 스트림에 임뷰된 사용자 정의 서식 패싯으로 정보를 전달하는 것입니다.

매개변수

반환값

요소에 대한 참조입니다.

예외

badbit 설정 시 std::ios_base::failure 를 throw할 수 있습니다.

예제

#include <iostream>
#include <string>
struct Foo
{
    static int foo_xalloc;
    std::string data; 
    Foo(const std::string& s) : data(s) {}
};
// Foo 객체와 함께 사용할 iword 저장소를 할당합니다
int Foo::foo_xalloc = std::ios_base::xalloc();
// 이 사용자 정의 operator<<는 iword가 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;
}
// 이 I/O 조정자는 iword에 저장된 숫자를 0과 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

결함 보고서

다음의 동작 변경 결함 보고서들은 이전에 발표된 C++ 표준에 소급 적용되었습니다.

참고 항목