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 ) 。

基底クラスの関数シグネチャで要求される openmode 引数は通常無視されます。これは std::basic_filebuf が単一のファイル位置のみを維持するためです。

パラメータ

戻り値

型 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 <fstream>
#include <iostream>
#include <locale>
template<typename CharT>
int get_encoding(const std::basic_istream<CharT>& stream)
{
    using Facet = std::codecvt<CharT, char, std::mbstate_t>;
    return std::use_facet<Facet>(stream.getloc()).encoding();
}
int main()
{
    // UTF-8で4文字("zß水𝄋")を保持する10バイトのファイルを準備
    std::ofstream("text.txt") << "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9d\x84\x8b";
    // 変換を行わないエンコーディングでオープン
    std::ifstream f1("text.txt");
    std::cout << "f1のロケールのencoding()は"
              << get_encoding(f1) << '\n'
              << "pubseekoff(3, beg)は"
              << f1.rdbuf()->pubseekoff(3, std::ios_base::beg) << '\n'
              << "pubseekoff(0, end)は"
              << f1.rdbuf()->pubseekoff(0, std::ios_base::end) << '\n';
    // UTF-8を使用してオープン
    std::wifstream f2("text.txt");
    f2.imbue(std::locale("en_US.UTF-8"));
    std::cout << "f2のロケールのencoding()は"
              << get_encoding(f2) << '\n'
              << "pubseekoff(3, beg)は"
              << f2.rdbuf()->pubseekoff(3, std::ios_base::beg) << '\n'
              << "pubseekoff(0, end)は"
              << f2.rdbuf()->pubseekoff(0, std::ios_base::end) << '\n';
}

f1のロケールのencoding()は1
pubseekoff(3, beg)は3
pubseekoff(0, end)は10
f2のロケールのencoding()は0
pubseekoff(3, beg)は-1
pubseekoff(0, end)は10

不具合報告

以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

関連項目