std::basic_istream<CharT,Traits>::tellg

 

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_istream

グローバルオブジェクト

cinwcin

メンバ関数

basic_istream::basic_istream

basic_istream::~basic_istream

basic_istream::operator= (C++11)

書式付き入力

basic_istream::operator>>

書式なし入力

basic_istream::get

basic_istream::peek

basic_istream::unget

basic_istream::putback

basic_istream::getline

basic_istream::ignore

basic_istream::read

basic_istream::readsome

basic_istream::gcount

位置付け

basic_istream::tellg

basic_istream::seekg

その他

basic_istream::sync

basic_istream::swap (C++11)

メンバクラス

basic_istream::sentry

非メンバ関数

operator>>(std::basic_istream)

 

pos_type tellg();

関連するstreambufオブジェクトの現在の入力位置インジケータを返します。

gcount()に影響がない点を除き、UnformattedInputFunctionとして動作します。 sentryオブジェクトを構築してチェックした後、fail() == trueの場合は、pos_type(-1)を返します。それ以外の場合は、rdbuf()->pubseekoff(0, std::ios_base::cur, std::ios_base::in)を返します。

パラメータ

(なし)

戻り値

成功した場合のgetポインタの現在の位置、失敗した場合はpos_type(-1)。

例外

failure: エラーが発生した場合（エラー状態フラグが goodbit ではない）で、exceptions() がその状態に対してスローするように設定されている場合。

内部操作が例外をスローした場合、それはキャッチされ、badbit が設定されます。exceptions() が badbit に対して設定されている場合、例外は再スローされます。

例

このコードを実行

#include <iostream>
#include <sstream>
#include <string>
 
int main()
{
    std::string str = "Hello, world";
    std::istringstream in(str);
    std::string word;
    in >> word;
    std::cout << "After reading the word \"" << word
              << "\" tellg() returns " << in.tellg() << '\n';
}

出力

After reading the word "Hello," tellg() returns 6

関連項目

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