Name
GetFileArgument -- get file argument passed to a compiled script (V5.0)
Synopsis
f$ = GetFileArgument([path])
Function
GetFileArgument() allows you to retrieve the file argument that was passed to a compiled Hollywood script. Thus, this function will only work correctly when used by executables that have been compiled with Hollywood because in script mode the file argument is obviously always the Hollywood script itself. GetFileArgument() extends the GetCommandLine() function because the latter only allows you to retrieve option arguments, not the file argument itself.

This function is especially useful when writing tools that should be able to act as viewers for certain file formats with Hollywood. By using GetFileArgument() you could create programs which can be used as a default tool for certain file formats.

Starting with Hollywood 9.0, there is an optional argument named path. If this is set to True, GetFileArgument() will return a fully qualified path to the file instead of just the file name. For compatibility reasons, this argument defaults to False.

Inputs
path
optional: set this to True to get a fully qualified to the file (defaults to False) (V9.0)
Results
f$
the file argument passed to the compiled Hollywood script or an empty string if Hollywood is running in interpreter mode

Show TOC