fCurrentDir (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Functions for managing external files

Modifying the current disk and directory

Current directory during the tests

Related examples

See also

fCurrentDir (Function)

In french: fRepEnCours

Identifies or modifies the current directory.

Example

See additional examples

// Find out the current directory
ResCurrentDir = fCurrentDir()

Syntax

Finding out the current directory on the specified disk Hide the details

<Result> = fCurrentDir([<Disk> [, <Option>]])

<Result>: Character string

Path of current directory on the specified disk (up to 260 characters). This path ends with a "\" character at the root of a disk only ("A:\" for example).

-1 if an error occurred. To find out the error details, use ErrorInfo associated with the errMessage constant.

<Disk>: Optional character string (with quotes)

Name of disk where the current directory will be sought. This name has the following format:
<drive letter>:. For example: "A:".
UNC path. For example: "\\<ServerName>\<ShareName>".
If this parameter is not specified, the disk corresponds to the current disk.
This parameter is not available.

<Option>: Optional Integer constant

Versions 15 and later
Used to specify the format of function result. By default, fCurrentDir returns a character string in Ansi format.
fPathUNICODE <Result> will be a character string in Unicode format.

This parameter is not available.
New in version 15
Used to specify the format of function result. By default, fCurrentDir returns a character string in Ansi format.
fPathUNICODE <Result> will be a character string in Unicode format.

This parameter is not available.
Used to specify the format of function result. By default, fCurrentDir returns a character string in Ansi format.
fPathUNICODE <Result> will be a character string in Unicode format.

This parameter is not available.

Modifying the current directory Hide the details

<Result> = fCurrentDir(<Path of new current directory> [, <Option>])

<Result>: Character string

Path of current directory (up to 260 characters). This path ends with a "\" character at the root of a disk only ("A:\" for example).
-1 if an error occurred. To find out the error details, use ErrorInfo associated with the errMessage constant.

<Path of new current directory>: Character string (with quotes)

Full (or relative) path of new current directory (up to 260 characters). A UNC path can be used: it must have the following format: "\\<ServerName>\<ShareName>\<DirectoryName>".
Versions 15 and later
This parameter can be in Ansi or Unicode format.
New in version 15
This parameter can be in Ansi or Unicode format.
This parameter can be in Ansi or Unicode format.

<Option>: Optional Integer constant

Versions 15 and later
Used to specify the format of function result. By default, fCurrentDir returns a character string in Ansi format.
fPathUNICODE <Result> will be a character string in Unicode format.

This parameter is not available.
New in version 15
Used to specify the format of function result. By default, fCurrentDir returns a character string in Ansi format.
fPathUNICODE <Result> will be a character string in Unicode format.

This parameter is not available.
Used to specify the format of function result. By default, fCurrentDir returns a character string in Ansi format.
fPathUNICODE <Result> will be a character string in Unicode format.

This parameter is not available.

Remarks

Space character

The space characters found on the right of <Path of new current directory> are automatically deleted by fCurrentDir:

fCurrentDir("C:\MyDirectory\ ")

is equivalent to:

fCurrentDir("C:\MyDirectory")

Modifying the current disk and directory

To change the disk, we recommend that you use:

fCurrentDrive to modify the current disk,
fCurrentDir to modify the current directory on the new disk.

If the disk requested by fCurrentDir does not correspond to the current disk, the change of disk is automatically performed.

Current directory during the tests

When running tests from the WINDEV editor (window or project GO), the current directory corresponds to:

the generation directory of the current project configuration,
the EXE sub-directory of your project.

During a GO of a PHP project, the current directory is the "<ProjectName>_WEB" directory.

Related Examples:

Unit examples (WINDEV): Handling text files

[ + ] Handling "text" files with WINDEV:
- Create a text file
- Write into a text file
- Read in a text file

Unit examples (WEBDEV): Handling text files

[ + ] This example explains how to handle "non HFSQL" files with WEBDEV and it allows you to:
- Create a text file
- Write into a text file
- Read in a text file

Unit examples (WINDEV Mobile): Handling text files

[ + ] Handling external "text" files:
- Create a text file
- Write into a text file
- Read in a text file

Component : wd260std.dll