Vrátí hodnotu typu Boolean označující, zda byla 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.)
inicializována.
Syntaxe
IsEmpty(výraz)
Povinným argumentem (Argument: Hodnota, která poskytuje informace určité akci, události, metodě, vlastnosti, funkci nebo proceduře.)
výraz
je hodnota typu 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í číselný výraz (Číselný výraz: Libovolný výraz, jehož výsledkem je číslo. Výraz může být libovolnou kombinací proměnných, konstant, funkcí a operátorů.)
nebo řetězcový výraz (Řetězcový výraz: Výraz, který je vyhodnocen jako posloupnost sousedících znaků. Prvky výrazu mohou zahrnovat: funkce vracející řetězec nebo řetězec typu Variant (VarType 8), řetězcový literál, konstantu, proměnnou nebo řetězec typu Variant</.). Avšak vzhledem k tomu, že funkce IsEmpty slouží ke zjištění skutečnosti, zda jsou inicializovány jednotlivé proměnné, představuje argument výraz nejčastěji název jedné proměnné.
Poznámky
Pokud daná proměnná není inicializována nebo je explicitně nastavena na hodnotu Empty (Stav Empty: Stav neinicializované proměnné Variant (jako hodnotu atributu VarType vrací nulu). Nelze jej zaměňovat se stavem Null (stav proměnné označující neplatná data), s proměnnými obsahujícími řetězce s nulovou délkou ("") ani s číselnými proměnnými s hodnotou nula.), vrátí funkce IsEmpty hodnotu True. V opačném případě vrátí hodnotu False. Hodnota False je vždy vrácena v případě, že argument výraz obsahuje více proměnných. Informace vrácené funkcí IsEmpty mají význam pouze u dat typu 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.).
Příklad
Poznámka: Následující příklady uvádějí použití této funkce v modulu jazyka Visual Basic for Applications (VBA). Další informace o práci s jazykem VBA získáte tak, že klepnete na položku Referenční informace pro vývojáře v rozevíracím seznamu vedle pole Hledat a do pole pro hledání zadáte jeden nebo více pojmů.
V tomto příkladu je pomocí funkce IsEmpty zjištěno, zda byla proměnná inicializována.
Dim MyVar, MyCheck
MyCheck = IsEmpty(MyVar) ' Returns True.
MyVar = Null ' Assign Null.
MyCheck = IsEmpty(MyVar) ' Returns False.
MyVar = Empty ' Assign Empty.
MyCheck = IsEmpty(MyVar) ' Returns True.