<p class="Head1"><help:link Id="66557">Funkce Dir [Runtime]</help:link></p>
<p class="Paragraph">Vrátí název souboru, adresáře nebo všechny soubory a složky na jednotce nebo v adresáři, který je shodný se zadanou cestou pro vyhledávání.</p>
<p class="Paragraph">Text: Libovolný řetězec, který určuje cestu, adresář nebo soubor pro vyhledávání. Tento argument je nutno zadat pouze při prvním volání funkce Dir. Jako parametr lze také použít <help:link Id="66636" Eid="urllocal" xmlns:help="http://openoffice.org/2000/help">adresu URL</help:link>.</p>
<p class="Paragraph">Atribut: Libovolný celočíselný výraz, který určuje atributy souboru pro jednotlivé bity. Funkce Dir vrátí pouze soubory nebo adresáře, které odpovídají zadaným atributům. Různé atributy lze kombinovat přidáním hodnot atributů:</p>
<p class="Paragraph">16 : Vrátí pouze název adresáře.</p>
<p class="Paragraph">Touto funkcí lze ověřit, zda soubor nebo adresář existuje, nebo ji lze využít k vyhledání všech souborů a složek v určitém adresáři.</p>
<p class="Paragraph">Chcete-li ověřit, zda soubor existuje, zadejte úplný název cesty a název souboru. Pokud funkce Dir vrátí název, adresář nebo soubor existuje. Pokud se žádné názvy souborů nebo adresářů neshodují, vrátí funkce Dir řetězec s nulovou délkou ("").</p>
<p class="Paragraph">Chcete-li vytvořit seznam všech souborů, které se nacházejí v určitém adresáři, postupujte následujícím způsobem: Při prvním volání funkce Dir zadejte úplnou cestu pro vyhledání souborů, např. D:\OFFICE4\*.SDW. Pokud je cesta správná a byl nalezen alespoň jeden soubor, vrátí funkce název prvního souboru, který se shoduje s vyhledávanou cestou. Chcete-li, aby funkce vrátila všechny další soubory, které se shodují s názvem cesty, volejte funkci Dir bez argumentů. Pokud funkce Dir vrátí řetězec s nulou délkou (""), neexistují žádné názvy soubory, jejichž názvy by se shodovaly s kritérii pro hledání.</p>
<p class="Paragraph">Chcete-li, aby funkce vrátila pouze adresáře, použijte parametr atributu. Stejný postup použijte, pokud chcete určit název svazku (např. oddílu na pevném disku).</p>
<p class="P2">Příklad:</p>
<p class="PropText">Sub ExampleDir</p>
<p class="PropText">REM Displays all files and directories</p>
<p class="PropText">Dim sFile as String, sPath As String</p>
<p class="PropText">Dim sDir as String, sValue as String</p>