Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-FileFsfirst()
Fsnext()                                                             GEMDOS

Syntax

WORD Fsnext( VOID )

Function      Fsnext() should be called as many times as necessary after
              a corresponding Fsfirst() call to reveal all files which
              match the search criteria.

Opcode        79 (0x4F)

Availability  All GEMDOS versions.

Binding       move.w   #$4F,-(sp)
              trap     #1
              addq.l   #2,sp

Return Value  Fsnext() returns E_OK (0) if another file matching the
              search criteria given in Fsfirst() is found and the DTA has
              been properly filled in with the file's information.
              Otherwise, a negative GEMDOS error code is returned.

Comments      This function uses the application's DTA which is initially
              located in the same memory location as the processes'
              command line. Using this function without first assigning
              a new DTA will corrupt the command line. This call should
              only be used after Fsfirst() and the contents of the DTA
              should not be modifed between the calls.

See Also      Fsfirst()