THE

SET FILENAME - change the filename of the file being edited

Syntax:
[SET] FILEName filename

Description:
The SET FILEName command allows the user to change the filename of the file currently being edited.

In THE, a fully qualified file name consists of a file path and a file name. THE treats all characters up to and including the last directory separator (usually / or \) as the file 's path. From the first character after the end of the file' s path, to the end of the fully qualified file name is the file name.

A file name is further broken down into a fname and fext. The fname of a file consists of all characters from the start of the filename up to but not including the last period (if there is one). The fext of a file consists of all characters from the end of the filename up to but not including the last period. If there is no period in the filename then the fext is empty.

The fmode of a file is equivalent to the drive letter of the file 's path. This is only valid under DOS, OS/2 and Windows ports.'

Some examples.

          Full File Name     File            File     Fname  Fext     Fmode
                             Path            Name
          -----------------------------------------------------------------
          /usr/local/bin/the /usr/local/bin/ the      the             N/A
          c:\tools\the.exe   c:\tools\       the.exe  the    exe      c
          /etc/a.b.c         /etc/           a.b.c    a.b    c        N/A

A limited amount of validation of the resulting file name is carried out by this command, but some errors in the file name will not be evident until the file is saved.

A leading "=" indicates that the fname portion of the current file name is be retained. This is equivalent to the command SET FEXT . A trailing "=" indicates that the fext portion of the current file name is to be retained. This is equivalent to the command SET FNAME .

Only one "=" is allowed in the parameter.

Some examples.

          File Name   Parameter  New File Name
          -----------------------------------------------------------------
          a.b.c       fred.c=    fred.c.c      SET FNAME fred.c
          a.b.c       fred.c.=   fred.c..c     SET FNAME fred.c.
          a.b.c       =fred      a.c.fred      SET FEXT fred
          a.b.c       =.fred     a.c..fred     SET FEXT .fred
          a           =d         a.d           SET FEXT d
          a.b.c       =          a.b.c         does nothing

It is not possible to use this command on pseudo files.

Compatibility:
XEDIT: N/A
KEDIT: Compatible.

See Also:
SET FPATH, SET FNAME, SET FEXT, SET FMODE, SET EQUIVCHAR

Status:
Complete.


The Hessling Editor is Copyright © Mark Hessling, 1990-2015 <mark@rexx.org>
Generated on: 26 Jan 2015

Return to Table of Contents