std::_Exit(3)

🦋 std::_Exit(3) 🦋

okay so bestie, welcome to std::_Exit(3) from the C++ Standard Libary — yes, that's the manual name, and this page is about the most “I'm out, no cleanup” function ever. no cap 🫶

👑 NAME 👑

std::_Exit — literally std::_Exit, that's the name, bestie 💅

✨ Synopsis ✨

Defined in header <cstdlib>
[[noreturn]] void _Exit( int exit_code ) noexcept;  (since C++11)

💖 Description 💖

So here's the tea: std::_Exit causes normal program termination to occur without completely cleaning the resources. it's giving “we're leaving right now, no packing” 💨

Destructors of variables with automatic, thread local and static storage durations are not called. Functions passed to std::at_quick_exit() or std::atexit() are not called. Whether open resources such as files are closed is implementation defined. important caveat, bestie — that last bit is not something this page promises.

If exit_code is 0 or EXIT_SUCCESS, an implementation-defined status indicating successful termination is returned to the host environment. If exit_code is EXIT_FAILURE, an implementation-defined status, indicating unsuccessful termination, is returned. In other cases implementation-defined status value is returned. implementation-defined girlies, you know how it is 🌸

🎀 Parameters 🎀

• exit_code — exit status of the program. that's the whole parameter list, bestie 🍓

💜 Return value 💜

(none) — literally nothing comes back, it's a [[noreturn]] situation, so don't wait up 😭

💻 Example 💻

// Run this code — go go go:

       // Run this code

        #include <iostream>

        class Static
        {
        public:
            ~Static()
            {
                std::cout << "Static dtor\n";
            }
        };

        class Local
        {
        public:
            ~Local()
            {
                std::cout << "Local dtor\n";
            }
        };

        Static static_variable; // dtor of this object will *not* be called

        void atexit_handler()
        {
            std::cout << "atexit handler\n";
        }

        int main()
        {
            Local local_variable; // dtor of this object will *not* be called

            // handler will *not* be called
            const int result = std::atexit(atexit_handler);

            if (result != 0)
            {
                std::cerr << "atexit registration failed\n";
                return EXIT_FAILURE;
            }

            std::cout << "test" << std::endl; // flush from std::endl
                // needs to be here, otherwise nothing will be printed
            std::_Exit(EXIT_FAILURE);
        }

🍓 Output: 🍓

        test

🌈 See also 🌈

• abort — causes abnormal program termination (without cleaning up) (function) 💀
• exit — causes normal program termination with cleaning up (function) 🧚
• C documentation for _Exit — yes, the C docs, go look bestie 📚

mwah 💋 this lil page comes from http://cppreference.com, version/date 2024.06.10, and the page is literally std::_Exit(3) — byeee ✨