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

 

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

公開メンバ関数

basic_spanbuf::basic_spanbuf (C++23)

basic_spanbuf::operator= (C++23)

basic_spanbuf::swap (C++23)

basic_spanbuf::span (C++23)

Protected member functions

basic_spanbuf::setbuf (C++23)

basic_spanbuf::seekoff (C++23)

basic_spanbuf::seekpos (C++23)

非メンバ関数

swap(std::basic_spanbuf) (C++23)

 

protected: pos_type seekoff( off_type off, std::ios_base::seekdir dir,                   std::ios_base::openmode which =                       std::ios_base::in | std::ios_base::out ) override;		(C++23から)

バッファの入力領域および/または出力領域の現在の位置、終端、または先頭から、指定されたoff文字分離れた位置に、可能であれば、次のポインタを移動させます。

基になるバッファ内のCharT要素の数をnとします。基になるバッファがない場合はnは0となります。この関数は、以下の場合に失敗します。

• 入力領域および/または出力領域を移動させる次のポインタがnullであり、かつ計算されたnewoff（下記参照）がゼロでない場合。これは、基になるバッファがない場合、または*thisがwhichで要求されたモードで開かれていない場合に発生する可能性があります。
• dirがstd::ios_base::curであり、かつwhichでstd::ios_base::inとstd::ios_base::outの両方が設定されている場合。
• 計算されたnewoffがoff_typeで表現できない、ゼロ未満、またはnより大きい場合。

newoffは以下のように計算されます。

• dirがstd::ios_base::begの場合、newoffはoffです。
• dirがstd::ios_base::curの場合、newoffは
  • pptr() - pbase() + off（whichでstd::ios_base::outが設定されている場合）、または
  • gptr() - eback() + off（whichでstd::ios_base::inが設定されている場合）です。
• dirがstd::ios_base::endの場合、newoffは
  • pptr() - pbase() + off（*thisのオープンモードでstd::ios_base::outが設定されており、std::ios_base::inが設定されていない場合）、
  • それ以外の場合は、off + nです。

この関数は、成功した場合、whichで対応するstd::ios_base::inおよび/またはstd::ios_base::outが設定されていれば、次の入出力ポインタをpbuf + newoffに移動させます。ここで、pbufは基になるバッファの先頭へのポインタ、または基になるバッファがない場合はnullポインタ値です。

パラメータ

off	-	次のポインタの位置を設定する相対位置
dir	-	相対オフセットを適用する基準位置を定義します。次のいずれかの定数を使用できます。 Constant 説明 beg ストリームの先頭 end ストリームの末尾 cur ストリーム位置指示子の現在の位置
which	-	入力シーケンス、出力シーケンス、またはその両方に影響するかどうかを定義します。これは、次の定数のいずれか、またはそれらの組み合わせです。 Constant 説明 in 入力シーケンスに影響する out 出力シーケンスに影響する

戻り値

成功した場合はpos_type(newoff)、失敗した場合はpos_type(off_type(-1))。

関連項目

seekoff [virtual]	入力シーケンス、出力シーケンス、またはその両方で、相対アドレス指定を使用して次のポインタを再配置する (virtual protected member function of std::basic_stringbuf<CharT,Traits,Allocator>)
seekoff [virtual]	入力シーケンス、出力シーケンス、またはその両方で、相対アドレス指定を使用して次のポインタを再配置する (virtual protected member function of std::strstreambuf)