Admin at 19:46, 8 February 2013

2013-02-08T19:46:21Z

Admin: Created page with "= Action = Returns the filename that matches the specified file mask.
2013-02-08T19:44:16Z

Created page with "= Action = Returns the filename that matches the specified file mask. 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]] , [http://avrhelp.mcselec.com/close.htm CLOSE], [http://avrhelp.mcselec.com/flush.htm FLUSH] , [http://avrhelp.mcselec.com/print.htm PRINT], [http://avrhelp.mcselec.com/line_input.htm LINE INPUT], [http://avrhelp.mcselec.com/loc.htm LOC], [http://avrhelp.mcselec.com/lof.htm LOF] , [http://avrhelp.mcselec.com/eof.htm EOF] , [http://avrhelp.mcselec.com/freefile.htm FREEFILE] , [http://avrhelp.mcselec.com/fileattr.htm FILEATTR] , [http://avrhelp.mcselec.com/seek.htm SEEK] , [http://avrhelp.mcselec.com/bsave.htm BSAVE] ,[http://avrhelp.mcselec.com/bload.htm BLOAD] , [http://avrhelp.mcselec.com/kill.htm KILL] , [http://avrhelp.mcselec.com/diskfree.htm DISKFREE] , [http://avrhelp.mcselec.com/disksize.htm DISKSIZE] , [http://avrhelp.mcselec.com/get.htm GET] , [http://avrhelp.mcselec.com/put.htm PUT], [http://avrhelp.mcselec.com/filelen.htm FILELEN] , [http://avrhelp.mcselec.com/filedate.htm FILEDATE] , [http://avrhelp.mcselec.com/filetime.htm FILETIME] , [http://avrhelp.mcselec.com/filedatetime.htm FILEDATETIME] , [http://avrhelp.mcselec.com/write.htm WRITE] , [http://avrhelp.mcselec.com/input.htm INPUT] ,[http://avrhelp.mcselec.com/mkdir.htm MKDIR], [http://avrhelp.mcselec.com/rmdir.htm RMDIR] , [http://avrhelp.mcselec.com/chdir.htm 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]]

@@ Line 54: / Line 54: @@
 = <span class="f_Header">See also</span> =
-[[INITFILESYSTEM]]&nbsp;,&nbsp;[[OPEN]]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/close.htm CLOSE],&nbsp;[http://avrhelp.mcselec.com/flush.htm FLUSH]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/print.htm PRINT],&nbsp;[http://avrhelp.mcselec.com/line_input.htm LINE INPUT],&nbsp;[http://avrhelp.mcselec.com/loc.htm LOC],&nbsp;[http://avrhelp.mcselec.com/lof.htm LOF]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/eof.htm EOF]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/freefile.htm FREEFILE]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/fileattr.htm FILEATTR]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/seek.htm SEEK]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/bsave.htm BSAVE]&nbsp;,[http://avrhelp.mcselec.com/bload.htm BLOAD]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/kill.htm KILL]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/diskfree.htm DISKFREE]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/disksize.htm DISKSIZE]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/get.htm GET]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/put.htm PUT],&nbsp;[http://avrhelp.mcselec.com/filelen.htm FILELEN]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/filedate.htm FILEDATE]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/filetime.htm FILETIME]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/filedatetime.htm FILEDATETIME]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/write.htm WRITE]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/input.htm INPUT]&nbsp;,[http://avrhelp.mcselec.com/mkdir.htm MKDIR],&nbsp;[http://avrhelp.mcselec.com/rmdir.htm RMDIR]&nbsp;,&nbsp;[http://avrhelp.mcselec.com/chdir.htm CHDIR]
+[[INITFILESYSTEM]] , [[OPEN]] , [[CLOSE]]&nbsp;, [[FLUSH]] , [[PRINT]]&nbsp;, [[LINE INPUT]]&nbsp;, [[LOC]]&nbsp;, [[LOF]] , [[EOF]] , [[FREEFILE]] , [[FILEATTR]] , [[SEEK]] , [[BSAVE]] ,&nbsp;[[BLOAD]] , [[KILL]] , [[DISKFREE]] , [[DISKSIZE]] , [[GET]] , [[PUT]]&nbsp;, [[FILELEN]] , [[FILEDATE]] , [[FILETIME]] , [[FILEDATETIME]] , [[WRITE]] , [[INPUT]] ,&nbsp;[[MKDIR]]&nbsp;, [[RMDIR]] , [[CHDIR]]
 <span style="font-family: Arial;">&nbsp;</span>

DIR - Revision history

Admin at 19:46, 8 February 2013