std::istreambuf_iterator

template< class CharT, class Traits = std::char_traits<CharT> >
class istreambuf_iterator
    : public std::iterator<std::input_iterator_tag,
                           CharT, typename Traits::off_type,
                           /* unspecified */, CharT>

template< class CharT, class Traits = std::char_traits<CharT> >
class istreambuf_iterator;

std::istreambuf_iterator는 자신이 생성된 std::basic_streambuf 객체로부터 연속적인 문자를 읽는 단일 패스 입력 반복자입니다.

기본 생성된 std::istreambuf_iterator는 스트림 끝 반복자로 알려져 있습니다. std::istreambuf_iterator가 기본 스트림의 끝에 도달하면 스트림 끝 반복자와 같아집니다. 이를 역참조하거나 증가시키면 정의되지 않은 동작이 발생합니다.

멤버 타입

멤버 타입 pointer 는 일반적으로 CharT* 입니다( 아래 참조).

멤버 함수

비멤버 함수

참고 사항

LWG 이슈 659 의 해결은 operator - > 를 도입했습니다. std::istreambuf_iterator i 가 주어졌을 때, 표현식 ( * i ) . m 와 i - > m 이 동일한 효과를 가질 것으로 예상됩니다.

그러나 이 결의안은 해당 동작에 대한 공식적인 명세를 제공하지 않습니다. 따라서 구현마다 다르게 동작하며, nullptr 를 반환하거나, 임시 객체의 주소를 반환하거나, 아예 해당 멤버를 제공하지 않는 경우도 있습니다. 의도된 동작을 달성하기 어려워 LWG issue 2790 의 결의안을 통해 제거되었습니다.

LWG 이슈 659 의 해결은 또한 operator-> 가 프록시를 반환할 수 있도록 하기 위해 멤버 타입 pointer 를 미지정(unspecified)으로 만들었습니다. 이는 CharT 가 클래스 타입이 아닐 때 operator-> 가 컴파일되도록 하기 위함입니다.

예제

#include <iostream>
#include <iterator>
#include <sstream>
#include <string>
int main()
{
    // 일반적인 사용 사례: 반복자 쌍으로 표현된 입력 스트림
    std::istringstream in{"Hello, world"};
    std::istreambuf_iterator<char> it{in}, end;
    std::string ss{it, end};
    std::cout << "ss has " << ss.size() << " bytes; "
                 "it holds \"" << ss << "\"\n";
    // 단일 패스 특성의 데모
    std::istringstream s{"abc"};
    std::istreambuf_iterator<char> i1{s}, i2{s};
    std::cout << "i1 returns '" << *i1 << "'\n"
                 "i2 returns '" << *i2 << "'\n";
    ++i1;
    std::cout << "after incrementing i1, but not i2:\n"
                 "i1 returns '" << *i1 << "'\n"
                 "i2 returns '" << *i2 << "'\n";
    ++i2;
    std::cout << "after incrementing i2, but not i1:\n"
                 "i1 returns '" << *i1 << "'\n"
                 "i2 returns '" << *i2 << "'\n";
}

ss has 12 bytes; it holds "Hello, world"
i1 returns 'a'
i2 returns 'a'
after incrementing i1, but not i2:
i1 returns 'b'
i2 returns 'b'
after incrementing i2, but not i1:
i1 returns 'c'
i2 returns 'c'

결함 보고서

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

참고 항목