Lit et transfère un certain nombre de données d'un fichier dans des objets octet-compatibles.

SYNTAXE.

Variable = os.readv ( descripteur , tampons )

Variable = ⇨ variable qui recevra la valeur [ optionnel ]

os.readv ( ) ⇨ 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.readv ( ) n'est disponible que pour UNIX et la plupart des Linux. Son utilisation sous d'autres OS, tel que Windows de Microsoft, lèvera une exception. 

L'appel de la méthode os.readv ( ) lit les octets dans le fichier associé à descripteur et place ces données dans les objets octet-compatibles, éléments de tampons, en les remplissant l'un après l'autre.

L'appel de la méthode os.readv ( ) 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.

EXEMPLE.

import os

BYA_Un = bytearray ( )

BYA_Deux = bytearray ( )

kdescripteur = os.open ( "votrefichier.txt" , os.O_RDWR )

os.readv ( kdescripteur , [ BYA_Un , BYA_Deux ] )