Assegnare ad un Puntatore un'area di memoria riservata con Alloc()

Per riservare un'area di memoria, si può utilizzare la funzione Alloc():

Alloc(Dimensione As Variant, Count As Integer) As Pointer

Riservare, o allocare, un'area di memoria significa far sì che tale porzione di memoria venga protetta, ossia non venga sovrascritta dal sistema, sino a quando non sarà esplicitamente liberata/deallocata mediante la funzione "Free()".

L'allocazione della memoria avviene specificando la dimensione del tipo di valore, al quale i dati da scrivervi appartengono, ed il numero di byte (celle) di memoria da allocare. La dimensione totale della memoria riservata è dunque data dal prodotto dei due parametri della funzione "Alloc()".

L'area di memoria allocata viene puntata da una variabile di tipo Puntatore ^{[nota 1]} restituita dalla funzione "Alloc()". Il Puntatore referenzia una determinata porzione di memoria pari al prodotto del valore dei due argomenti della funzione "Alloc()" medesima. Questa variabile di tipo Puntatore, potendo essere considerata come una chiave di accesso all'allocazione di memoria, consente di gestire tale area di memoria riservata.
In particolare la funzione "Alloc()" alloca la quantità di memoria richiesta e restituisce una variabile di tipo Puntatore, ossia una variabile contenente l'indirizzo della prima cella dell'area di memoria riservata in questione.

Proprio in questo senso il Puntatore è una variabile di tipo generico, in quanto punta ad un'area di memoria di dimensione non pre-definita nativamente da Gambas (come invece è per quella delle altre variabili: Byte che occupa 1 byte, Short che occupa 2 byte, Integer che occupa 4 byte, e così via).

La memoria allocata rimane intatta fino a quando il programma non termina.

Liberare la memoria precedentemente allocata

Per liberare (deallocare) la porzione di memoria, precedentemente allocata, è necessario usare la funzione "Free()":

Free(puntatore)

Garantire che il Puntatore non punti a un indirizzo di memoria rilevante

Sebbene deallocata la memoria mediante la funzione "Free()", è possibile anche garantire che la variabile di tipo Puntatore non punti a un indirizzo di memoria rilevante, assegnando al Puntatore il valore di default zero: ^{[nota 2]}

...

Free(puntatore)

puntatore = 0

Uso di "Alloc()" con i valori numerici

Se la funzione "Alloc()" viene utilizzata con valori numerici, allora essa alloca un'area di memoria avente la dimensione indicata dal valore numerico moltiplicata per l'intero eventualmente indicato nella variabile Conta. Come valore predefinito la variabile Conta è uguale a 1:

Alloc(Dimensione AS Integer[, Conta AS Integer ]) As Pointer

Esempio essenziale:

Public Sub Main()

 Dim p As Pointer
 
' Alloca un'area di memoria pari a 1x64 byte:
 p = Alloc(SizeOf(gb.Byte), 64)
  
' Dealloca l'area di memoria precedentemente riservata:
 Free(p)
 
End

Uso di "Alloc()" con le stringhe

Se la funzione "Alloc()" viene utilizzata con valori di tipo stringa, essa alloca un'area di memoria contenente la stringa indicata:

Alloc(Stringa As String)  As Pointer

E' sufficiente in tal caso la sola specificazione in un parametro della stringa da allocare.

La dimensione dell'area di memoria allocata è uguale alla lunghezza della stringa più un ulteriore byte necessario al terminatore di stringa che è il carattere NULL.

Esempio essenziale:

Public Sub Main()

 Dim p As Pointer
 
' Alloca un'area di memoria con una Stringa:
 p = Alloc("Stringa qualsiasi")
  
' Dealloca l'area di memoria precedentemente riservata:
 Free(p)
 
End

---

Note

[1] L'uso di variabili di tipo Puntatore è in fondo il modo più vicino alla macchina per trattare i dati, poiché che la CPU accede ai dati in memoria tramite indirizzi (ovvero Puntatori).
Un Puntatore è una "variabile" che punta all'indirizzo di memoria di un'altra variabile. Infatti la variabile di tipo "Puntatore" contiene un indirizzo di memoria ed è particolarmente utile per la modifica di parametri mediante funzioni esterne. In Gambas non c'è bisogno di fare uso dei "Puntatori", perché solitamente si ricorre alle variabili "globali" che sono più semplici da gestire.

[2] Al riguardo vedere anche la seguente pagina: Deallocare un'area di memoria precedentemente allocata con alloc() e assicurarsi che il Puntatore non punti a un indirizzo rilevante di memoria