Welcome to the Harris Geospatial product documentation center. Here you will find reference guides, help documents, and product libraries.


FILE_WHICH

FILE_WHICH

The FILE_WHICH function separates a specified file path into its component directories, and searches each directory in turn for a specific file. This command is modeled after the UNIX which(1) command, but is written in the IDL language and is available on all platforms. Its source code can be found in the file file_which.pro in the lib subdirectory of the IDL distribution.

Examples


To find the location of the file_which.pro file:

Result = FILE_WHICH('file_which.pro')

To find the location of the UNIX ls command:

Result = FILE_WHICH(getenv('PATH'), 'ls')

Syntax


Result = FILE_WHICH( [Path, ] File [, /INCLUDE_CURRENT_DIR] )

Return Value


Returns the path for the first file for the given name found by searching the specified path. If FILE_WHICH does not find the desired file, an empty string is returned.

Arguments


Path

A search path to be searched. If Path is not present, the value of the IDL !PATH system variable is used.

File

The file to look for in the directories given by Path.

Keywords


INCLUDE_CURRENT_DIR

If set, FILE_WHICH looks in the current directory before starting to search Path for File. When IDL searches for a routine to compile, it looks in the current working directory before searching !PATH. The INCLUDE_CURRENT_DIR keyword allows FILE_WHICH to mimic this behavior.

Version History


5.4

Introduced

See Also




© 2017 Exelis Visual Information Solutions, Inc. |  Legal
My Account    |    Buy    |    Contact Us