Les unités de Pure Pascal (langage Pascal pour les ordinateurs de la gamme Atari ST), compatible Turbo Pascal.
Unité TOS : Fonction Dpathconf
Cette page a été ajoutée au document HLP Atari d'Origine, car manquante
Fonction Gemdos 292
Déclaration function Dpathconf( name : String ; n : Integer ) : LongInt;
Description
La fonction Dpathconf permet d'obtenir des informations sur le système de fichiers contenant le nom du fichier.
Le paramètre n (=mode) spécifie les possibilités ou restrictions des systèmes de fichiers à interroger. Les valeurs possibles sont :
| n | Signification |
|---|
| -1 | Valeur maximale autorisée pour Dpathconf
|
| DP_IOPEN (0) | Nombre maximal de fichiers ouverts |
| DP_MAXLINKS (1) | Nombre maximal de références (liens) vers un fichier |
| DP_PATHMAX (2) | Longueur maximale du chemin d'accès complet |
| DP_NAMEMAX (3) | Longueur maximale d'un nom de fichier |
| DP_ATOMIC (4) | Nombre d'octets pouvant être écrits simultanément par opération d'écriture |
| DP_TRUNC (5) | Informations sur la troncature des noms de fichiers :
- 0 = Les noms de fichiers ne sont pas tronqués ; Si la longueur maximale du nom de fichier est dépassée lors d'un appel système, la valeur -88 (ERANGE) est renvoyée.
- 1 = Les noms de fichiers sont tronqués automatiquement à la longueur maximale possible.
- 2 = Les noms de fichiers sont tronqués selon la convention DOS (c.-à-d. 8 caractères pour le nom, 3 caractères pour l'extension).
|
| DP_CASE (6) | Informations sur la distinction majuscules-minuscules :
- 0 = Différenciation majuscules-minuscules (le système de fichiers est sensible à la casse).
- 1 = Aucune distinction majuscules-minuscules (tous les caractères sont convertis en majuscules ou en minuscules ; le système de fichiers n'est pas sensible à la casse).
- 2 = Aucune distinction majuscules-minuscules ; Cependant, le système de fichiers enregistre le chemin et les noms de fichiers avec leurs valeurs d'origine.
Exemple : Le fichier affiché « HelloWorld » est également accessible avec « HELLOWorld » ou « HeLLoWORLD ».
|
| DP_MODEATTR (7) | Informations sur les bits de mode d'un fichier :
Ce mode renvoie des informations sur la validité des valeurs définies dans les champs mode et attr de la structure XATTR. Les bits 0 à 5 décrivent les indicateurs du composant attr valides. Les conditions suivantes s'appliquent :
- FA_RDONLY (0x01) : Défini uniquement si l'autorisation de lecture est contrôlée via ce bit, et non lorsqu'elle est émulée via la signification des bits de mode.
- FA_HIDDEN (0x02) :
- FA_SYSTEM (0x04) : Défini si le système de fichiers prend en charge ces attributs spécifiques (normalement, uniquement pour les systèmes de fichiers DOS).
- FA_LABEL (0x08) : Défini si l'étiquette du système de fichiers peut être obtenue avec Fsfirst/Fsnext.
- FA_DIR (0x10) : Réservé ; pour déterminer s'il s'agit d'un dossier du système de fichiers, il faut utiliser les bits de type de fichier (voir ci-dessous).
- FA_CHANGED (0x20) : Défini si le système de fichiers connaît le concept de bits d'archive et que le champ attr est utilisé à cette fin.
Les bits 6 et 7 sont réservés. Les bits 8 à 19 stockent des informations sur la validité des 12 bits de poids faible du composant de mode. Les bits 20 à 27 décrivent les types de fichiers pris en charge par le système de fichiers. Les règles suivantes s'appliquent :
- DP_FT_DIR (0x00100000L) : Dossier
- DP_FT_CHR (0x00200000L) : Fichiers de caractères spéciaux
- DP_FT_BLK (0x00400000L) : Fichiers de blocs spéciaux (actuellement inutilisés)
- DP_FT_REG (0x00800000L) : Fichiers normaux
- DP_FT_LNK (0x01000000L) : Liens symboliques
- DP_FT_SOCK (0x02000000L) : Sockets (actuellement inutilisés)
- DP_FT_FIFO (0x04000000L) : Tubes
- DP_FT_MEM (0x08000000L) : Mémoire partagée ou fichiers de processus
Les bits 28 à 31 sont réservés. |
| DP_XATTRFIELDS (8) | Informations sur les attributs étendus :
Dans ce mode, un masque binaire des champs pris en charge (spécifié dans la structure XATTR) est renvoyé. Les règles suivantes s'appliquent :
- DP_INDEX (0x0001) : Champ d'index non ambigu pour chaque fichier du système de fichiers
- DP_DEV (0x0002) : Numéro de périphérique
- DP_RDEV (0x0004) : Champ rdev valide et différent du champ dev
-
- DP_NLINK (0x0008) : Nombre de liens
- DP_UID (0x0010) : Numéro d'utilisateur
- DP_GID (0x0020) : Numéro de groupe
- DP_BLKSIZE (0x0040) : Taille du bloc
- DP_SIZE (0x0080) : Longueur du fichier
- DP_NBLOCKS (0x0100) : Nombre de blocs
- DP_ATIME (0x0200) : Heure du dernier accès
- DP_CTIME (0x0400) : Heure de création du fichier
- DP_MTIME (0x0800) : Heure de la dernière modification
Tous les autres bits sont réservés pour une utilisation ultérieure. |
| DP_VOLNAMEMAX (9) | Longueur maximale d'un nom de volume (0 si les noms de volume ne sont pas pris en charge). |
Une valeur de retour de 0x7fffffff (2^31 -1) signifie qu'il n'y a aucune limite pour le composant interrogé.
Remarque : Dans MagiC, la fonction peut également s'appliquer aux fichiers. Cependant, le nom de fichier est ignoré dans ce cas, c'est-à-dire que seul le chemin est évalué. La fonction doit être appelée dans MagiC après Dopendir si nécessaire, car Dpathconf ne reconnaît pas les modifications de disque (raison : si le chemin est toujours dans le cache, aucun accès au disque n'est effectué et, par conséquent, aucune modification de disque n'est reconnue).
Résultat La fonction renvoie les propriétés/limitations du système de fichiers en fonction du mode de paramètre (voir ci-dessus).
Disponibilité : Dès la version 1.04 de MiNT intégrée à MultiTOS, et depuis la version 3.0 dans MagiC.
...
|
Vous trouverez dans cette zone la liste de toutes les Unités (équivalent des "Librairies" en C) de Pure Pascal. Les Unités indiqués comme standards existent dans la majorité des compilateurs Pascal existant sur ordinateurs 16 bits et au dela (dont Turbo Pascal 3 mini). Les unités indiqués comme Atari sont spécifiques aux systèmes d'exploitation des Atari ST (TOS n.n).
Accès aux unités
Les menus déroulants de chaque unité sont des accès directs aux procédures et fonctions, classés alphabétiquement (sans tenir compte de la casse, puisque le langage Pascal ne tient pas compte de la casse!)
Cette page Unités est issu du fichier UNIT.HLP de la documentation de Pure Pascal (d'Application Systems Heidelberg), qui a été convertie en format TXT puis traduite de l'Allemand grâce à Google Translator : des milliers de copier/coller de et vers Google translator ont été nécessaires, ne connaissant pas un mot d'Allemand!
Les unités CRT, DOS, Graph, Overlay, Printer et System sont standard à TOUS les compilateurs Pascal compatible avec Turbo Pascal 5. L'unité String a été introduit avec Turbo Pascal 7 (Et Pure Pascal 1.1) et permet de manipuler les chaines de caractères de type langage C. Les Unités GEM (VDI et AES) et TOS (BIOS, GEMDOS et XBIOS) sont spécifiques au système Atari ST et contiennent parfois des fonctions équivalentes à certaines fonctions des Unités générales (notamment BIOS). Les fonction XBIOS sont des fonctions permettant de tirer pleinement partie du matériel spécifique Atari, notamment Falcon (Audio, DSP, Blitter, Résolutions étendues etc)