MAINSAIL Language Manual, Section 32.49

previous   next   top   contents   index   framed top   this page unframed


32.49. $composeFileName

Figure 32–48. $composeFileName
STRING
PROCEDURE   $composeFileName
                        (
STRING base;
                         
OPTIONAL STRING
                            
extension,devModStr,path;
                         
OPTIONAL BITS ctrlBits);

$composeFileName takes base, extension, device MODULE, and path STRINGs in a (device-specific) format. The path format is that produced by $composePath for the device. $composeFileName returns a syntactically correct (device-specific) file name, such as could be passed to the system PROCEDURE open.

Consult the appropriate operating-system-specific user's guide for examples of $composeFileName and $decomposeFileName.

The only valid ctrlBits bit for $composeFileName is errorOK. If set, errMsg is not called when an error occurs.


previous   next   top   contents   index   framed top   this page unframed

MAINSAIL Language Manual, Section 32.49