The path list is a convenient way of storing a number of directories, and
when presented with a filename without a directory, searching for an existing file
in those directories.
Be sure to look also at wxStandardPaths
if you only
want to search files in some standard paths.
Constructs the object calling the Add
(const wxString& env_variable
Finds the value of the given environment variable, and adds all paths
to the path list. Useful for finding files in the PATH variable, for
The first form adds the given directory to the path list, if the path is not already in the list.
If the path cannot be normalized for some reason, it returns false.
The second form just calls the first form on all elements of the given array.
is always considered a directory but no existence checks will be done on it
(because if it doesn't exist, it could be created later and thus result a valid path when
if the given path is relative, it won't be made absolute before adding it
(this is why FindValidPath
may return relative paths).
(const wxString& filename
Given a full filename (with path), calls Add
with the path
of the file.
but this function always
returns an absolute path (eventually prepending the current working directory
to the value returned FindValidPath
) or an
Searches the given file in all paths stored in this class.
The first path which concatenated to the given string points to an existing
file (see wxFileExists
) is returned.
If the file wasn't found in any of the stored paths, an empty string is returned.
The given string must be a file name, eventually with a path prefix (if the path
prefix is absolute, only its name will be searched); i.e. it must not end with
a directory separator (see wxFileName::GetPathSeparator
otherwise an assertion will fail.
The returned path may be relative to the current working directory.
Note in fact that wxPathList can be used to store both relative and absolute paths so that
if you Add()
ed relative paths, then the current working directory
may affect the value returned by this function!