std::basic_filebuf<CharT,Traits>::seekpos

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

輸入/輸出庫

I/O 操縱器

列印函式 (C++23)

C 風格 I/O

緩衝區

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

流

抽象

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

檔案 I/O

basic_ifstream

basic_ofstream

basic_fstream

字串 I/O

basic_istringstream

basic_ostringstream

basic_stringstream

陣列 I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同步輸出

basic_osyncstream (C++20)

型別

streamoff

streamsize

fpos

錯誤類別介面

iostream_category (C++11)

io_errc (C++11)

 

std::basic_filebuf

公開成員函式

basic_filebuf::basic_filebuf

basic_filebuf::~basic_filebuf

basic_filebuf::operator= (C++11)

basic_filebuf::swap (C++11)

basic_filebuf::native_handle (C++26)

basic_filebuf::is_open

basic_filebuf::open

basic_filebuf::close

受保護的成員函式

basic_filebuf::showmanyc

basic_filebuf::underflow

basic_filebuf::uflow

basic_filebuf::pbackfail

basic_filebuf::overflow

basic_filebuf::setbuf

basic_filebuf::seekoff

basic_filebuf::seekpos

basic_filebuf::sync

basic_filebuf::imbue

非成員函式

swap(std::basic_filebuf) (C++11)

 

protected: virtual pos_type seekpos( pos_type sp,                           std::ios_base::openmode which = std::ios_base::in | std::ios_base::out );

如果可能，將檔案指標重新定位到 sp 指示的位置。如果關聯檔案未開啟 (is_open() == false)，則立即失敗。

重新定位執行如下：

1) 如果檔案已開啟用於寫入，則使用 overflow() 寫入 put 區域和當前區域設定所需的任何 unshift 序列。

2) 重新定位檔案指標，如同呼叫 std::fsetpos()。

3) 如果檔案已開啟用於讀取，則在必要時更新 get 區域。

如果 sp 不是透過對同一檔案呼叫 seekoff() 或 seekpos() 獲得的，則行為未定義。

引數

sp	-	透過先前對同一檔案呼叫 seekoff() 或 seekpos() 獲得的檔案位置
which	-	- 定義影響輸入及/或輸出序列的哪個。它可以是下列常量之一或組合 常數 解釋 in 影響輸入序列 out 影響輸出序列

返回值

成功時返回 sp，失敗時返回 pos_type(off_type(-1))。

注意

seekpos() 由 std::basic_streambuf::pubseekpos() 呼叫，後者由 std::basic_istream::seekg() 和 std::basic_ostream::seekp() 的單引數版本呼叫。

許多實現不會在 seekpos() 中更新 get 區域，而是委託給由下一個 sgetc() 呼叫的 underflow()。

示例

在某些實現中，get 區域由 seekpos() 清空，第二次 underflow() 對於觀察效果是必要的。

執行此程式碼

#include <fstream>
#include <iostream>
 
struct mybuf : std::filebuf
{
    pos_type seekpos(pos_type sp, std::ios_base::openmode which)
    {
        std::cout << "Before seekpos(" << sp << "), size of the get area is "
                  << egptr() - eback() << " with "
                  << egptr() - gptr() << " read positions available.\n";
 
        pos_type rc = std::filebuf::seekpos(sp, which);
 
        std::cout << "seekpos() returns " << rc << ".\nAfter the call, "
                  << "size of the get area is "
                  << egptr() - eback() << " with "
                  << egptr() - gptr() << " read positions available.\n";
// uncomment if get area is emptied by seekpos()
//        std::filebuf::underflow();
//        std::cout << "after forced underflow(), size of the get area is "
//                  << egptr() - eback() << " with "
//                  << egptr() - gptr() << " read positions available.\n";
 
        return rc;
    }
};
 
int main()
{
    mybuf buf;
    buf.open("test.txt", std::ios_base::in);
    std::istream stream(&buf);
    stream.get(); // read one char to force underflow()
    stream.seekg(2);
}

可能的輸出

Before seekpos(2), size of the get area is 110 with 109 read positions available.
seekpos() returns 2.
After the call, size of the get area is 110 with 108 read positions available.

缺陷報告

下列更改行為的缺陷報告追溯地應用於以前出版的 C++ 標準。

缺陷報告	應用於	釋出時的行為	正確的行為
LWG 55	C++98	seekpos 返回一個未定義值 的非法流位置	pos_type(off_type(-1)) 在失敗時返回
LWG 171	C++98	重新定位操作的順序不明確	已明確

另請參閱

pubseekpos	呼叫 seekpos() (std::basic_streambuf<CharT,Traits> 的公共成員函式)
seekoff [虛擬函式]	使用相對地址重新定位檔案位置 (虛保護成員函式)
fseek	將檔案位置指示器移動到檔案中特定位置 (函式)