Topic       : TOS - das Betriebssystem
Author      : 
Version     : tos.hyp (5. März 2013)
Subject     : Programmieren/Atari
Nodes       : 3001
Index Size  : 93602
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Titel
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File5.9.30  Fsnext                                                     TOS

 Name:         »search next file« - nächsten Dateieintrag suchen.

 Gemdosnummer: 79

 Deklaration:  int16_t Fsnext ( void );

 Beschreibung: Die GEMDOS-Routine Fsnext sucht den nächsten 
               Dateieintrag auf den die von Fsfirst gemachte 
               Spezifizierung paßt. Die Funktion wird nach einem 
               Aufruf von Fsfirst so oft aufgerufen, wie sie Dateien 
               findet, die zur angegebenen Spezifizierung passen.

               Diese Funktion benutzt die DTA der Applikation, die 
               nach dem Start in der Kommandozeile liegt. Fird diese 
               Funktion benutzt, ohne eine neue DTA zu setzen, wird 
               die Kommandozeile überschrieben.

               Hinweis: Falls das Programm in der MiNT-Domain läuft, 
               liefert Fsnext 'lower case' Filenamen. Da es 
               Filesysteme gibt die case sensitiv arbeiten, sollten 
               Sie diese Umwandlung auf keinen Fall manuell 
               durchführen. Wenn Sie hingegen unbedingt 'upper case' 
               Filenamen benötigen, sollten Sie Ihr Programm per 
               Pdomain in der TOS-Domain laufen lassen.

 Ergebnis:     Die Funktion liefert als Ergebnis 0, wenn eine Datei 
               gefunden werden konnte, ansonsten eine negative 
               Fehlermeldung.

 Verfügbar:    Alle GEMDOS Versionen.

 Gruppe:       Dateifunktionen

 Querverweis:  Binding   Fgetdta   Fsetdta   Fsfirst