std::basic_istream::tellg - cppreference.com

##### cppreference.com

##### Search

Create account

##### Namespaces

- Page
- Discussion

##### Variants

##### Views

- View
- Edit
- History

##### Actions

# std::basic_istream::tellg

From cppreference.com
< cpp‎ | io‎ | basic istream

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

[edit]
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 <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

### [edit] See also

seekoff [virtual] | repositions the file position, using relative addressing (virtual protected member function of `std::basic_filebuf`) [edit]
seekoff [virtual] | repositions the next pointer in the input sequence, output sequence, or both, using relative addressing (virtual protected member function of `std::basic_stringbuf`) [edit]
seekoff [virtual] | repositions the next pointer in the input sequence, output sequence, or both, using relative addressing (virtual protected member function of `std::strstreambuf`) [edit]
seekg | sets the input position indicator (public member function) [edit]
tellp | returns the output position indicator (public member function of `std::basic_ostream`) [edit]
seekp | sets the output position indicator (public member function of `std::basic_ostream`) [edit]

Retrieved from "http://en.cppreference.com/mwiki/index.php?title=cpp/io/basic_istream/tellg&oldid=76328"