std::basic_istream<CharT,Traits>::tellg
From cppreference.com
< cpp | io | basic istream
C++
Feature test macros (C++20)
Concepts library (C++20)
Metaprogramming library (C++11)
Ranges library (C++20)
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
Input/output library
Print functions (C++23)
Buffers
(C++23)
(C++98/26*)
(C++20)
Streams
Abstractions
File I/O
String I/O
Array I/O
(C++23)
(C++23)
(C++23)
(C++98/26*)
(C++98/26*)
(C++98/26*)
Synchronized Output
(C++20)
Types
Error category interface
(C++11)
(C++11)
std::basic_istream
Global objects
Member functions
(C++11)
Formatted input
Unformatted input
Positioning
basic_istream::tellg
Miscellaneous
(C++11)
Member classes
Non-member functions
pos_type tellg();
Returns input position indicator of the current associated streambuf object.
Behaves as UnformattedInputFunction, except that gcount() is not affected. After constructing and checking the sentry object, if fail() == true, returns pos_type(-1). Otherwise, returns rdbuf()->pubseekoff(0, std::ios_base::cur, std::ios_base::in ).
[edit] Parameters
(none)
[edit] Return value
The current position of the get pointer on success, pos_type(-1) on failure.
[edit] Exceptions
failure if an error occurred (the error state flag is not goodbit ) and exceptions() is set to throw for that state.If an internal operation throws an exception, it is caught and badbit is set. If exceptions() is set for badbit, the exception is rethrown.
[edit] Example
Run this code
#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'; }
Output:
After reading the word "Hello," tellg() returns 6
[edit] See also
[virtual]
(virtual protected member function of
std::basic_filebuf<CharT,Traits>) [edit]
[virtual]
(virtual protected member function of
std::basic_stringbuf<CharT,Traits,Allocator>) [edit]
[virtual]
(virtual protected member function of
std::strstreambuf) [edit]
returns the output position indicator
(public member function of
(public member function of
std::basic_ostream<CharT,Traits>) [edit]