assert (CRT)
,该结果是 false,打印一个诊断信息并中止程序时,计算表达式。
void assert(
int expression
);
参数
- expression
计算为非零或 0 的表达式 (包括指针)。
备注
实现 expression 参数通常用于 assert 宏标识逻辑错误在项目开发过程中计算为 false ,仅当程序不正确时运行。在调试完成之后,断言检查可禁用,而不修改源文件来定义该标识符 NDEBUG。NDEBUG 可以定义与 /D 命令行选项或与 #define 指令。如果 NDEBUG 定义与 #define,指令必须出现,在 ASSERT.H 包括的过程。
assert 打印一个诊断消息,请 expression 计算结果为 false (0) 时将调用 中止 程序停止执行。执行任何操作,如果 expression 是 true (非零)。诊断消息包含失败的表达式、源文件的名称和断言失败的行号。
诊断消息。宽字符打印。因此,它按预期工作,即使有该表达式的 Unicode 字符。
诊断消息的目标依赖于调用实例应用程序的类型。控制台应用程序。 stderr始终接收消息。在基于 windows 的应用程序, assert 调用 windows MessageBox 函数创建消息框与 好 按钮时显示消息。当用户单击 好时,程序中止。
当应用程序与运行库时的调试版本链接, assert 有三个按钮创建一个消息框: 中止、 重试和 忽略。如果用户单击 中止,程序中止。如果用户单击 重试,调试器将调用,并且用户可以调试程序,则启用实时 (JIT)调试时。如果用户单击 忽略, assert 继续其正常执行:创建消息框。 好 按钮。,当错误条件存在会导致未定义的行为时,请注意,单击 " 忽略 。
有关调试的 CRT 的更多信息,请参见 调试技术的 CRT。
assert 实例可在版本和调试 C 运行库的版本。其他两个断言宏, _ASSERT 和 _ASSERTE,也可用,但是,只有计算表达式传递给它们,当 _DEBUG 标志定义时。
要求
实例 |
必需的头 |
---|---|
assert |
assert.h |
示例
在此过程中, analyze_string 函数使用 assert 功能测试多个条件。字符串和长度相关。如果任何一个条件失败,程序输出消息指示导致该失败。
// crt_assert.c
// compile with: /c
#include <stdio.h>
#include <assert.h>
#include <string.h>
void analyze_string( char *string ); // Prototype
int main( void )
{
char test1[] = "abc", *test2 = NULL, test3[] = "";
printf ( "Analyzing string '%s'\n", test1 ); fflush( stdout );
analyze_string( test1 );
printf ( "Analyzing string '%s'\n", test2 ); fflush( stdout );
analyze_string( test2 );
printf ( "Analyzing string '%s'\n", test3 ); fflush( stdout );
analyze_string( test3 );
}
// Tests a string to see if it is NULL,
// empty, or longer than 0 characters.
void analyze_string( char * string )
{
assert( string != NULL ); // Cannot be NULL
assert( *string != '\0' ); // Cannot be empty
assert( strlen( string ) > 2 ); // Length must exceed 2
}