Compartilhar via


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

Confira também

sizeof Operador