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.23  Fread                                                      TOS

 Name:         »file read« - Datei lesen.

 Gemdosnummer: 63

 Deklaration:  int32_t Fread ( int16_t handle, int32_t count, void 
               *buf );

 Beschreibung: Die GEMDOS-Routine Fread liest eine bestimmte Anzahl 
               von Bytes aus einer Datei. Es gilt:

                Parameter  Bedeutung

                handle     Dateikennung
                count      Anzahl der zu lesenden Bytes
                buf        Adresse des aufnehmenden Puffers 
                           (mindestens Platz für count Bytes)

               Hinweis: In allen GEMDOS-Versionen < 0.15 kommt es zum 
               System-Stillstand, wenn der Parameter count den Wert 0 
               besitzt. Beim Lesen von Standardkanälen dürfen maximal 
               16383 Zeichen gelesen werden.

 Ergebnis:     Die Funktion liefert als Ergebnis die Anzahl der 
               gelesenen Zeichen. Die Anazhl gelesener Bytes kann 
               kleiner als count sein, wenn ein EOF (end of file) 
               erreicht wird. Im Fehlerfall gilt:

                EIHNDL :   falsche Dateikennung
                ELOCKED :  Datei-Abschnitt ist markiert

 Verfügbar:    Alle GEMDOS Versionen.

 Gruppe:       Dateifunktionen

 Querverweis:  Binding   Fwrite   FIONREAD