LIST_WITH_PATH

       Search for files in a specified directory path.

       Lists files in a set of default paths, similar to using FINDFILE,
       except that a list of paths to be searched can be given.

       Result = LIST_WITH_PATH( FILENAME, PATHS )

       FILENAME   = Name of file to be searched for.  It may contain wildcard
                    characters, e.g. "*.dat".
       PATHS      = One or more default paths to use in the search in case
                    FILENAME does not contain a path itself.  The individual
                    paths are separated by commas, although in UNIX, colons
                    can also be used.  In other words, PATHS has the same
                    format as !PATH, except that commas can be used as a
                    separator regardless of operating system.  The current
                    directory is always searched first, unless the keyword
                    NOCURRENT is set.
                    A leading $ can be used in any path to signal that what
                    follows is an environmental variable, but the $ is not
                    necessary.  (In VMS the $ can either be part of the path,
                    or can signal logical names for compatibility with Unix.)
                    Environmental variables can themselves contain multiple
                    paths.

       The result of the function is a list of filenames.

       FILENAME = ''
       READ, 'File to open: ', FILENAME
       FILE = LIST_WITH_PATH( FILENAME, 'SERTS_DATA', '.fix' )
       IF FILE NE '' THEN ...

       BREAK_PATH, CONCAT_DIR

       Utilities, Operating_system

       Version 1, William Thompson, GSFC, 3 November 1994
       Documentation modified Wayne Landsman HSTX  November 1994
       Converted to IDL V5.0   W. Landsman   September 1997

[Home Page] [Software, Documentation] [IDL Documentation] [Quick Reference] [Feedback]