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.15  Finstat                                                    TOS

 Name:         »Finstat« - Eingabestatus für ein File festlegen.

 Gemdosnummer: 261

 Deklaration:  int32_t Finstat ( int16_t fh );

 Beschreibung: Die Funktion Finstat gibt die maximale Anzahl der Bytes 
               zurück, die aus der Datei mit dem Handle fh ohne zu 
               Warten gelesen werden können.

               Wenn die Anzahl der Bytes nicht genau angegeben werden 
               kann, wird der Wert 1 zurückgeliefert.

               Hinweis: In MagiC versucht der Kernel zunächst, den 
               Aufruf auf Fcntl (FIONREAD) zurückzuführen. Wenn diese 
               Subfunktion von dev_ioctl nicht existiert (d.h. der 
               Dateitreiber liefert EINVFN), wird dev_stat aufgerufen. 
               In diesem Fall kann nur die Aussage getroffen werden 
               "Zeichen liegt an" (Rückgabe == 1) bzw. "kein Zeichen 
               liegt an" (Rückgabe == 0). FAT-Dateien und Shared 
               Memory liefern die tatsächliche Dateilänge minus der 
               aktuellen Position. Pipes liefern die Anzahl der 
               vorhandenen Bytes im Block.

 Ergebnis:     Die Funktion kann folgende Rückgabewerte liefern:

                >= 0 :    kein Fehler aufgetreten (Anzahl der Bytes).
                EIHNDL :  ungültiges Datei-Handle.

 Verfügbar:    Seit der ersten in MultiTOS integrierten MiNT Version 
               1.04 und in MagiC ab Version 3.0.

 Gruppe:       Dateifunktionen

 Querverweis:  Binding   Cauxis   Cconis   Fcntl   Foutstat