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.26  Fseek                                                     TOS

 Name:         »file seek« - Move file position pointer.

 Opcode:       66

 Syntax:       int32_t Fseek ( int32_t offset, int16_t handle, int16_t 
               seekmode );

 Description:  The GEMDOS routine Fseek permits the file pointer to be 
               moved to a new position within a file. The following 
               apply:

                Parameter  Meaning

                offset     Number of bytes that are to be skipped
                handle     GEMDOS file handle
                seekmode   Type of repositioning:
                            0 =  From start of file
                            1 =  From current position
                            2 =  From end of file

               Note: Applied to pipes the function returns the value 
               EACCDN; this way applications can differentiate between 
               devices and pipes.

 Return value: The function returns a positive value of the new 
               absolute location of the file pointer from the start of 
               the file, or a negative error-message.

 Availability: All GEMDOS versions.

 Group:        File functions

 See Also:     Binding   Fread   Fwrite   Test for pipes