Vrátí variant (Typ dat Variant: Výchozí typ dat pro proměnné, které neobsahují znaky deklarace typu, není-li aktivní příkaz Deftyp. V proměnné typu Variant mohou být uložena čísla, řetězce, datum a čas nebo hodnoty Null či Empty.) obsahující matici (Pole: Proměnná obsahující konečný počet prvků, které mají společný název a typ dat. Každý prvek v poli je označen jedinečným indexem. Změny provedené u jednoho prvku v poli nemají na ostatní prvky žádný vliv.).
Syntaxe
Array(seznam_argumentů)
Požadovaný argument (Argument: Hodnota, která poskytuje informace určité akci, události, metodě, vlastnosti, funkci nebo proceduře.) seznam_argumentů představuje čárkami oddělený seznam hodnot přiřazených k prvkům matice obsažené ve variantu. Pokud nejsou zadány žádné argumenty, je vytvořena matice s nulovou délkou.
Poznámky
Zápis použitý jako odkaz na prvek matice se skládá z názvu proměnné (Proměnná: Pojmenované umístění pro ukládání, které může obsahovat data, jež lze během doby spuštění programu změnit. Každá proměnná má název, jež ji v dané úrovni oboru jednoznačně identifikuje. Typ dat může, ale nemusí být zadán.), za kterým následuje v závorkách uzavřené indexové číslo označující požadovaný prvek. V následujícím příkladu vytváří první příkaz (Příkaz: Syntakticky úplná jednotka, která vyjadřuje jeden konkrétní druh operace, deklarace nebo definice. Příkaz je v proceduře nebo oddílu deklarací obvykle uveden na samostatném řádku, ale na řádek je možné zadat i dva či více příkazů oddělených středníky (;).) proměnnou s názvem A jako variantem. Druhý příkaz přiřazuje matici k proměnné A. Poslední příkaz přiřazuje hodnotu obsaženou v druhém prvku matice k jiné proměnné.
Dim A As Variant
A = Array(10,20,30)
B = A(2)
Dolní mez matice vytvořené pomocí funkce Array je určena dolní mezí zadanou příkazem Option Base, pokud není funkce Array kvalifikována na základě názvu knihovny typů (například VBA.Array). Je-li kvalifikována na základě názvu knihovny typů, není funkce Array příkazem Option Base ovlivněna.
Poznámka: I variant, který není deklarován jako matice, může obsahovat matici. Proměnná Variant může obsahovat matici libovolného typu kromě řetězců s pevnou délkou a uživatelem definovaných typů (Typ dat definovaný uživatelem: Definice typu dat, jež může obsahovat sloupec v databázi serveru Microsoft SQL Server. Je zadán uživatelem pomocí existujících systémových typů dat. Pravidla a výchozí hodnoty mohou být vázány pouze k typům dat definovaným uživatelem.). Ačkoli variant obsahující matici je koncepčně odlišný od matice, jejíž prvky jsou typu Variant, přistupuje se k prvkům matice stejným způsobem.
Příklad
V tomto příkladu se pomocí funkce Array vrací variant obsahující matici.
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".