Palauttaa Variant-muuttujan, joka sisältää matriisin.
Syntaksi
Array( arglist )
Vaadittu arglistargumentti on pilkuilla rajattu arvoluettelo, joka määritetään Variant-muuttujan sisältämän matriisin elementeille. Jos mitään argumenttia ei ole määritetty, luodaan tyhjä matriisi.
Huomautuksia
Matriisin elementtiin viittaavassa merkinnässä on muuttujan nimi ja sitten sulkeissa halutun elementin ilmaiseva indeksiluku. Seuraavassa esimerkissä ensimmäinen lauseke luo muuttujan nimeltä AVariant-muuttujaksi. Toinen lauseke määrittää matriisiin muuttujalle A. Viimeisessä lausekkeessa määritetään toisen matriisielementin sisältämä arvo toiselle muuttujalle.
Huomautus: Seuraavissa esimerkeissä kerrotaan, kuinka tätä funktiota käytetään Visual Basic for Applications (VBA) -moduulissa. Jos haluat lisätietoja VBA:n käytöstä, valitse Sovelluskehittäjän opasHaku-kentän viereisestä luettelosta ja anna yksi tai useampi hakuehto hakukenttään.
Dim A As Variant
A = Array(10,20,30)
B = A(2)
Matriisin alaraja, joka luodaan Array-funktion avulla, määräytyy Option Base -lausekkeessa määritetyn alarajan mukaan, jollei Array-funktiota määritetä tyyppikirjaston nimen avulla (esimerkiksi VBA.Array). Jos se määritetään tyyppikirjaston nimen avulla, Option Base ei vaikuta Array-funktioon.
Huomautus: Variant-muuttuja, jota ei ole määritetty matriisiksi, voi silti sisältää matriisin. Variant-muuttuja voi sisältää minkä tahansa matriisityypin, paitsi kiinteän pituisia merkkijonoja ja käyttäjän määrittämiä tyyppejä. Vaikka matriisin sisältämä Variant-muuttuja eroaa käsitteellisesti matriisista, jonka elementit ovat Variant-muuttujan tyyppiä, matriisin elementtejä voi käyttää samalla tavalla.
Esimerkki
Tämä esimerkki käyttää Array-funktiota palauttamaan Variant-muuttujan, joka sisältää matriisin.
Dim MyWeek, MyDay
MyWeek = Array("Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun")
' Return values assume lower bound set to 1 (using Option Base
' statement).
MyDay = MyWeek(2) ' MyDay contains "Tue".
MyDay = MyWeek(4) ' MyDay contains "Thu".
