Macro _countof
Calcula o número de elementos em uma matriz alocada estaticamente.
Sintaxe
#define _countof(array) (sizeof(array) / sizeof(array[0]))
Parâmetros
array
O nome de uma matriz.
Valor retornado
O número de elementos na matriz, expresso como um size_t.
Comentários
_countof é implementada como uma macro de pré-processador semelhante a uma função. A versão C++ tem computadores de modelo extras para serem detectados em tempo de compilação se um ponteiro for passado em vez de uma matriz declarada estaticamente.
Verifique se array é realmente uma matriz, não um ponteiro. Em C, _countof produzirá resultados incorretos se array for um ponteiro. Em C++, _countof falhará ao ser compilado se array for um ponteiro. Uma matriz passada como um parâmetro para uma função decai para um ponteiro, significando que, dentro da função, não é possível usar _countof para determinar a extensão da matriz.
Requisitos
| Macro | Cabeçalho necessário |
|---|---|
_countof |
<stdlib.h> |
Exemplo
// 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