Admin: 1 revision

2013-02-15T19:14:15Z

1 revision

Admin at 19:46, 8 February 2013

2013-02-08T19:46:21Z

New page

== (**COPIED FROM ENGLISH PAGE**) === Action =

Returns the filename that matches the specified file mask.

 

 

= Syntax =

sFile = DIR(mask)

sFile = DIR()

 

 

= Remarks =
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="609" cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
|- style="vertical-align: top;"
| valign="top" width="12%" style="width: 90px; border: 1px solid rgb(0, 0, 0);" |
SFile

| valign="top" width="65%" style="width: 510px; border: 1px solid rgb(0, 0, 0);" |
A string variable that is assigned with the filename.

|- style="vertical-align: top;"
| valign="top" width="12%" style="width: 90px; border: 1px solid rgb(0, 0, 0);" |
Mask

| valign="top" width="65%" style="width: 510px; border: 1px solid rgb(0, 0, 0);" |
A file mask with a valid DOS file mask like *.TXT

 

Use *.* to select all files.

|}
</div>
 

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 =
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="634" cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
|- style="vertical-align: top;"
| valign="top" width="22%" style="width: 136px; border: 1px solid rgb(0, 0, 0);" |
Calls

| valign="top" width="49%" style="width: 306px; border: 1px solid rgb(0, 0, 0);" |
_Dir ; with file mask

| valign="top" width="66%" style="width: 180px; border: 1px solid rgb(0, 0, 0);" |
_Dir0 ; without file mask

|- style="vertical-align: top;"
| valign="top" width="22%" style="width: 136px; border: 1px solid rgb(0, 0, 0);" |
Input

| valign="top" width="49%" style="width: 306px; border: 1px solid rgb(0, 0, 0);" |
X : points to the string with the mask

| valign="top" width="66%" style="width: 180px; border: 1px solid rgb(0, 0, 0);" |
Z : points to the target variable

|- style="vertical-align: top;"
| valign="top" width="22%" style="width: 136px; border: 1px solid rgb(0, 0, 0);" |
Output

| valign="top" width="49%" style="width: 306px; border: 1px solid rgb(0, 0, 0);" |
 

| valign="top" width="66%" style="width: 180px; border: 1px solid rgb(0, 0, 0);" |
 

|}
</div>
 

 

 

= Partial Example =

 <source lang="bascomavr">
'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
</source> {{Languages}}

[[Category:BASCOM Language Reference/de]]

DIR/de - Revision history

Admin: 1 revision

Admin at 19:46, 8 February 2013