DIR

DIR

Top  Previous  Next

Action

Returns the filename that matches the specified file mask.

 

 

Syntax

sFile = DIR(mask)

sFile = DIR()

 

 

Remarks

SFile

A string variable that is assigned with the filename.

Mask

A file mask with a valid DOS file mask like *.TXT

 

Use *.* to select all files.

 

The first function call needs a file mask. All other calls do not need the file mask. In fact when you want to get the next filename from the directory, you must not provide a mask after the first call.

 

Dir() returns an empty string when there are no more files or when no file name is found that matches the mask.

 

 

See also

INITFILESYSTEM , OPEN , CLOSE, FLUSH , PRINT, LINE INPUT, LOC, LOF , EOF , FREEFILE , FILEATTR , SEEK , BSAVE , BLOAD , KILL , DISKFREE , DISKSIZE , GET , PUT, FILELEN , FILEDATE , FILETIME , FILEDATETIME , WRITE , INPUT , MKDIR, RMDIR , CHDIR

 

 

ASM

Calls

_Dir ; with file mask

_Dir0 ; without file mask

Input

X : points to the string with the mask

Z : points to the target variable

Output

 

 

 

 

 

Partial Example

 

'Lets have a look at the file we created

Print "Dir function demo"

S = Dir("*.*")

'The first call to the DIR() function must contain a file mask

' The * means everything.

'

While Len(s)> 0 ' if there was a file found

  Print S ;" ";Filedate();" ";Filetime();" ";Filelen()

' print file , the date the fime was created/changed , the time and the size of the file

  S = Dir()' get next

Wend