Programmer's WorkBench (pwb.hlp) (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
Setfile Function
                                             Up Contents Index Back
─────Programmer's WorkBench─────────────────────────────────────────────────
 
     Setfile («setfile»)
          Switches to the first file in the active window's file
          history. If there are no files in the file history, PWB
          displays the message 'No alternate file'.
 
          When the Autosave switch is set to yes, PWB saves the current
          file if it has been modified.
          See: Autosave
 
          Setfile does not honor the Newwindow switch. To open a new
          window when you open a file, use Openfile.
          See: Newwindow, Openfile
 
     Arg Setfile («arg» «setfile»)
          Switches to the filename that begins at the cursor and ends
          with the first blank character.
 
     Arg <textarg> Setfile («arg» <textarg> «setfile»)
          Switches to the file specified by <textarg>. If the file is
          not already open, PWB opens it. You can use environment-
          variable specifiers in the argument.
          See: Environment-Variable Specifiers
 
          If the argument is a drive or directory name, PWB changes the
          current drive or directory to the specified one and displays a
          message to confirm the change.
          See: Infodialog
 
          If the argument has the form '!<number>', PWB switches to the
          file with that number in the file history. The number can be
          from 1 to 9, inclusive.
          See: _pwbfile<n>
 
          If the argument is a wildcard, PWB creates a pseudofile
          containing a list of files that match the pattern. To open a
          file from this list, position the cursor at the beginning of
          the name and use Arg Openfile or Arg Setfile.
          See: Openfile
 
     Meta ... Setfile («meta» ... «setfile»)
          As above but does not save the changes to the current file.
 
     Arg Arg Setfile («arg» «arg» «setfile»)
          Saves the current file.
 
     Arg Arg <textarg> Setfile («arg» «arg» <textarg> «setfile»)
          Saves the current file under the name specified by <textarg>.
 
     Returns
 
     True:  File opened successfully.
     False: No alternate file, the specified file does not exist and
            you did not wish to create it, or the current file needs to
            be saved and cannot be saved.
 
     See
 
     Newfile
     Pseudofile (Defined)
                                    -♦-