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.16.17  Dsetpath                                                  TOS

 Name:         »Set path« - Set the current directory.

 Opcode:       59

 Syntax:       int16_t Dsetpath ( CONST int8_t *path );

 Description:  The GEMDOS routine Dsetpath sets a new access path for 
               the current drive. The parameter path contains the new 
               current access path for the drive.

               Note: For each drive, GEMDOS will remember the current 
               directory. However, the function Dsetpath should be 
               used only for the current drive. For other drives the 
               following method should be applied instead:

                  . Establish current drive
                  . Set desired drive
                  . Set path for this drive
                  . Make the old (remembered) drive the current one 
                    again

               On some (older) versions of GEMDOS, a too frequent 
               setting of non-existing paths can lead to disturbance 
               in the internal structures.

 Return value: The function can return the following results:

                E_OK    No eror has arisen
                EPTHNF  Directory not found

 Availability: All GEMDOS versions.

 Group:        Directory functions

 See Also:     Binding   Dgetpath