NAME

omni::application::terminate_handler::attach

A function of omni::application::terminate_handler

SYNOPSIS

Attach an omni::callback delegate to the terminate handler.

#include <omni/application.hpp>
void omni::application::terminate_handler::attach(const omni::callback& terminate_func)

top

DESCRIPTION

If std::terminate is invoked after having called an omni::application::run context, any attached delegates will be invoked in the order they were attached.

top

PARAMETERS top

terminate_func - The omni::callback delegate function to attach.

RETURN VALUES

No return value.

top

ERRORS

If an exception occurs on an attached delegate, it will be handled according to omni::sync::user_thread_exception and omni::sync::unhandled_thread_exception.

top

CONSIDERATIONS

This function will only have an effect if you have explicitly called one of the omni::application::run functions to block the main thread until program completion.

top

PLATFORM SPECIFIC

Nothing platform specific to account for.

top

NOTES

Be aware that the std::atexit function will call any functions in the reverse order registered. So if omni::application::run is called after any other calls to register a function with std::atexit in user code, then the underlying exit handler event will be called accordingly in order attached; in other words, if you were to call std::atexit(&some_function) then shutdown_handler::attach(&some_func) and call omni::application::run, the Omni exit handler will be called first, then some_function last.

top

EXAMPLE

Currently no examples.

Visit the examples page for more.

top