std::basic_stringbuf<CharT,Traits,Allocator>:: seekoff

가능한 경우 버퍼의 get 및/또는 put 영역의 시작, 끝 또는 현재 위치에서 정확히 off 문자에 해당하는 위치로 std::basic_streambuf::gptr 및/또는 std::basic_streambuf::pptr 을 재배치합니다.

• 만약 which 가 std::ios_base::in 을 포함하고 이 버퍼가 읽기용으로 열려 있는 경우(즉, ( which & std:: ios_base :: in ) == std:: ios_base :: in ), 아래에 설명된 대로 get 영역 내의 읽기 포인터 std::basic_streambuf::gptr 을 재위치합니다.
• 만약 which 가 std::ios_base::out 을 포함하고 이 버퍼가 쓰기용으로 열려 있는 경우(즉, ( which & std:: ios_base :: out ) == std:: ios_base :: out ), 아래에 설명된 대로 put 영역 내의 쓰기 포인터 std::basic_streambuf::pptr 을 재위치합니다.
• 만약 which 가 std::ios_base::in 과 std::ios_base::out 을 모두 포함하고 버퍼가 읽기와 쓰기 모두로 열려 있는 경우(즉, ( which & ( std:: ios_base :: in | std:: ios_base :: out ) ) == ( std:: ios_base :: in | std:: ios_base :: out ) ), 그리고 dir 이 std::ios_base::beg 또는 std::ios_base::end 중 하나인 경우, 아래에 설명된 대로 읽기와 쓰기 포인터를 모두 재위치합니다.
• 그렇지 않으면, 이 함수는 실패합니다.

만약 gptr 및/또는 pptr 이 재배치되는 경우, 다음과 같이 수행됩니다:

매개변수

반환값

pos_type ( newoff ) 성공 시, pos_type ( off_type ( - 1 ) ) 실패 시 또는 pos_type 이 결과 스트림 위치를 표현할 수 없는 경우.

예제

#include <iostream>
#include <sstream>
int main()
{
    std::stringstream ss("123"); // 입출력
    std::cout << "put pos = " << ss.tellp()
              << " get pos = " << ss.tellg() << '\n';
    // 두 포인터의 절대 위치 지정
    ss.rdbuf()->pubseekoff(1, std::ios_base::beg); // 둘 다 1만큼 앞으로 이동
    std::cout << "put pos = " << ss.tellp()
              << " get pos = " << ss.tellg() << '\n';
    // 현재 위치에서 두 포인터를 1만큼 앞으로 이동 시도
    if (-1 == ss.rdbuf()->pubseekoff(1, std::ios_base::cur))
        std::cout << "현재 위치에서 두 포인터 이동 실패\n";
    std::cout << "put pos = " << ss.tellp()
              << " get pos = " << ss.tellg() << '\n';
    // 쓰기 포인터만 1만큼 앞으로 이동, 읽기 포인터는 이동하지 않음
    // ss.seekp(1, std::ios_base::cur); 로도 호출 가능
    ss.rdbuf()->pubseekoff(1, std::ios_base::cur, std::ios_base::out);
    std::cout << "put pos = " << ss.tellp()
              << " get pos = " << ss.tellg() << '\n';
    ss << 'a'; // put 위치에 쓰기
    std::cout << "'a'를 put 위치에 기록, 현재 버퍼: " << ss.str() << '\n';
    char ch;
    ss >> ch;
    std::cout << "get 위치에서 읽은 값: '" << ch << "'\n";
}

put pos = 0 get pos = 0
put pos = 1 get pos = 1
moving both pointers from current position failed
put pos = 1 get pos = 1
put pos = 2 get pos = 1
Wrote 'a' at put position, the buffer is now 12a
reading at get position gives '2'

결함 보고서

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

참고 항목