_countof 宏

计算静态分配的数组中元素的数量。

语法

#define _countof(array) (sizeof(array) / sizeof(array[0]))

参数

array
数组的名称。

返回值

数组中的元素数，表示为 size_t。

注解

_countof 作为类似于函数的预处理器宏实现。 C++ 版本具有额外的模板机制，用于在编译时检测传递的是指针还是静态声明的数组。

确保 array 实际上是数组，而不是指针。 在 C 中，如果 array 是指针，则 _countof 将生成错误结果。 在 C++ 中，如果 array 是指针，则 _countof 将无法编译。 作为参数传递给函数的数组会衰减为指针，这意味着在函数中，不能使用 _countof 确定数组的范围。

要求

宏	必需的标头
_countof	<stdlib.h>

示例

// crt_countof.cpp
#define _UNICODE
#include <stdio.h>
#include <stdlib.h>
#include <tchar.h>

int main( void )
{
   _TCHAR arr[20], *p;
   printf( "sizeof(arr) = %zu bytes\n", sizeof(arr) );
   printf( "_countof(arr) = %zu elements\n", _countof(arr) );
   // In C++, the following line would generate a compile-time error:
   // printf( "%zu\n", _countof(p) ); // error C2784 (because p is a pointer)

   _tcscpy_s( arr, _countof(arr), _T("a string") );
   // unlike sizeof, _countof works here for both narrow- and wide-character strings
}

sizeof(arr) = 40 bytes
_countof(arr) = 20 elements

另请参阅

sizeof 运算符