_countof
巨集
計算靜態配置陣列中的項目數目。
語法
#define _countof(array) (sizeof(array) / sizeof(array[0]))
參數
array
陣列的名稱。
傳回值
陣列中的元素數目,表示為 size_t
。
備註
_countof
會實作為類似函式的預處理器巨集。 C++版本具有額外的範本機制,以在編譯時期偵測是否傳遞指標,而不是靜態宣告的陣列。
請確定 array
實際上是陣列,而不是指標。 在 C 中,如果 array
為指標,_countof
則會產生錯誤的結果。 在 C++ 中,如果 array
是指針,_countof
則無法編譯。 當做參數傳遞至函式的數位會衰落至 指標,這表示在函式內,您無法用來 _countof
判斷陣列的範圍。
需求
Macro | 必要的標頭 |
---|---|
_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