assert (CRT)

项目
06/09/2015

则结果是，false打印一个诊断消息并中止程序时，计算表达式。

void assert( 
   int expression 
);

参数

expression
计算表达式 (包含指针)为非0或 0。

备注

实现 expression 参数通常使用 assert 宏确定逻辑错误。程序开发过程计算为 false，只有程序没有正确运行时。在调试完成后，检查断言可能已关闭，而不修改源文件。定义标识符 NDEBUG。 NDEBUG 可以定义 /D 与命令行选项或 #define 指令。如果 NDEBUG 使用 #define定义，必须在指令出现，ASSERT.H 是包括的过程。

assert 打印一个诊断消息，而 expression 的计算结果为 false (0) 时将调用中止终止程序执行。如果 expression 为 true，则不执行任何操作。诊断消息包括不合格的表达式、源文件中的断言发生失败的名称和行号。

诊断消息中宽字符输出。因此，它按预期工作，即使在表达式的 Unicode 字符。

诊断消息的目标依赖于调用例程应用程序的类型。控制台应用程序通过 stderr始终接收消息。在基于 Windows 的应用程序，调用 assert 函数以及确定 Windows 消息框创建消息框按钮时显示一条消息。当用户单击确定时，中止程序。

当应用程序将与运行库的调试版本时，assert 将创建带有三个按钮的消息框：中止、重试和忽略。如果用户单击中止，中止程序。如果用户单击重试，调试器调用，而且用户可以调试程序，如果实时 (JIT) 启用调试。如果用户单击忽略，assert 继续其常规执行：创建具有确定按钮的消息框。请注意，当错误条件存在导致“通常未定义的行为时”，单击。

有关 IntelliTrace 调试的更多信息，请参见zh712wwf(v=vs.120).md。

assert 例程可在发布版本和调试 C 运行库的版本。其他两 ASSERT 宏，_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
}