Dir Function

Dir palauttaa tiedoston tai kansion nimen tai kaikkien tiedostojen ja kansioiden nimet levyltÀ tai hakemistosta, joka vastaa mÀÀrÀttyÀ hakupolkua.

Syntaksi:

Dir [(teksti1 As String) [, attribuutti1 As Integer]]

Palautusarvo:

merkkijono (String)

Parametrit:

Teksti1: merkkijonolause, joka mÀÀrittÀÀ hakupolun, kansion tai tiedoston. TÀmÀ argumentti voidaan mÀÀrittÀÀ vain ensimmÀisellÀ Dir-funktion kutsukerralla. Tarvittaessa voidaan kÀyttÀÀ URL-esitysmuotoa.

Attribuutti1: kokonaislukulauseke, joka mÀÀrittÀÀ tiedostomÀÀreet biteittÀin. Dir-funktio palauttaa vain tiedostot tai kansiot, jotka tÀsmÀÀmÀt asetettuihin mÀÀreisiin. Useita mÀÀreitÀ voi yhdistÀÀ laskemalla arvot yhteen:

0 : tavalliset tiedostot.

16 : palauttaa vain kansion nimen.

TÀtÀ mÀÀrettÀ voi kÀyttÀÀ kansion olemassaolon tarkistamisen tai kansion kaikkien tiedostojen ja alikansioiden mÀÀrÀÀmiseen.

Kun halutaan tarkistaa, onko tiedostoa olemassa, kirjoitetaan polku ja tiedostonimi kokonaan. Jos tiedostoa tai kansioita ei ole, Dir-funktio palauttaa nolla-pituisen merkkijonon ("").

To generate a list of all existing files in a specific directory, proceed as follows: The first time you call the Dir function, specify the complete search path for the files, for example, "D:\Files\*.ods". If the path is correct and the search finds at least one file, the Dir function returns the name of the first file that matches the search path. To return additional file names that match the path, call Dir again, but with no arguments.

To return directories only, use the attribute parameter. The same applies if you want to determine the name of a volume (for example, a hard drive partition).

Error codes:

5 Virheellinen proseduurikutsu

53 Tiedostoa ei löydy

Esimerkki:

Sub ExampleDir

' NÀytetÀÀn kaikki tiedostot ja kansiot

Dim sPath As String

Dim sDir As String, sValue As String

    sDir="Kansiot:"

    sPath = CurDir

    sValue = Dir$(sPath + getPathSeparator + "*",16)

    Do

        If sValue <> "." And sValue <> ".." Then

            If (GetAttr( sPath + getPathSeparator + sValue) And 16) >0 Then

                ' haetaan kansiot

                sDir = sDir & chr(13) & sValue

            End If

        End If

        sValue = Dir$

    Loop Until sValue = ""

    MsgBox sDir,0,sPath

End Sub