Topic       : The GFA-Basic Compendium
Author      : GFA Systemtechnik GmbH
Version     : GFABasic.HYP v2.98 (12/31/2023)
Subject     : Documentation/Programming
Nodes       : 899
Index Size  : 28056
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Document not found
@help       : Help
@options    : +g -i -s +z
@width      : 75
@hostname   : STRNGSRV
@hostname   : CAB     
@hostname   : HIGHWIRE
@hostname   : THING   
View Ref-FileNAME old$ AS new$
RENAME old$ AS new$
KILL name$

old$, new$, name$: sexp

NAME gives the file specified in old$ the new name specified in new$. The
contents of the file is not changed. Of course, old$ and new$ must refer to the
same disk drive in their file specifications. NAME and RENAME are synonymous.

KILL deletes the file specified in the expression "name$".

Example:

    OPEN "o",#1,"TEST.TXT"
    PRINT #1, "example"
    CLOSE #1
    '
    NAME "TEST.TXT" AS "EXAMPLE.TST"
    DIR
    KILL "EXAMPLE.TST"
    DIR

--> The file TEST.TXT is opened and some sample data written to it. It is then
    renamed as EXAMPLE.TST and the directory displayed to show its presence.
    EXAMPLE.TST is then deleted and the directory displayed again, this time to
    show its absence.

Frename()+, Fdelete()+