DESCRIPTION.

Ecrit le contenu d'objets octet-compatibles dans un fichier.

SYNTAXE.

Variable = os.pwritev ( descripteur , tampons , position , option )

Variable = ⇨ variable qui recevra la valeur [ optionnel ]

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

descripteur ⇨ descripteur du fichier [ OBLIGATOIRE ]

tampons ⇨ liste des objets tampons [ OBLIGATOIRE ]

position ⇨ point de départ [ OBLIGATOIRE ]

option ⇨ option de formatage [ optionnel ]

REMARQUES.

descripteur doit être un int ( ) identifiant un descripteur de fichier valide.

tampons doit être un objet séquence, tel qu'une list ( ) ou tuple ( ), dont les éléments sont des objets de type octet-compatible muable.

position doit être un int ( ) indiquant la position depuis laquelle seront écrits les enregistrements.

option doit être : os.RWF_APPEND,  os.RWF_DSYNC, ou os.RWF_SYNC ou une combinaison des ces options séparées par | (ou logique).

La méthode os.pwritev ( ) n'est disponible que pour les noyaux Linux 2.6.30+, FreeBSD 6.0+, OpenBSD 2.7+, AIX 7.1+. Son utilisation sous d'autres OS, tel que Windows de Microsoft, lèvera une exception. 

L'appel de la méthode os.pwritev ( ) transfère dans le fichier associé à descripteur, à partir de la position position les données présentes dans les objets octet-compatibles, éléments de tampons, en les explorant l'un après l'autre dans leur placement dans tampons. La position du curseur du fichier n'est pas modifier pendant la procédure.

L'appel de la méthode os.pwritev ( ) retourne une un int ( ) indiquant le nombre d'octets qui ont effectivement étaient écrits.

La méthode os.pwritev ( ) revient à fusionner les méthodes de os.writev ( ) et os.pwrite ( ).

Un objet octet-compatible est un objet gérant le protocole tampon et pouvant exporter un tampon (buffer en anglais) C-contigu. Cela inclut les objets bytes ( ), bytearray ( ) et array.array ( ), ainsi que beaucoup d'objets memoryview ( ). Les objets octets-compatibles peuvent être utilisés pour diverses opérations sur des données binaires, comme la compression, la sauvegarde dans un fichier binaire ou l'envoi sur le réseau.

Voir la méthode os.sync ( ) qui force l'écriture de toutes les données sur le disque.

Voir la méthode os.fsync ( ) qui force l'écriture d'un unique fichier, sans modifier ses métadonnées.

Voir la méthode os.fdatasync ( ) qui force l'écriture d'un unique fichier, et met à jour ses métadonnées.

EXEMPLE.

import os

BYA_Un = bytearray ( )

BYA_Deux = bytearray ( )

ksource = os.open ( "votrefichiersource.txt" , os.O_RDWR )

kdestination = os.open ( "votrefichiersource.txt" , os.O_RDWR )

os.preadv ( ksource , [ BYA_Un , BYA_Deux ] , 258 )

os.pwritev ( kdestination , [ BYA_Un , BYA_Deux ] , 32 )