assertのヘルプ・マニュアル／リナックスコマンド

assertのヘルプ・マニュアル

help
man

assert --help

man assert

ASSERT(3) Linux Programmer’s Manual ASSERT(3) 名前 assert - 診断が偽の時にプログラムを中止する書式 #include void assert(scalar expression); 説明が最後にインクルードされた時点で、 NDEBUG マクロが定義されていた場合、 assert() マクロは何のコードも生成せず、従って全く何もしない。さもなければ、 assert(3) マクロは expression が偽の時(すなわち、比較の結果が0と等しい時)に標準エラー出力にエラーメッセージを表示し、さらに abort() を呼び出すことによって、プログラムを終了させる。このマクロの目的は、プログラマーがプログラムのバグを発見する手助けをすることである。"assertion failed in file foo.c, function do_bar(), line 1287" というメッセージはユーザーには何の助けにもならない。返り値値は返されない。準拠 POSIX.1-2001, C89, C99. C89 では expression は int 型であることが必要とされ、そうでない場合の動作は未定義とされていた。しかし C99 ではどのようなスカラ値でもよいことになった。バグ assert() は、マクロとして実装されている。すなわち、試されている式が副作用を持っている場合には、マクロ NDEBUG が定義されているかどうかに依存して、プログラムの振舞いは異なるだろう。これによって、バグ出しするときには消えてしまうハイゼンバグ(Heisenbugs)を生み出すだろう。関連項目 abort(3), assert_perror(3), exit(3) GNU 2002-08-25 ASSERT(3)

ASSERT(3) Linux Programmer’s Manual ASSERT(3) NAME assert - abort the program if assertion is false SYNOPSIS #include void assert(scalar expression); DESCRIPTION If the macro NDEBUG was defined at the moment was last included, the macro assert() generates no code, and hence does nothing at all. Otherwise, the macro assert() prints an error message to stan- dard error and terminates the program by calling abort(3) if expression is false (i.e., compares equal to zero). The purpose of this macro is to help the programmer find bugs in his program. The message "assertion failed in file foo.c, function do_bar(), line 1287" is of no help at all to a user. RETURN VALUE No value is returned. CONFORMING TO POSIX.1-2001, C89, C99. 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. BUGS assert() is implemented as a macro; if the expression tested has side- effects, program behavior will be different depending on whether NDEBUG is defined. This may create Heisenbugs which go away when debugging is turned on. SEE ALSO abort(3), assert_perror(3), exit(3) COLOPHON This page is part of release 3.22 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/. GNU 2002-08-25 ASSERT(3)

リナックスコマンド