home | help 
std::basic_istream::tellg(3)   C++ Standard Libary  std::basic_istream::tellg(3)

NAME
     std::basic_istream::tellg - std::basic_istream::tellg

Synopsis
	pos_type tellg();

	Returns input position indicator of the current associated streambuf ob-
     ject.

	Behaves  as  UnformattedInputFunction,	except	that gcount() is not af-
     fected. 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).

Parameters
	(none)

Return value
	The  current  position	of  the  get pointer on success, pos_type(-1) on
     failure.

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.

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

See also
	seekoff   repositions the file position, using relative addressing
	[virtual]   (virtual   protected  member  function  of	std::basic_file-
     buf<CharT,Traits>)

		  repositions the next pointer in the input sequence, output se-
     quence, or
	seekoff   both, using relative addressing
	[virtual] (virtual protected member function of
		  std::basic_stringbuf<CharT,Traits,Allocator>)
	seekoff   repositions the next pointer in the input sequence, output se-
     quence, or
	[virtual] both, using relative addressing
		  (virtual protected member function of std::strstreambuf)
	seekg	  sets the input position indicator
		  (public member function)
	tellp	  returns the output position indicator
		  (public member function of std::basic_ostream<CharT,Traits>)
	seekp	  sets the output position indicator
		  (public member function of std::basic_ostream<CharT,Traits>)

http://cppreference.com 	   2024.06.10	    std::basic_istream::tellg(3)
home | help