3.9 DM_Calloc

Mit Hilfe dieser Funktion können Sie Speicherplatz allokieren. Diese erfolgt dabei abhängig vom zugrundeliegenden Betriebssystem mit den dort verfügbaren Funktionen. Über diese Funktion allokierter Speicher darf nur mit der Funktion DM_Free freigegeben werden bzw. mit DM_Realloc verändert werden.

DM_Pointer DML_default DM_EXPORT DM_Calloc
(
  DM_UInt4 nelem,
  DM_UInt4 elsize
)

Parameter

-> DM_UInt4 nelem

Dieser Parameter gibt die Anzahl der Elemente an, die allokiert werden soll.

-> DM_UInt4 elsize

Dieser Parameter gibt die Größe eines zu allokierenden Elements an.

Rückgabewert

Pointer auf den allokierten Speicherbereich. Wenn der Speicher nicht allokiert werden konnte, wird der NULL-Pointer zurückgegeben.

Im Gegensatz zu DM_Malloc wird der Speicher auf 0 initialisiert.

Beispiel

Für die DM_Content-Struktur soll für 10 Elemente Speicher allokiert werden.

DM_Content *content;

 

if ((content = DM_Calloc (10, sizeof (DM_Content))

{

    ...

}