Standard Library function that returns the file path to use to open a file, when given a file name within the PV-WAVE distribution.
Terminal The file name of the user's terminal.
Tmp The path to the default location for temporary files for the current operating system (filename is a temporary or "scratch" file).
FILEPATH does not check for the existence of filename, but rather only contracts a fully qualified pathname. It does account for operating system dependencies.
This routine is useful when you are writing a procedure that will be used on different platforms that support PV-WAVE and will open files in the PV-WAVE distribution.
PRINT, FILEPATH('wvstartup')
/usr/local/vni/wave/wvstartup
full_name = FILEPATH('errplot', $ Subdirectory='lib/std') PRINT, full_name
/usr/local/vni/wave/lib/std/errplot
PRINT, FILEPATH('dummy',/Terminal)
/dev/tty
PRINT, FILEPATH('scratch10',/Tmp)
/tmp/scratch10
PRINT, FILEPATH('wvstartup')
WAVE_DIR:[000000]wvstartup
full_name = FILEPATH('errplot', $ Subdirectory='lib.std') PRINT, full_name
WAVE_DIR:[lib.std]errplot
PRINT, FILEPATH('dummy',/Terminal)
SYS$OUTPUT:
PRINT, FILEPATH('scratch10',/Tmp)
SYS$LOGIN:scratch10
full_name = FILEPATH('errplot', $ Subdirectory='lib\std') PRINT, full_name
d:\vni\wave\lib\std\errplot
PRINT, FILEPATH('scratch10',/Tmp)
\tmp\scratch10