fExtractPath (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Functions for managing external files

Example of extracted path

See also

Constants for the external files

Functions for managing external files

Handling the external files

Storing files in Android

Summary table: Managing the application directories according to the platform

fDetectRemovableStorage

fReadLineRegularExpression

fRemoveDir

fRename

fReportsAndQueriesDir

Example of extracted path

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

fExtractPath (Function)

In french: fExtraitChemin

Returns the different elements of a path: disk, directories, name and extension of the file.

Example

See additional examples

sFilePath is string
sResFileName is string
sResPathName is string

sFilePath = "C:\MyDirectories\File.doc"

// Retrieve the name of the file
sResFileName = fExtractPath(sFilePath, fFileName)
// sResFileName corresponds to "File"

// Retrieve the disk and path of the file
sResPathName = fExtractPath(sFilePath, fDrive + fDirectory)
// sResPathName corresponds to "C:\MyDirectories\"

// Use of UNC paths
Trace(fExtractPath("\\lg-br\sharedfiles\downloads\WINDEV\setup.exe", fDrive))
// Returns \\lg-br\sharedfiles
Trace(fExtractPath("\\lg-br\sharedfiles\downloads\WINDEV\setup.exe", fDirectory))
// Returns \downloads\WINDEV\

Syntax

<Result> = fExtractPath(<File path> , <Path section to extract>)

<Result>: Character string

Requested path section,
Empty string ("") if an error occurred. To find out the error details, use ErrorInfo associated with the errMessage constant.

<File path>: Character string (with quotes)

Name and full (or relative) path of file (up to 260 characters). A UNC path can be used. The existence of <File path> is not checked by fExtractPath. If the path does not end with a "\" character, the last element is considered as being a file.
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.

<Path section to extract>: Constant or combination of constants

Section of file path to extract:
fDrive Name of the unit.
fExtension Extension of the file, preceded by "."
fFileName Name of the file (without extension).
fDirectory Different directories of the file (the file name and extension are not returned).

Remarks

Example of extracted path

If the specified path is "C:\Temp\Data\File.txt", fExtractPath returns:

fExtension: .txt
fFileName: File
fDirectory: \Temp\Data\
fDrive: C:
fFileName+fExtension: File.txt
fDirectory+fFileName: \Temp\Data\File
etc.

Component : wd250std.dll