OPEN |
Ouvrir |
|---|---|
| Python | |
Syntaxe
| open(nomfichier, mode='r', tailletampon=-1, encoding=None, errors=None, newline=None, closefd=True, opener=None) |
Paramètres
| Nom | Description | |
|---|---|---|
| nomfichier | Ce paramètre permet d'indiquer le nom du fichier selon une représentation d'un chemin système. | |
| mode | Ce paramètre permet d'indiquer le mode d'ouverture à appliquer au fichier (les modes peuvent être combiné) : | |
| Valeur | Description | |
| 'r' | Cette valeur permet d'indiquer une ouverture en mode de lecture. C'est le mode par défaut. | |
| 'w' | Cette valeur permet d'indiquer une ouverture en mode d'écriture. | |
| 'x' | Cette valeur permet d'indiquer une ouverture en mode exclusif de création. Si le fichier existe déjà, l'opération échouera. | |
| 'a' | Cette valeur permet d'indiquer une ouverture en mode ajout à la fin du fichier sans le tronquer. | |
| 't' | Cette valeur permet d'indiquer une ouverture en mode texte. C'est le mode par défaut. | |
| 'b' | Cette valeur permet d'indiquer une ouverture en mode binaire. | |
| '+' | Cette valeur permet d'indiquer une ouverture en mode mise à jour (lecture et écriture). | |
| tailletampon | Ce paramètre permet d'indiquer la taille du tampon | |
| encoding | Ce paramètre permet d'indiquer le nom de l'encodage ou du décodage a utiliser pour le fichier. | |
| errors | Ce paramètre permet d'indiquer une chaîne de caractères spécifiant comment gérer les erreurs d'encodage ou de décodage. | |
| newline | Ce paramètre permet d'indiquer le fonctionnement d'un saut de ligne. Les valeurs possibles sont : None, ' ', '\n', 'r' et '\r\n'. | |
| closefd | Ce paramètre permet d'indiquer qu'il ne faut pas générer d'exception (True) sinon une exception est provoqué (False). | |
| opener | Ce paramètre permet d'indiquer un mode d'ouverture utilisateur, doit retourner un descripteur de fichier ouvert. | |
Description
Cette fonction permet d'effectuer l'ouverture d'un fichier avec les attributs désiré et retourne un identificateur de fichier.
Algorithme
|
MODULE OPEN(chemin_fichier, mode="r", encodage=None) SI le fichier n'existe pas et que mode est en écriture ("w", "a", "x") ALORS Créer un nouveau fichier avec le nom chemin_fichier SINON SI le fichier n'existe pas et que mode est en lecture ALORS Lever une erreur "FileNotFoundError" FIN SI SI mode contient "b" (binaire) ALORS Ouvrir le fichier en mode binaire SINON Ouvrir le fichier en mode texte avec l'encodage spécifié (ou encodage par défaut) FIN SI RETOURNE un objet fichier avec les méthodes de lecture et/ou écriture selon le mode |
Remarque
- Les valeurs de mode les plus couramment utilisées sont «r» pour la lecture, «w» pour l'écriture (tronquer le fichier s'il existe déjà) et «a» pour l'ajout (ce qui sur certains systèmes d'exploitation Unix signifie que toutes les écritures s'ajoutent à la fin) du fichier quelle que soit la position de recherche actuelle). Si le mode est omis, il est par défaut «r». La valeur par défaut consiste à utiliser le mode texte, pouvant convertir les «n» caractères en une représentation spécifique à la plate-forme lors de l'écriture et inversement lors de la lecture. Ainsi, lors de l'ouverture d'un fichier binaire, vous devez ajouter «b» à la valeur de mode pour ouvrir le fichier en mode binaire, ce qui améliorera la portabilité. (L'ajout de «b» est utile même sur les systèmes ne traitant pas différemment les fichiers binaires et les fichiers texte, où il sert de documentation.)
- Le paramètre de mise en mémoire tampon facultatif spécifie la taille de mémoire tampon souhaitée du fichier : 0 signifie sans tampon, 1 signifie ligne avec tampon, toute autre valeur positive signifie utiliser un tampon de (approximativement) cette taille (en octets). Une mise en mémoire tampon négative signifie utiliser la valeur par défaut du système, étant généralement mise en mémoire tampon de ligne pour les périphériques tty et entièrement mise en mémoire tampon pour les autres fichiers. S'il est omis, la valeur par défaut du système est utilisée.
- Les modes «r+», «w+» et «a+» ouvrent le fichier pour la mise à jour (notez que «w+» tronque le fichier). Ajoutez «b» au mode pour ouvrir le fichier en mode binaire, sur les systèmes différenciant les fichiers binaires et les fichiers texte; sur les systèmes n'ayant pas cette distinction, ajouter le «b» n'a aucun effet.
- En plus du mode de valeurs fopen() standard, il peut être «U» ou «rU». Le langage de programmation Python est généralement construit avec le support universel des sauts de ligne; la fourniture de «U» ouvre le fichier sous forme de fichier texte, mais les lignes peuvent se terminer par l'une des paramètres suivantes : la convention de fin de ligne Unix «n», la convention Macintosh «r» ou la convention Windows «rn». Toutes ces représentations externes sont considérées comme «n» par le programme Python. Si Python est construit sans sauts de ligne universels, un mode avec «U» est identique au mode texte normal. Notez que les objets fichier ainsi ouverts ont également un attribut appelé sauts de ligne ayant la valeur None (si aucun saut de ligne n'a encore été vu), «n», «r», «rn», ou un tuple contenant tous les types de sauts de ligne vus.
- Le langage de programmation Python impose que le mode, après suppression de «U», commence par «r», «w» ou «a».
- Le langage de programmation Python fournit de nombreux modules de gestion de fichiers, notamment fileinput, os, os.path, tempfile et shutil.
Dernière mise à jour : Mercredi, le 14 septembre 2016