# std::fpos<State>::state

From cppreference.com
< cpp‎ | io‎ | fpos

State state() const; | (1) |
void state( State st ); | (2) |

Manages the file position state.

1) Returns the value of the file position state.
2) Replaces the file position state with the value of st.

For the specializations of std::fpos that are used in the standard library, `State` is always std::mbstate_t.

### Parameters

st | - | new value for the state

### Return value

1) The current value of the `fpos` state.
2) (none)

### Example

Run this code

    #include <cwchar>
    #include <iostream>
    #include <sstream>

    int main()
    {
        std::istringstream s("test");
        std::mbstate_t st = s.tellg().state();

        if (std::mbsinit(&st))
            std::cout << "The stream is in the initial shift state\n";
    }

Output:

    The stream is in the initial shift state

### Defect reports

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

DR | Applied to | Behavior as published | Correct behavior
--- | --- | --- | ---
LWG 441 | C++98 | overload (1) was not declared const (it is const in the synopsis) | added const

### See also

mbstate_t | conversion state information necessary to iterate multibyte character strings (class)

Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/io/fpos/state&oldid=159105"