Skip to main content


Searches a collection of paths for a particular file.

p = os.pathsearch("fname", "path1", ...)


fname is the name of the file being searched. This is followed by one or more path sets to be searched.

Path sets match the format of the PATH environment variable: a colon-delimited list of paths. On Windows, you may use a semicolon-delimited list if drive letters might be included.

Return Value

The path to the directory which contains the file, if found. Otherwise, nil.


Premake 4.0 or later.

See Also