| CARVIEW |
Select Language
HTTP/1.1 301 Moved Permanently
Server: nginx
Date: Thu, 24 Jul 2025 08:58:14 GMT
Content-Type: text/html; charset=UTF-8
Transfer-Encoding: chunked
Connection: keep-alive
Location: /reference/ios/basic_ios/setstate/
HTTP/1.1 200 OK
Server: nginx
Date: Thu, 24 Jul 2025 08:58:14 GMT
Content-Type: text/html; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
ETag: W/"9116-I/ZMYOA6VhJwYkj8uCVsXkMUd2Y"
Content-Encoding: gzip
Modifies the current internal error state flags by combining the current flags with those in argument state (as if performing a bitwise OR operation).
Any error bitflag already set is not cleared. See member clear for a similar function that does.
In the case that no stream buffer is associated with the stream when this function is called, the badbit flag is automatically set (no matter the value for that bit passed in argument state).
Note that changing the state may throw an exception, depending on the latest settings passed to member exceptions.
The current state can be obtained with member function rdstate.
This function behaves as if defined as:
Concurrent access to the same stream object may cause data races.
It throws an exception of member type failure if the resulting error state flag is not goodbit and member exceptions was set throw for that state.
Reference
C library:
- <cassert> (assert.h)
- <cctype> (ctype.h)
- <cerrno> (errno.h)
-
<cfenv> (fenv.h)C++11
- <cfloat> (float.h)
-
<cinttypes> (inttypes.h)C++11
- <ciso646> (iso646.h)
- <climits> (limits.h)
- <clocale> (locale.h)
- <cmath> (math.h)
- <csetjmp> (setjmp.h)
- <csignal> (signal.h)
- <cstdarg> (stdarg.h)
-
<cstdbool> (stdbool.h)C++11
- <cstddef> (stddef.h)
-
<cstdint> (stdint.h)C++11
- <cstdio> (stdio.h)
- <cstdlib> (stdlib.h)
- <cstring> (string.h)
-
<ctgmath> (tgmath.h)C++11
- <ctime> (time.h)
-
<cuchar> (uchar.h)C++11
- <cwchar> (wchar.h)
- <cwctype> (wctype.h)
Containers:
-
<array>C++11
- <deque>
-
<forward_list>C++11
- <list>
- <map>
- <queue>
- <set>
- <stack>
-
<unordered_map>C++11
-
<unordered_set>C++11
- <vector>
-
Input/Output:
Multi-threading:
-
<atomic>C++11
-
<condition_variable>C++11
-
<future>C++11
-
<mutex>C++11
-
<thread>C++11
-
Other:
- <algorithm>
- <bitset>
-
<chrono>C++11
-
<codecvt>C++11
- <complex>
- <exception>
- <functional>
-
<initializer_list>C++11
- <iterator>
- <limits>
- <locale>
- <memory>
- <new>
- <numeric>
-
<random>C++11
-
<ratio>C++11
-
<regex>C++11
- <stdexcept>
- <string>
-
<system_error>C++11
-
<tuple>C++11
-
<type_traits>C++11
-
<typeindex>C++11
- <typeinfo>
- <utility>
- <valarray>
<ios>
types
manipulators
other functions
-
iostream_categoryC++11
-
basic_ios
- basic_ios::~basic_ios
- basic_ios::basic_ios
public members
- basic_ios::bad
- basic_ios::clear
- basic_ios::copyfmt
- basic_ios::eof
- basic_ios::exceptions
- basic_ios::fail
- basic_ios::fill
- basic_ios::good
- basic_ios::imbue
- basic_ios::narrow
- basic_ios::operator bool
- basic_ios::operator!
- basic_ios::rdbuf
- basic_ios::rdstate
- basic_ios::setstate
- basic_ios::tie
- basic_ios::widen
protected members
- basic_ios::init
-
basic_ios::moveC++11
-
basic_ios::set_rdbufC++11
-
basic_ios::swapC++11
public member function
<ios> <iostream>
std::basic_ios::setstate
void setstate (iostate state);
Set error state flag
Any error bitflag already set is not cleared. See member clear for a similar function that does.
In the case that no stream buffer is associated with the stream when this function is called, the badbit flag is automatically set (no matter the value for that bit passed in argument state).
Note that changing the state may throw an exception, depending on the latest settings passed to member exceptions.
The current state can be obtained with member function rdstate.
This function behaves as if defined as:
|
|
Parameters
- state
- An object of type ios_base::iostate that can take as value any combination of the following member constants:
eofbit, failbit and badbit are member constants with implementation-defined values that can be combined (as if with the bitwise OR operator).iostate value
(member constants)indicates functions to check state flags good() eof() fail() bad() rdstate() goodbit No errors (zero value iostate) truefalsefalsefalsegoodbit eofbit End-of-File reached on input operation falsetruefalsefalseeofbit failbit Logical error on i/o operation falsefalsetruefalsefailbit badbit Read/writing error on i/o operation falsefalsetruetruebadbit
goodbit is zero, indicating that none of the other bits is set.
Return Value
noneData races
Modifies the stream object.Concurrent access to the same stream object may cause data races.
Exception safety
Basic guarantee: if an exception is thrown, the stream is in a valid state.It throws an exception of member type failure if the resulting error state flag is not goodbit and member exceptions was set throw for that state.
See also
- basic_ios::fail
- Check whether failbit or badbit is set (public member function)
- basic_ios::good
- Check whether state of stream is good (public member function)
- basic_ios::bad
- Check whether badbit is set (public member function)
- basic_ios::eof
- Check whether eofbit is set (public member function)
- basic_ios::rdstate
- Get error state flags (public member function)
- basic_ios::clear
- Set error state flags (public member function)
Home page | Privacy policy
© cplusplus.com, 2000-2025 - All rights reserved - v3.3.4s
Spotted an error? contact us
© cplusplus.com, 2000-2025 - All rights reserved - v3.3.4s
Spotted an error? contact us