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

可能であれば、ファイルポインタの位置��先頭、終端、またはファイルの現在位置 (dir の値によります) からちょうど文字 off 個に対応する位置に設定します。

紐付けられているファイルが開いていない (is_open()==false) 場合は、直ちに失敗します。

マルチバイト文字エンコーディングが状態依存 (codecvt::encoding() が -1 を返した) または可変長 (codecvt::encoding() が ​0​ を返した) であり、オフセット off が ​0​ でない場合は、直ちに失敗します。 この関数は文字 off 個に対応するバイト数を決定することができません。

dir が std::basic_ios::cur でないかオフセット off が ​0​ でなく、この filebuf オブジェクトに対して最も最近行われた操作が出力であった (つまり、 put バッファが空でないか、最も最近呼ばれた関数が overflow() であった) 場合は、必要なシフト解除シーケンスを決定するために std::codecvt::unshift を呼び、そのシーケンスを overflow() を呼ぶことによってファイルに書き込みます。

その後、引数 dir を int 型の値 whence に以下のように変換します。

その後、文字エンコーディングが固定幅 (codecvt::encoding() が何らかの正の値 width を返す) の場合は、 std::fseek(file, width*off, whence) によって行われたかのようにファイルポインタを移動させます。

そうでなければ、 std::fseek(file, 0, whence) によって行われたかのようにファイルポインタを移動させます。

std::basic_filebuf はファイル位置を1個しか維持管理しないため、基底クラスの関数シグネチャによって要求される openmode 引数は、通常、無視されます。

[編集] 引数

[編集] 戻り値

結果のファイル位置を格納する pos_type 型の新たに構築されたオブジェクト、または失敗した場合は pos_type(off_type(-1))。

[編集] ノート

seekoff() は std::basic_streambuf::pubseekoff によって呼ばれ、それは std::basic_istream::seekg、 std::basic_ostream::seekp、 std::basic_istream::tellg および std::basic_ostream::tellp によって呼ばれます。

[編集] 例

#include <iostream>
#include <fstream>
#include <locale>
int main()
{
    // prepare a 10-byte file holding 4 characters in UTF8
    std::ofstream("text.txt") << u8"z\u00df\u6c34\U0001d10b"; // or u8"zß水𝄋"
                                           // or "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9d\x84\x8b";
 
    // open using a non-converting encoding
    std::ifstream f1("text.txt");
    std::cout << "f1's locale's encoding() returns "
              << std::use_facet<std::codecvt<char, char, std::mbstate_t>>(f1.getloc()).encoding() << '\n'
              << "pubseekoff(3, beg) returns " << f1.rdbuf()->pubseekoff(3, std::ios_base::beg) << '\n'
              << "pubseekoff(0, end) returns " << f1.rdbuf()->pubseekoff(0, std::ios_base::end) << '\n';;
 
    // open using UTF-8
    std::wifstream f2("text.txt");
    f2.imbue(std::locale("en_US.UTF-8"));
    std::cout << "f2's locale's encoding() returns "
              << std::use_facet<std::codecvt<wchar_t, char, std::mbstate_t>>(f2.getloc()).encoding() << '\n'
              << "pubseekoff(3, beg) returns " << f2.rdbuf()->pubseekoff(3, std::ios_base::beg) << '\n'
              << "pubseekoff(0, end) returns " << f2.rdbuf()->pubseekoff(0, std::ios_base::end) << '\n';
 
}

f1's locale's encoding() returns 1
pubseekoff(3, beg) returns 3
pubseekoff(0, end) returns 10
f2's locale's encoding() returns 0
pubseekoff(3, beg) returns -1
pubseekoff(0, end) returns 10

[編集] 関連項目