VarAllocate

VarAllocate(name1[,int2]) : int

Globalen Datenbereich oder dynamisches Array anlegen

Details

• name1: Name des globalen Datenbereichs
• int2: Anzahl der zu allokierenden Elemente
• Resultat: int Deskriptor der Datenbereichs-Instanz
• Siehe: Verwandte Befehle , VarInfo () , VarFree () , VarInstance () , VarCopy ()

Hiermit wird ein globaler Datenbereich (global) oder ein dynamisches Array im Hauptspeicher angelegt. Bei dynamischen Arrays ist darauf zu achten, dass die maximale Größe eines Arrays 4 MB nicht überschreiten darf.

Sofern ein globaler Datenbereich mehrfach angelegt wird, muss der zurückgelieferte Deskriptor gespeichert werden, um ein Umschalten zwischen den verschiedenen Instanzen des Datenbereichs zu ermöglichen (es kann nicht gleichzeitig auf verschiedene Instanzen eines Datenbereichs zugegriffen werden). Durch das Anlegen einer neuen Instanz wird diese sogleich zur aktuellen Instanz.

Beispiele:

// Der globale Datenbereich 'Common' wird angelegt
VarAllocate(Common);
// Das dynamische Array 'ValTbl' wird mit 500 Elementen angelegt.
VarAllocate(ValTbl, 500);

info

Die eindeutige Identifikation des Datenbereichs erfolgt über den Namen der Prozedur und den Namen des Datenbereichs. Ein angelegter Datenbereich, kann somit nur in der gleichen Prozedur freigegeben werden, in der der Datenbereich auch angelegt wurde.