_countof
Makro
Vypočítá počet prvků v staticky přiděleném poli.
Syntaxe
#define _countof(array) (sizeof(array) / sizeof(array[0]))
Parametry
array
Název pole.
Vrácená hodnota
Počet prvků v matici vyjádřený jako size_t
.
Poznámky
_countof
se implementuje jako makro preprocesoru podobné funkci. Verze jazyka C++ obsahuje dodatečné stroje šablony, které lze zjistit v době kompilace, pokud je ukazatel předán místo staticky deklarovaného pole.
Ujistěte se, že array
je ve skutečnosti pole, nikoli ukazatel. V jazyce C vytváří chybné výsledky, _countof
pokud array
je ukazatel. V jazyce C++ se nepodaří zkompilovat, _countof
pokud array
je ukazatel. Pole předané funkci jako parametr se rozloží na ukazatel, což znamená, že v rámci funkce nemůžete určit _countof
rozsah pole.
Požadavky
Makro | Požadovaný hlavičkový soubor |
---|---|
_countof |
<stdlib.h> |
Příklad
// 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