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.32  Fwrite                                                    TOS

 Name:         »file write« - Write to a specified file.

 Opcode:       64

 Syntax:       int32_t Fwrite ( int16_t handle, int32_t count, void 
               *buf );

 Description:  The GEMDOS routine Fwrite writes a given number of 
               bytes to a specified GEMDOS file. The following apply:

                Parameter  Meaning

                handle     File handle identifier
                count      Number of bytes to be written
                buf        Start address of the buffer

               Note about MagiC: If one passes the value 0 for the 
               number of bytes to be written, and the value -1 in buf, 
               then the file will be truncated to the current position 
               of the file pointer.

 Return value: The function returns the number of bytes actually 
               written, or one of the following error-messages:

                EACCDN :   Access denied
                EIHNDL :   Invalid file handle
                ELOCKED :  File segment is marked as protected

 Availability: All GEMDOS versions.

 Group:        File functions

 See Also:     Binding   Fread   FIONWRITE