std::strstreambuf::seekpos

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

入出力ライブラリ

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::strstreambuf

公開メンバ関数

strstreambuf::strstreambuf

strstreambuf::~strstreambuf

strstreambuf::freeze

strstreambuf::str

strstreambuf::pcount

Protected member functions

strstreambuf::underflow

strstreambuf::pbackfail

strstreambuf::overflow

strstreambuf::setbuf

strstreambuf::seekoff

strstreambuf::seekpos

 

protected: virtual pos_type seekpos( pos_type sp,                           std::ios_base::openmode によって =                               std::ios_base::in | std::ios_base::out );		(C++98で非推奨) (C++26で削除)

std::basic_streambuf::gptr および/または std::basic_streambuf::pptr を、可能であれば sp によって示される位置に移動します。

which に std::ios_base::in が設定されている場合、gptr() (get領域の次のポインタ) を移動しようとします。which に std::ios_base::out が設定されている場合、pptr() (put領域の次のポインタ) を移動しようとします。which にどちらのビットも設定されていない場合、操作は失敗します。

各次のポインタは以下のように移動されます。

• 次のポインタが null の場合、操作は失敗します。
• それ以外の場合、新しいオフセット newoff (off_type 型) は、sp.offset() を呼び出すことによって決定されます。newoff が負の値、バッファの範囲外、または無効な場合、操作は失敗します。
• それ以外の場合、次のポインタは gptr() = eback() + newoff または pptr() = pbase() + newoff のように代入されます。

パラメータ

sp	-	ストリーム位置。例えば seekoff() または seekpos() によって取得されたもの。
which	-	入力シーケンス、出力シーケンス、またはその両方に影響するかどうかを定義します。これは、次の定数のいずれか、またはそれらの組み合わせです。 Constant 説明 in 入力シーケンスに影響する out 出力シーケンスに影響する

戻り値

成功した場合は pos_type に変換された結果のオフセット、失敗した場合は pos_type(off_type(-1))。

注意

seekpos() は std::basic_streambuf::pubseekpos() によって呼び出されます。これは、std::basic_istream::seekg() および std::basic_ostream::seekp() の単一引数バージョンによって呼び出されます。

例

このコードを実行

#include <cstring>
#include <iostream>
#include <strstream>
 
struct mybuf : std::strstreambuf
{
    mybuf(const char* str) : std::strstreambuf(str, std::strlen(str)) {}
 
    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::strstreambuf::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";
 
        return rc;
    }
};
 
int main()
{
    mybuf buf("12345");
    std::iostream stream(&buf);
    stream.seekg(2);
}

出力

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

不具合報告

以下の動作変更を伴う欠陥報告が、以前に公開されたC++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
LWG 55	C++98	seekpos は未定義の値を返していました。 失敗時に無効なストリーム位置	pos_type(off_type(-1)) が失敗時に返される

関連項目

seekoff [virtual]	入力シーケンス、出力シーケンス、またはその両方で、相対アドレス指定を使用して次のポインタを再配置する (仮想保護メンバ関数)
seekpos [virtual]	入力シーケンス、出力シーケンス、またはその両方で、絶対アドレス指定を使用して次のポインタを再配置する (std::basic_streambuf<CharT,Traits> の仮想 protected メンバ関数)
seekpos [virtual]	入力シーケンス、出力シーケンス、またはその両方で、絶対アドレス指定を使用して次のポインタを再配置する (virtual protected member function of std::basic_stringbuf<CharT,Traits,Allocator>)
seekpos [virtual]	絶対アドレスを使用してファイル位置を再配置します (virtual protected member function of std::basic_filebuf<CharT,Traits>)