DESCRIPTION.

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

SYNTAXE.

Variable = os.writev ( descripteur , tampons )

Variable = ⇨ variable qui recevra la valeur [ optionnel ]

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

descripteur ⇨ descripteur du fichier [ OBLIGATOIRE ]

tampons ⇨ liste des objets tampons [ OBLIGATOIRE ]

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.

La méthode os.writev ( ) 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.writev ( ) transfère dans le fichier associé à descripteur 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 est positionné après le dernier octet copié.

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

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.readv ( ksource , [ BYA_Un , BYA_Deux ] , 258 )

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