Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File5.10.30  Fsnext                                                    TOS

 Name:         »search next file« - Search for next file entry.

 Opcode:       79

 Syntax:       int16_t Fsnext ( void );

 Description:  The GEMDOS routine Fsnext searches for the next file 
               entry that matches the criteria specified in Fsfirst. 
               It should be called as often as necessary after a 
               Fsfirst call to find all files that match the search 
               criteria.

               Be aware that this function uses the application's DTA 
               which initially shares its memory location with the 
               processes' command line. Hence using this function 
               without first assigning a new DTA will corrupt the 
               command line.

               Note: If the program runs in the MiNT-domain, Fsnext 
               will return lower case filenames. As file-systems exist 
               that are case sensitive, you should avoid making such 
               conversions manually. However, if you absolutely need 
               upper case filenames you should use Pdomain to make 
               your program run in the TOS-domain.

 Return value: The function returns 0 if a matching file was found, 
               else a negative error-message.

 Availability: All GEMDOS versions.

 Group:        File functions

 See also:     Binding   Fgetdta   Fsetdta   Fsfirst