fDir (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Standard functions / External file functions

Note: the fDir function retains access to the
Looping through directories
Windows
Using fDir in threads

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

fDir (Function)

In french: fRep

Finds a file or directory. This search can be performed with wildcard characters (*,?).

Remarks:

To check if a file exists, use fFileExist.
To check the existence of a directory, disk or share, use fDirectoryExist.
To list the subdirectories of a directory, use fListDirectory.

It is also possible to build file paths directly with the / (slash) operator between components: the path will be automatically built dynamically with the expected format. Example:

Disk is TO string = "c:"
Directory is TO string = "My documents".
FileName is TO string = "SortieDeStock.xlsx"
PathComplete is TO string
// Improved code readability
FullPath = Disk / Directory / FileName

Example

See additional examples

// Recherche du fichier "C:\MonRépertoire\MonFichier.doc"
ResRecherche = fDir("C:\MonRépertoire\MonFichier.doc")

// Recherche du fichier "C:\MonRépertoire\MonFichier.doc"
ResRecherche = fDir("C:\MonRépertoire\MonFichier.doc", frFile)

// Recherche du répertoire "C:\MonRépertoire\"
ResRecherche = fDir("C:\MonRépertoire\", frDirectory)

// Recherche du premier fichier de type ".doc" dans le répertoire "C:\MonRépertoire"
ResRecherche = fDir("C:\MonRépertoire\*.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 determine if this function has generated an error, use ErrorInfo with the errMessage constant.

<Name of sought file or directory>: Character string

Name and full (or relative) path of the 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 the search to obtain the name of the next corresponding file (or directory): in this way, it is possible to obtain a list of files or directories belonging to a given directory..
If this parameter corresponds to a directory name, this name may (or may not) end with "\".
This parameter can be in Ansi or Unicode format.
This parameter can correspond to a full path or a path relative to the current directory (returned by fCurrentDir). This parameter is case-sensitive.
Reminder: In Android, the file system is read-only on the device and on the emulator. An application can only write to its installation directory or one of its subdirectories, as well as to the external memory (SDCard).
If "*.*" is used, only files with an extension will be searched.
This parameter can correspond to a full path or a path relative to the current directory (returned by fCurrentDir). This parameter is case-sensitive.
Reminder: On iPhone or iPad, an application has the rights to write to its installation directory or one of its subdirectories

<Options>: Optional Integer constant (or combination of constants)

Search options:
frDirectory Find a directory.
frFile
(Default value) Find a file.
fUnicodePath <Result> will be a Unicode string.
This constant can be combined with frFile or frDirectory.

Remarks

Note: the fDir function retains access to the

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

fDir("")

Looping through directories

Directory iterations performed with fDir must not be nested.

fDir must not be used when fCopyFile is used to a loop through 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(NomFichier) = "TOTO" THEN Info("Fichier trouvé")

But you should write:

IF fDir(NomFichier) ~= "TOTO" THEN Info("Fichier trouvé")

Using fDir in threads

It is not recommended to use fDir at the same time in two different threads.

The last iteration started with fDir automatically replaces the current iteration.

Component: wd300std.dll