SplitPath()
Mfunc.SplitPath(Input [, OutFileName, OutDir, OutExtension, OutNameNoExt, OutDrive])
Separates a file name or URL into its name, directory, extension, and drive.
Input
Name of the variable containing the file name to be analyzed.
Can be MfString instance or var containing string.
OutFileName
Name of the variable in which to store the file name without its path. The file's extension is included.
Can be MfString instance or var containing string.
OutDir
Name of the 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.
Can be MfString instance or var containing string.
OutExtension
Name of the variable in which to store the file's extension (e.g. TXT, DOC, or EXE). The dot is not included.
Can be MfString instance or var containing string.
OutNameNoExt
Name of the variable in which to store the file name without its path, dot and extension.
Can be MfString instance or var containing string.
OutDrive
Name of the 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
Can be MfString instance or var containing string.
Wrapper for AutoHotkey Docs - SplitPath.
Static method.
Any of the output variables may be omitted if the corresponding information is not needed.
If InputVar 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 command. It simply analyzes the string given in InputVar.
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 Input contains a colon-double-slash, such as http://domain.com or ftp://domain.com, OutDir is set to the protocol prefix + domain name + directory (e.g. http://domain.com/images) and OutDrive is set to the protocol prefix + domain name (e.g. http://domain.com). All other variables are set according to their definitions above.
Any and/or all parameter for this function can be instance of MfString or var containing string.
See Also:AutoHotkey Docs - SplitPath.
FullFileName := "C:\My Documents\Address List.txt"
; To fetch only the bare filename from the above:
Mfunc.SplitPath(FullFileName, name)
; To fetch only its directory:
Mfunc.SplitPath(FullFileName,, dir)
; To fetch all info:
Mfunc.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:
;--------------------------------------------------
; Example using MfString Objects
sInput := new MfString("D:\Users\user\Documents\AutoHotkey\Scripts\Documentation\DocCleanup_00020.ahk")
sFile := new MfString()
sDir := new MfString()
sExt := new MfString()
sNoExt := new MfString()
sOutDrive := new MfString()
Mfunc.SplitPath(sInput, sFile, sDir, sExt, sNoExt, sOutDrive)
MsgBox % MfString.Format("Split Results;{5}FileName:'{0}'{5}Folder:'{1}'{5}Extension:'{2}'{5}Name No Ext: '{3}'{5}Drive:'{4}'"
, sFile, sDir, sExt, sNoExt, sOutDrive, MfEnvironment.Instance.NewLine)
; MsgBox will Display the following
; Split Results;
; FileName:'DocCleanup_00020.ahk'
; Folder:'D:\Users\user\Documents\AutoHotkey\Scripts\Documentation'
; Extension:'ahk'
; Name No Ext: 'DocCleanup_00020'
; Drive:'D:'