Namespaces
Variants
Views
Actions

std::ferror

From cppreference.com
< cpp‎ | io‎ | c
 
 
 
C-style I/O
Types and objects
Functions
File access
Direct input/output
Unformatted input/output
Formatted input
(C++11)(C++11)(C++11)    
(C++11)(C++11)(C++11)    
 
Defined in header <cstdio>
int ferror( std::FILE* stream );

Checks the given stream for errors.

Contents

[edit] Parameters

stream - the file stream to check

[edit] Return value

Nonzero value if the file stream has errors occurred, 0 otherwise.

[edit] Example

#include <clocale>
#include <cstdio>
#include <cstdlib>
#include <cwchar>
 
int main()
{
    const char *fname = std::tmpnam(nullptr);
    std::FILE* f = std::fopen(fname, "wb");
    std::fputs("\xff\xff\n", f); // not a valid UTF-8 character sequence
    std::fclose(f);
 
    std::setlocale(LC_ALL, "en_US.utf8");
    f = std::fopen(fname, "rb");
    std::wint_t ch;
    while ((ch=std::fgetwc(f)) != WEOF) // attempt to read as UTF-8
        std::printf("%#x ", ch);
 
    if (std::feof(f))
        puts("EOF indicator set");
    if (std::ferror(f))
        puts("Error indicator set");
}

Output:

Error indicator set

[edit] See also

clears errors
(function) [edit]
checks for the end-of-file
(function) [edit]
checks if an error has occurred
(public member function of std::basic_ios<CharT,Traits>) [edit]
C documentation for ferror