std::atexit

 

C++

Язык

Заголовочные файлы

Концепты

Поддержка языка

Ошибка

Утилиты

Строки

Контейнеры

Алгоритмы

Итераторы

Работа с числами

Ввод/вывод

Локализация

Регулярные выражения (C++11)

Атомарные операции (C++11)

Потоки (C++11)

Файловая система (C++17)

Технические спецификации

 

Утилиты библиотеки

Поддежка типов (базовые типы, RTTI, type traits)

Динамическое управление памятью

Обработка ошибок

Управление жизненным циклом программы

Функции с переменным числом аргументов

Дата и время

Функциональные объекты

initializer_list Шаблон:lines

bitset

hash Шаблон:lines

Реляционные операторы

rel_ops::operator!=rel_ops::operator>rel_ops::operator<=rel_ops::operator>=

Пары и кортежи

pair

tuple Шаблон:lines

piecewise_construct_t Шаблон:lines

piecewise_construct Шаблон:lines

Обмен, передача и перемещение

swap

forward Шаблон:lines

move Шаблон:lines

move_if_noexcept Шаблон:lines

declval Шаблон:lines

 

Коммунальные услуги Программа поддержки

Программа прекращения Оригинал: Program termination Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
abort exit quick_exit Шаблон:lines _Exit Шаблон:lines	atexit at_quick_exit Шаблон:lines EXIT_SUCCESSEXIT_FAILURE
Взаимодействие с окружающей средой Оригинал: Communicating with the environment Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
system	getenv
Сигналы Оригинал: Signals Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
signal raise sig_atomic_t	SIG_DFLSIG_IGN SIG_ERR
Сигнал типа Оригинал: Signal types Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
SIGABRTSIGFPESIGILLSIGINTSIGSEGVSIGTERM
Нелокальные переходы Оригинал: Non-local jumps Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
setjmp
longjmp
Типы Оригинал: Types Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
jmp_buf

 

Defined in header <cstdlib>
extern "C"   int atexit( void (*func)() );
extern "C++" int atexit( void (*func)() );

Регистрирует указатель функции func, которая будет вызвана во время обычного завершения программы (с помощью std::exit()) или возврата из функции main.

Функции будут вызваны во время разрушения статических объектов в обратном порядке: если функция A была зарегистрирована до B, то вызов B будет сделан раньше вызова функции A. Это правило применимо и для определения порядка между вызовами конструктора статических объектов и вызовами atexit (смотрите std::exit)	(до C++11)
Функции могут быть вызваны одновременно с деструкторами объектов со статическим временем хранения и с друг с другом, но гарантируется, что если регистрация для A была до регистрации B, то вызов B будет до вызова A, то же самое применимо для последовательности между конструкторами статических объектов и вызовами atexit (смотрите std::exit )	(начиная с C++11)

Одна и та же функция может быть зарегистрирована несколько раз.

Если из-за выполнения функции возникнет исключение, то будет вызван std::terminate.

atexit - потокобезопасен: вызов этой функции из разных потоков не создаст условий гонки.

От реализации требуется поддержка регистрации как минимум 32 функций. Истинный предел зависит от реализации.

Параметры

func

—

Указатель на функцию, которая будет вызвана при нормальном завершении программы.

Возвращаемое значение

Если регистрация успешна, то будет возвращён ​0​, иначе она не удалась.

Примечание

Две перезагрузки различны, так как типы параметров func различны.

Исключения

(нет)	(до C++11)
спецификация noexcept:   noexcept	(начиная с C++11)

Пример

Запустить этот код

#include <iostream>
#include <cstdlib>
 
void atexit_handler_1() 
{
    std::cout << "Обработчик №1\n";
}
 
void atexit_handler_2() 
{
    std::cout << "Обработчик №2\n";
}
 
int main() 
{
    const int result_1 = std::atexit(atexit_handler_1);
    const int result_2 = std::atexit(atexit_handler_2);
 
    if ((result_1 != 0) or (result_2 != 0)) {
        std::cerr << "Регистрация не удачная\n";
        return EXIT_FAILURE;
    }
 
    std::cout << "Возвращение из main\n";
    return EXIT_SUCCESS;
}

Вывод:

Возвращение из main
Обработчик №2
Обработчик №1

См. также

at_quick_exit (C++11)	Регистрирует функцию, которая вызывается при вызове quick_exit (функция)
Справка по C — atexit