Array multidimensionali con numero indeterminato di elementi

In Gambas vi sono Array (vettori) che non hanno un numero determinato degli elementi costituenti le loro dimensioni, e Array (vettori), ai quali viene in sede di definizione specificato il numero dei propri elementi costitutivi delle loro dimensioni.

Dichiarazione di un array multidimensionale di numero non definito di elementi

Un array a due dimensioni di numero non definito di elementi, si dichiara nel modo seguente (esempio di Array di tipo Stringa contenente Array di tipo Stringa):

Dim arrArr As String[][]   [nota 1]

Istanziazione implicita con inizializzazione esplicita

La istanziazione implicita - con inizializzazione esplicita - di un array di numero non definito di elementi sarà effettuata così:

arrArr = [["a", "b"], ["c", "d"], ["e", "f"]]

Verificando, quindi, la quantità di elementi (che contengono array) presenti nel caso precedente all'interno della variabile array, si avrà il risultato di: 3

Public Sub Main()

 Dim arrArr As String[][]

  arrArr = [["a", "b"], ["c", "d"], ["e", "f"]]

  Print arrArr.Count

End

Per sapere la quantità di elementi contenuti in un elemento array della variabile array, è necessaria l'istanziazione esplicita dell'array mediante la parola-chiave New:

 Public Sub Main()

 Dim arrArr As New String[][]

  arrArr = [["a", "b"], ["c", "d"], ["e", "f"]]

' Vogliamo sapere la quantità di elementi presenti nel 2° elemento (che è un array) della variabile array bidimensionale:
  Print arrArr[1].Count

End

Il risultato sarà: 2.

Per vedere il contenuto di ciascun elemento:

Public Sub Main()

 Dim arrArr As String[][] = [["a", "b"], ["c", "d"], ["e", "f"]]
 Dim j As Byte

  For j = 0 To arrArr[0].Max
    Print arrArr[0][j], arrArr[1][j], arrArr[2][j]
  Next

End

Per eliminare ad esempio un elemento dall'interno di una dimensione dell'array:

Public Sub Main()

 Dim arrArr As String[][]
 
  arrArr = [["a", "b"], ["c", "d"], ["e", "f"]["g", "h"]]
   
  Print arrArr.Count
   
  Print arrArr[2].Count
   
  arrArr[2].Remove(0)

  Print arrArr[2].Count

End

Rappresentazione delle dimensioni di un array multidimensionale di numero non definito di elementi

Va dunque precisato che durante l'uso di una variabile di tipo array, la rappresentazione

variabile[n][n]

il numero presente nelle prime parentesi quadre di variabile[][] individua l'elemento della prima dimensione della variabile[][]. Il numero, invece, presente nelle altre due parentesi quadre di variabile[][] individua l'elemento dell'elemento della prima dimensione.

Pertanto, se abbiamo una variabile[][] (bidimensionale) così istanziata:

variabile[][] = [[11, 22, 33], [77, 88, 99]]

ponendo:

Print variabile[1][2]

con [1] è individuato il secondo elemento della prima dimensione, mentre con [2] è individuato il terzo elemento del predetto secondo elemento della prima dimensione, ossia:

[[11, 22, 33], [77, 88, 99]]

Aggiungere elementi dinamicamente ad un array multidimensionale

Se l'array bidimensionale non ha un numero definito dei suoi elementi, esso è un vettore dinamico, ed è possibile aggiungere suoi elementi come segue:

Public Sub Main()

 Dim bb As New Byte[][]

' Viene aggiunto un elemento alla seconda dimensione, nonché il 1° elemento al predetto nuovo elemento della seconda dimensione:
 bb.Push([1])
 Print bb[0][0]
  
' Viene aggiunto un altro elemento alla seconda dimensione, nonché il 1° elemento al predetto nuovo elemento della seconda dimensione:
 bb.Push([2])
 Print bb[1][0]
 
' Viene aggiunto un altro elemento alla seconda dimensione, nonché il 1° e il 2° elemento al predetto nuovo elemento della seconda dimensione:
 bb.Push([3, 33])
 Print bb[2][0], bb[2][1]

End  

oppure:

Public Sub Main()

 Dim bb As New Byte[][]
     
' Viene aggiunto il 1° elemento della prima dimensione:
  bb.Push([])
  
' Vengono aggiunti degli elementi al nuovo 1° elemento della prima dimensione:
  bb[0].Push(10)
  bb[0].Push(11)
  
  Print bb[0][0]
  Print bb[0][1]
  
' Viene aggiunta un ulteriore elemento alla prima dimensione:
  bb.Push([])
  
' Vengono aggiunti degli elementi al nuovo 2° elemento della prima dimensione:
  bb[1].Push(20)
  bb[1].Push(21)
  
  Print bb[1][0]
  Print bb[1][1]
  
End

Aggiungere dinamicamente variabili vettoriali ad un Array multidimensionale

Conseguentemente ed ovviamente tali array multidimensionali possono contenere nei loro elementi variabili array monodimensionali.

Esempio:

Public Sub Main()

 Dim ss As New String[][]
 Dim s1, s2 As New String[]
 

' Assegnamo dei valori ale due variabili array
' che saranno contenute nella variabile array principale:
  s1 = ["a", "b"]
  s2 = ["c", "d", "e"]
 
' Assegnamo le due precedenti variabili array alla variabile array principale:
  ss = [s1, s2]

' Andiamo a vedere la quantità di elementi contenuti dalla variabile array principale,
' nonché da ciascuna variabile array individuandole all'interno della variabile array principale:
  Print ss.Count, ss[0].Count, ss[1].Count

End

oppure più dinamicamente:

Public Sub Main()

 Dim ss As New String[][]
 Dim s1, s2 As New String[]
 

' Assegnamo dei valori ale due variabili array
' che saranno contenute nella variabile array principale:
  s1 = ["a", "b"]
  s2 = ["c", "d", "e"]
 
' Assegnamo le due precedenti variabili array alla variabile array principale:
  ss.Push(s1)
  ss.Push(s2)

' Andiamo a vedere la quantità di elementi contenuti dalla variabile array principale,
' nonché da ciascuna variabile array individuandole all'interno della variabile array principale:
  Print ss.Count, ss[0].Count, ss[1].Count

End

Vediamo anche quest'altro esempio:

Public Sub Main()
 
 Dim vettore As Byte[]
 Dim multi As New Byte[][]
 Dim b As Byte
  
  For b = 2 To 9
  
' Creiamo un semplice vettore monodimensionale...
    vettore = New Byte[b]
  
' ...e lo aggiungiamo al array multidimensionale:
    multi.Push(vettore)
    
  Next
   
' Assegnamo un valore ad un elemento di un vettore contenuto dall'array multidimensionale e verifichiamo in console:
  multi[7][5] = 24
   
  Print multi[7][5]
   
End

Array multidimensionale a tre dimensioni

Potremo anche creare ed utilizzare una variabile array tridimensionali (un array contenente array che contengono a loro volta altri array).

Tale variabile tridimensionale sarà così dichiarata (esempio con una variabile di tipo Stringa):

Dim arrArr As String[][][]

Esempio:

Public Sub Main()

 Dim ss As New String[][][]


 ss = [[["a", "b"], ["c", "d"], ["e", "f"]], [["g", "h"], ["i", "l", "m", "n"], ["o", "p"]]]

' Vogliamo sapere la quantità di elementi (che sono array) presenti nella variabile array
' (il risultato sarà in questo caso "2"):
  Print ss.Count

' Vogliamo sapere la quantità di elementi (che sono array) presenti nel secondo elemento della variabile array
' (il risultato in questo caso sarà "3"):
  Print ss[1].Count

' Volendo scendere ancora di livello, per conoscere la quantità di elementi presenti nel secondo elemento
' del secondo elemento superiore della variabile array (il risultato in questo caso sarà "4"):
  Print ss[1][1].Count

End

Molteplici array di array

Ovviamente si potranno creare variabili array contenenti ulteriori e molteplici array di array al proprio interno.

Array che contiene insieme sia singoli valori che altri array

Per creare un vettore che contenga sia dei valori che altri vettori, è necessario usare il tipo di variabile Variant:

Public Sub Main()

 Dim v As Variant[] = [1, 2, 3, 4]

  v.Add([5, 6, 7])
   
  Print v[0]
  Print v[1]
  Print v[2]
  Print v[3]
  Print v[4][0]
  Print v[4][1]
  Print v[4][2]

  v.Add([8, 9, [10, 11, 12]])

  Print v[5][0]
  Print v[5][1]
  Print v[5][2][0]
  Print v[5][2][1]
  Print v[5][2][2]

End

Sostituire un valore in un elemento, contenente un singolo valore, con un array

E' possibile sostituire, ovviamente in un elemento un singolo valore con un array, e viceversa:

Public Sub Main()

 Dim v1, v2 As Variant[]

  v1 = [1, 2, 3, 4]
  v2 = [5, 6, 7]

  v1[2] = v2

  Print v1[0]
  Print v1[1]
  Print v1[2][0]
  Print v1[2][1]
  Print v1[2][2]
  Print v1[3]

End

Note

[1] Possiamo dire che:

• nel vettore monodimensionale

Dim vettore As Integer[]

vengono contenuti valori non vettoriali:

vettore = [1, 2, 3, 4]

• nel vettore bidimensionale

Dim vettore As Integer[][]

vengono contenuti due o più vettori monodimensionali

vettore = [ [1, 2, 3, 4], [5, 6, 7, 8] ]

• nel vettore tridimensionale

Dim vettore As Integer[][][]

vengono contenuti due o più vettori bidimensionali

 vettore = [ [ [1, 2, 3, 4], [5, 6, 7, 8] ], [ [9, 8, 7, 6], [5, 4, 3, 2] ] ]

e così via con gli altri multidimensionali.