Separates a file name or URL into its name, directory, extension, and drive.
SplitPath Path , &OutFileName, &OutDir, &OutExtension, &OutNameNoExt, &OutDrive
Type: String
The file name or URL to be analyzed.
Note that this function expects filename paths to contain backslashes (\) only and URLs to contain forward slashes (/) only.
Type: VarRef
If omitted, the corresponding value will not be stored. Otherwise, specify a reference to the output variable in which to store the file name without its path. The file's extension is included.
Type: VarRef
If omitted, the corresponding value will not be stored. Otherwise, specify a reference to the output variable in which to store the directory of the file, including drive letter or share name (if present). The final backslash is not included even if the file is located in a drive's root directory.
Type: VarRef
If omitted, the corresponding value will not be stored. Otherwise, specify a reference to the output variable in which to store the file's extension (e.g. TXT, DOC, or EXE). The dot is not included.
Type: VarRef
If omitted, the corresponding value will not be stored. Otherwise, specify a reference to the output variable in which to store the file name without its path, dot and extension.
Type: VarRef
If omitted, the corresponding value will not be stored. Otherwise, specify a reference to the output variable in which to store the drive letter or server name of the file. If the file is on a local or mapped drive, the variable will be set to the drive letter followed by a colon (no backslash). If the file is on a network path (UNC), the variable will be set to the share name, e.g. \\Workstation01
Any of the output variables may be omitted if the corresponding information is not needed.
If Path contains a filename that lacks a drive letter (that is, it has no path or merely a relative path), OutDrive will be made blank but all the other output variables will be set correctly. Similarly, if there is no path present, OutDir will be made blank; and if there is a path but no file name present, OutFileName and OutNameNoExt will be made blank.
Actual files and directories in the file system are not checked by this function. It simply analyzes the provided string.
Wildcards (* and ?) and other characters illegal in filenames are treated the same as legal characters, with the exception of colon, backslash, and period (dot), which are processed according to their nature in delimiting the drive letter, directory, and extension of the file.
Support for URLs: If Path contains a colon-double-slash, such as in "https://domain.com" or "ftp://domain.com", OutDir is set to the protocol prefix + domain name + directory (e.g. https://domain.com/images) and OutDrive is set to the protocol prefix + domain name (e.g. https://domain.com). All other variables are set according to their definitions above.
A_LoopFileExt, StrSplit, InStr, SubStr, FileSelect, DirSelect
Demonstrates different usages.
FullFileName := "C:\My Documents\Address List.txt" ; To fetch only the bare filename from the above: SplitPath FullFileName, &name ; To fetch only its directory: SplitPath FullFileName,, &dir ; To fetch all info: SplitPath FullFileName, &name, &dir, &ext, &name_no_ext, &drive ; The above will set the variables as follows: ; name = Address List.txt ; dir = C:\My Documents ; ext = txt ; name_no_ext = Address List ; drive = C: