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-FileDIR [p$ [TO name$]]
FILES [p$ [TO name$]]

p$, name$: sexp

The instructions DIR and FILES allow directories to be printed out, or sent to
a specified device or file with 'TO name$'. If no device is specified, the
output goes to the screen. The desired access path and file mask (e.g. *.*) is
specified in the expression p$. FILES is very similar to DIR, with the
difference that it also provides information on the length, time and date of
the listed files, and will also list folder names, identified by a '*' prefix,
if they fulfill the conditions of the file mask.

If parameter p$ is omitted, the current default drive/directory will be
assumed.

If p$ ends in '\', with no file mask, the mask '*.*' will be added
automatically by default.

With the optional extra 'TO name$' the directory information can be sent to a
peripheral device or to a file. In this case name$ must contain the device
identifier (e.g. "LST:") or a file specification (e.g. "A:\CONTENTS.LST").

Examples:

    DIR "A:\BOOKS\*.DOC"

--> All files with the extension .DOC in the folder BOOKS on drive A: are
    listed on the screen.

    DIR "A:\BOOKS\MANUAL\*.DOC" TO "B:\MANUAL\CONTENTS.ASC"

--> The list of files ending in .DOC in the folder MANUAL, which itself is
    found in the folder BOOKS, is sent to the file CONTENTS.ASC in the folder
    MANUAL on drive B:.

    DIR "A:\*.*" TO "PRN:"

--> All the files on drive A: are listed on the printer.

    FILES "A:\*.DOC" TO "LST:"

--> All the files on drive A: which have the extension .DOC are listed on the
    printer.

Memo: See section 'The Modifier Keys'.

      Internally channel #87 is used if the 'TO' parameter is specified.
      This could cause a conflict if channel #87 is already in use.