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)►
-♦-