parse_path()

Learn how to use the parse_path() function to parse a file path.

Parses a file path string and returns a dynamic object that contains the following parts of the path:

  • Scheme
  • RootPath
  • DirectoryPath
  • DirectoryName
  • Filename
  • Extension
  • AlternateDataStreamName

In addition to the simple paths with both types of slashes, the function supports paths with:

  • Schemas. For example, “file://…”
  • Shared paths. For example, “\shareddrive\users…”
  • Long paths. For example, “\?\C:…”"

Syntax

parse_path(path)

Parameters

NameTypeRequiredDescription
pathstring✔️The file path.

Returns

An object of type dynamic that included the path components as listed above.

Example

datatable(p:string) 
[
    @"C:\temp\file.txt",
    @"temp\file.txt",
    "file://C:/temp/file.txt:some.exe",
    @"\\shared\users\temp\file.txt.gz",
    "/usr/lib/temp/file.txt"
]
| extend path_parts = parse_path(p)

Output

ppath_parts
C:\temp\file.txt{“Scheme”:"",“RootPath”:“C:”,“DirectoryPath”:“C:\temp”,“DirectoryName”:“temp”,“Filename”:“file.txt”,“Extension”:“txt”,“AlternateDataStreamName”:""}
temp\file.txt{“Scheme”:"",“RootPath”:"",“DirectoryPath”:“temp”,“DirectoryName”:“temp”,“Filename”:“file.txt”,“Extension”:“txt”,“AlternateDataStreamName”:""}
file://C:/temp/file.txt:some.exe{“Scheme”:“file”,“RootPath”:“C:”,“DirectoryPath”:“C:/temp”,“DirectoryName”:“temp”,“Filename”:“file.txt”,“Extension”:“txt”,“AlternateDataStreamName”:“some.exe”}
\shared\users\temp\file.txt.gz{“Scheme”:"",“RootPath”:"",“DirectoryPath”:"\\shared\users\temp",“DirectoryName”:“temp”,“Filename”:“file.txt.gz”,“Extension”:“gz”,“AlternateDataStreamName”:""}
/usr/lib/temp/file.txt{“Scheme”:"",“RootPath”:"",“DirectoryPath”:"/usr/lib/temp",“DirectoryName”:“temp”,“Filename”:“file.txt”,“Extension”:“txt”,“AlternateDataStreamName”:""}