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.15.20  Dxreaddir                                                 TOS

 Name:         »Dxreaddir« - Verzeichnis Informationen lesen.

 Gemdosnummer: 322, (0x142)

 Deklaration:  int32_t Dxreaddir ( int16_t ln, int32_t dirh, int8_t 
               *buf, XATTR *xattr, int32_t *xr );

 Beschreibung: Die Funktion liefert die nächste Datei aus dem 
               Verzeichnis mit dem Handle dirh. Der Dateiname und der 
               optionale 4 Bytes große Dateiindex werden in dem durch 
               buf spezifizierten Puffer abgelegt.

               Der Dateiindex wird weggelassen, wenn bei Dopendir der 
               Kompatibilitätmodus angegeben wurde. Wenn zwei 
               Dateinamen den gleichen Index besitzen, stehen sie für 
               die selbe Datei.

               MagiC liefert für FAT-Dateisysteme die folgenden 
               Index-Daten:

                  ∙ Verzeichnisse: Startcluster im Motorola-Format
                  ∙ sonstige Dateien:
                     Hiword = Startcluster des Verzeichnisses
                     Loword = Position innerhalb des Verzeichnisses >> 
                       5

               Dieses Verfahren ist ähnlich wie das, welches Linux und 
               Solaris verwenden. Nachteil ist, daß Dateien beim 
               Verschieben ihren Index ändern.

               Der Parameter ln gibt die Länge des aufnehmendes 
               Puffers buf an. Die erweiterten Dateiattribute werden 
               analog zu Fxattr in der Struktur xattr abgelegt, wobei 
               symbolische Links nicht aufgelöst werden.

               Hinweis: Dieser Teil des Aufrufs kann fehlschlagen, 
               obwohl der Dateiname lesbar war. In diesem Fall wird 
               ein getrennter Returncode in dem long-Wert abgelegt, 
               auf das der Parameter xr zeigt.

 Ergebnis:     Die Funktion kann folgende Rückgabewerte liefern:

                E_OK :    kein Fehler aufgetreten.
                ENMFIL :  keine weiteren Dateien gefunden.
                ERANGE :  der aufnehmende Puffer ist nicht groß genug.

 Verfügbar:    MagiC ab Version 3.0, ab MiNT 1.11

 Gruppe:       Verzeichnisfunktionen

 Querverweis:  Binding   Dreaddir   Dopendir   Dclosedir   Drewinddir