PC SOFT

WINDEVWEBDEV AND WINDEV MOBILE
ONLINE HELP

Home | Sign in | English UK
  • Caution: fDir keeps access to the directory
  • Browsing directories
  • Windows
  • Using fDir in threads
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Others
Stored procedures
Finds a file or a directory. This search can be performed with wildcard characters (*,?).
Remarks:
WEBDEV - Server codePHPAjax
// Find the "C:\MyDirectory\MyFile.doc" file
ResSearch = fDir("C:\MyDirectory\MyFile.doc")

// Find the "C:\MyDirectory\MyFile.doc" file
ResSearch = fDir("C:\MyDirectory\MyFile.doc", frFile)

// Find the "C:\MyDirectory\" directory
ResSearch = fDir("C:\MyDirectory\", frDirectory)

// Find the first ".doc" file in the "C:\MyDirectory" directory
ResSearch = fDir("C:\MyDirectory\*.doc")
Syntax
<Result> = fDir(<Name of Sought File or Directory> [, <Options>])
<Result>: Character string
  • Name of file (with its extension) or directory found.
  • Empty string ("") otherwise. To find out whether an error was generated by this function, use ErrorInfo associated with the errMessage constant.
<Name of Sought File or Directory>: Character string (with quotes)
Name and full (or relative) path of sought file or directory (up to 260 characters). A UNC path can be used. You have the ability to use wildcard characters (*,?) in the name of the file.
If this parameter is empty, the function continues and searches for the name of the next corresponding file (or directory): this allows you to list the files or directories belonging to a given directory.
If this parameter corresponds to a directory name, this name may (or may not) end with "\".
Versions 15 and later
WindowsLinux This parameter can be in Ansi or Unicode format.
New in version 15
WindowsLinux This parameter can be in Ansi or Unicode format.
WindowsLinux This parameter can be in Ansi or Unicode format.
<Options>: Optional Integer constant (or combination of constants)
Search options:
fPathUNICODE
Versions 15 and later
<Result> will be a character string in Unicode format.
This constant can be combined with frFile or frDirectory.
New in version 15
<Result> will be a character string in Unicode format.
This constant can be combined with frFile or frDirectory.
<Result> will be a character string in Unicode format.
This constant can be combined with frFile or frDirectory.
frFile
(Default value)
Find a file.
frDirectoryFind a directory.
Remarks

Caution: fDir keeps access to the directory

Calling fDir keeps access to the directory, and prevents you from deleting or renaming it. To unlock the directory, add the following code line to your process:
fDir("")

Browsing directories

The browses of directories performed by fDir must not be nested.
fDir must not be used when fCopyFile is used in a loop for browsing directories.

Windows

In Windows, a file name or a directory name can contain lowercase and/or uppercase characters (the names of the files are not "case sensitive").
Therefore, you should not write:
IF fDir(FileName) = "TOTO" THEN Info("File found")
But you should write:
IF fDir(FileName) ~= "TOTO" THEN Info("File found")

Using fDir in threads

fDir should not be used at the same time in two different threads.
Indeed, the last browse operation requested by fDir automatically replaces the current one.
Component : wd250std.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment