std::clearerr(3)

🦋 std::clearerr(3) — C++ Standard Libary 🦋

okay so bestie, welcome to the std::clearerr(3) page — C++ Standard Library corner of the group chat, stream-cleanup edition 💅

✨ NAME ✨

std::clearerr — and yes, the name is literally std::clearerr, no cap. That's the whole name section, periodt. 💖

🌸 Synopsis 🌸

Defined in header <cstdio> ✨

void clearerr( std::FILE* stream );

What it does: it resets the error flags and the EOF indicator for the given file stream. Lowkey the cleanup bestie for your stream's emotional baggage 💅

🎀 Parameters 🎀

• stream — the file to reset the error flags for. That's the whole parameter list, bestie. 🫶

💖 Return value 💖

(none) — literally nothing comes back. No return value, no drama. 😭

🦋 Example 🦋

Okay so here's the exact code from the page, run-it-yourself energy:

       // Run this code

        #include <cassert>
        #include <cstdio>

        int main()
        {
            std::FILE* tmpf = std::tmpfile();
            std::fputs("cppreference.com\n", tmpf);
            std::rewind(tmpf);

            for (int ch; (ch = std::fgetc(tmpf)) != EOF; std::putchar(ch)) { }

            assert(std::feof(tmpf)); // the loop is expected to terminate by
       EOF
            std::puts("End of file reached");

            std::clearerr(tmpf); // clear EOF

            std::puts(std::feof(tmpf) ? "EOF indicator set"
                                      : "EOF indicator cleared");
        }

🍓 Output: 🍓

        cppreference.com
        End of file reached
        EOF indicator cleared

🌈 See also 🌈

• feof — checks for the end-of-file. It's a function. 👑
• perror — displays a character string corresponding of the current error to stderr. It's a function. 🫶
• ferror — checks for a file error. It's a function. 💜
• C documentation for clearerr — go read the C docs for clearerr, bestie. 🦋

shoutout to http://cppreference.com, source/version date 2024.06.10, and that's the std::clearerr(3) page — periodt. 💖✨🎀