8.14 posixfile --- Objets équivalents aux fichiers, avec support pour le verrouillage

SEEK_END

Le décalage est calculé depuis la fin du fichier.

Le module posixfile définit les fonctions suivantes:

open(nomdefichier[,mode[,taille buffer]])

Création d'un nouvel objet posixfile avec le nom de fichier et le mode passés en argument. Les arguments sont interprétés de la même façon que dans la fonction open() (voir manuel Unix).

fileopen(objetfichier)

Création d'un nouvel objet posixfile avec l'objet fichier passé en argument. L'objet résultat a le même nom de fichier et mode que l'original.

L'objet posixfile définit les méthodes supplémentaires suivantes:

dup()

Duplique l'objet fichier ainsi que le pointeur de fichier interne associé et le descripteur de fichier. Le nouvel objet se comporte comme si le fichier venait d'être ouvert.

dup2(fd)

Duplique l'objet fichier ainsi que le pointeur de fichier interne associé et le descripteur de fichier. Le nouvel objet aura le descritpeur de fichier en question. Sinon, le nouvel objet se comporte comme si le fichier venait d'être ouvert.

file()

Renvoie un objet fichier standard basé sur l'objet posixfile. C'est parfois nécessaire pour certaines fonctions qui imposent un objet de type fichier standard.

Toutes les méthodes lèvent l'exception IOError quand la demande échoue.

Les caractères pour le format de lock() ont la signification suivante:

Format	Signification
u	déverrouille la région spécifiée
r	demande un verrou en lecture pour la section en question
w	demande un verrou en écriture pour la section en question

De plus, les modificateur suivants peuvent être ajoutés au format:

Modificateur	Signification	Note
|	attendre jusqu'à ce que le verrou soit accordé
?	Renvoie le premier verrou en concurrence, ou bien None s'il n'y a pas de conflit.	(1)

Note:

(1)

Le verrou renvoyé est du format (mode, taille, début, whence, pid) avec mode un caractère représentant le type de verrou ('r' ou 'w'). Ce modificateur empèche qu'une requête soit accordée.

Les caractères utilisés pour la définition du format pour flags()sont les suivants:

Format	Signification
a	Ajout de l'indicateur
c	Indicateur de fermeture à l'exécution
n	Indicateur de NON attente (no delay) (ou encore indicateur de NON blocage (non-blocking)
s	Indicateur de synchronisation

Les modificateurs suivant peuvent également être ajoutés:

Modificateur	Signification	Note
!	désactive les indicateurs spécifiés, qui sont par défaut actifs	(1)
=	remplace l'indicateur au lieu de faire un OU logique	(1)
?	Renvoie une chaîne de caractères dans laquelle les caractères représentent les indicateurs qui sont actifs.	(2)

Notes:

(1)

Les modificateurs "!" et "=" sont mutuellement exclusifs.

(2)

Cette chaîne représente les indicateurs après qu'ils aient été modifiés par ce même appel.

Exemples:

import posixfile

file = posixfile.open('/tmp/test', 'w')
file.lock('w|')
...
file.lock('u')
file.close()