assert(3) | Library Functions Manual | assert(3) |
ИМЯ
assert - прекращает работу программы при ложном утверждении
БИБЛИОТЕКА
Стандартная библиотека языка C (libc, -lc)
СИНТАКСИС
#include <assert.h>
void assert(scalar expression);
ОПИСАНИЕ
Данный макрос помогает программистам находить ошибки в своих программах или обрабатывать исключительные случаи посредством завершения программы, при котором выводится немного отладочной информации.
Если expression ложно (т. е., при сравнении равно нулю), то assert() печатает сообщение об ошибке в стандартный поток ошибок и завершает программу вызовом abort(3). Сообщение об ошибке содержит имя файла и функцию, содержащую вызов assert(), номер строки исходного кода вызова и текст аргумента; пример:
prog: some_file.c:16: some_func: Assertion `val == 0' failed.
Если определён макрос NDEBUG на момент включения последнего <assert.h>, то макрос assert() не генерирует код, и, следовательно ничего вызывает. Не рекомендуется определять NDEBUG, если assert() используется для обнаружения ошибок условий, так как ПО может повести себя непредсказуемо.
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
Ничего не возвращается.
АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение |
assert() | Безвредность в нитях | MT-Safe |
СТАНДАРТЫ
C11, POSIX.1-2008.
ИСТОРИЯ
C89, C99, POSIX.1-2001.
In C89, expression is required to be of type int and undefined behavior results if it is not, but in C99 it may have any scalar type.
ОШИБКИ
Функция assert() реализована в виде макроса. Если проверка выражения приводит к побочным изменениям, то поведение программы будет различным в зависимости от наличия NDEBUG. Это может создавать гейзенбаг, который исчезает при включении отладки.
СМОТРИТЕ ТАКЖЕ
ПЕРЕВОД
Русский перевод этой страницы руководства разработал(и) Dmitry Bolkhovskikh <d20052005@yandex.ru> и Yuri Kozlov <yuray@komyakino.ru>
Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.
Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков.
2 мая 2024 г. | Справочные страницы Linux 6.9.1 |