Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

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
       object.

	  Behaves as UnformattedInputFunction, except that gcount() is not af-
       fected. After
	  constructing	and checking the sentry	object,	if fail() == true, re-
       turns
	  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 bad-
       bit is set. If
	  exceptions() is set for badbit, the exception	is rethrown.

Example
       // Run this code

	#include <iostream>
	#include <string>
	#include <sstream>

	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
       sequence, 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
       sequence, 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_os-
       tream<CharT,Traits>)
	  seekp	    sets the output position indicator
		    (public	member	   function	of	std::basic_os-
       tream<CharT,Traits>)

http://cppreference.com		  2022.07.31	  std::basic_istream::tellg(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::basic_istream::tellg&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help