DESCRIPTION.

Ouvre un fichier et retourne son descripteur.

SYNTAXE.

Variable = os.open ( fichier , option , acces , * , chemin )

Variable = ⇨ variable qui recevra la valeur [ optionnel ]

os.open ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

fichier ⇨ nom du fichier à ouvrir [ OBLIGATOIRE ]

option ⇨ options d'ouverture [ OBLIGATOIRE ]

acces ⇨ autorisations accordées [ optionnel ]

* ⇨ autres options [ optionnel ]

chemin ⇨ chemin relatif [ optionnel ]

REMARQUES.

Il fortement conseillé d'utiliser plutot la méthode native open ( ), associée à l'instruction with, pour la manipulation et la gestion du contenu des fichiers.

fichier doit être un : 

- str ( ), ou un bytes ( ), indiquant le chemin absolu, ou relatif, d'un fichier présent sur l'un des supports de masse disponibles ; 

- int ( ) correspondant au descripteur d'un fichier actuellement ouvert.

option dépend fortement du système présent sur la machine de l'hote, les valeurs les plus fréquentes sont :

- os.O_APPEND , sous Unix (Linux) et Windows ;

- os.O_ASYNC , si définie par la bibliothèque C ;

- os.O_BINARY , sous Windows de microsoft uniquement ;

- os.O_CLOEXEC , sous Unix (Linux) uniquement ;

- os.O_CREAT , sous Unix (Linux) et Windows ;

- os.O_DIRECT , si définie par la bibliothèque C ;

- os.O_DIRECTORY , si définie par la bibliothèque C ;

- os.O_DSYNC , sous Unix (Linux) uniquement ;

- os.O_EVTONL , sous MacOS de Apple uniquement ;

- os.O_EXCL , sous Unix (Linux) et Windows ;

- os.O_EXLOCK , si définie par la bibliothèque C ;

- os.O_FSYNC , sous MacOS de Apple uniquement ;

- os.O_NOATIME , si définie par la bibliothèque C ;

- os.O_NDELAY , sous Unix (Linux) uniquement ;

- os.O_NOCTTY , sous Unix (Linux) uniquement ;

- os.O_NOFOLLOW , si définie par la bibliothèque C ;

- os.O_NOFOLLOW_ANY , sous MacOS de Apple uniquement ;

- os.O_NOINHERIT , sous Windows de microsoft uniquement ;

- os.O_NONBLOCK , sous Unix (Linux) uniquement ;

- os.O_PATH , si définie par la bibliothèque C ;

- os.O_RANDOM , sous Windows de microsoft uniquement ;

- os.O_RDONLY , sous Unix (Linux) et Windows ;

- os.O_RSYNC , sous Unix (Linux) uniquement ;

- os.O_RDWR , sous Unix (Linux) et Windows ;

- os.O_SEQUENTIAL , sous Windows de microsoft uniquement ;

- os.O_SHLOCK , si définie par la bibliothèque C ;

- os.O_SHORT_LIVED , sous Windows de microsoft uniquement ;

- os.O_SYMLINK , sous MacOS de Apple uniquement ;

- os.O_SYNC , sous Unix (Linux) uniquement ;

- os.O_WRONLY , sous Unix (Linux) et Windows ;

- os.O_TEMPORARY , sous Windows de microsoft uniquement ;

- os.O_TEXT , sous Windows de microsoft uniquement ;

- os.O_TMPFILE , Linux Kernel 3.11 et supérieur uniquement ;

- os.O_TRUNC , sous Unix (Linux) et Windows.

Se référer aux manuels des systèmes d'exploitation respectifs pour plus de détail sur les spécifications de ces options.

Plusieurs options peuvent être données si elles sont séparées par l'opérateur | (OR).

acces doit être un int ( ), souvent exprimé sous forme octale, qui déterminera les permissions par complétion de 0o0666 (438 en décimal) pour les fichiers et de 0o0777 (511 en décimal) pour les répertoires qui seront créés ultérieurement par les appels systèmes creat() et mkdir(), c'est-à-dire que les permissions seront obtenues par l'opération binaire 0o0777 (ou 0o0666) AND NOT masque. Autrement dit, les bits du masque sont annulés, ce qui signifie que les droits correspondant à ces bits sont supprimés. mode est un attribut nommée mode = valeur. Par défaut valeur vaut 0o777.

chemin doit être valide pour être un des chemins relatifs à des descripteurs de répertoires.

L'utilisation de la méthode os.open ( ) doit être réservée pour la gestion des entrées / sorties de bas niveau. Pour tous les autres usages, il faut recourir à la méthode native open ( ), encapsulée dans un bloc with, qui retourne un objet fichier, qui pourra manipuler les méthodes open ( ).read ( ) et open ( ).write ( ), en autres.

EXEMPLE.

import os

os.open ( "votrefichier.txt" , os.O_RDONLY )