DESCRIPTION.

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

SYNTAXE.

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

Variable = ⇨ variable qui recevra la valeur [ optionnel ]

os.pread ( ) ⇨ 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 on pense accéder aux enregistrements.

option doit être : os.RWF_HIPRI , os.RWF_NOWAIT ou os.RWF_HIPRI | os.RWF_NOWAIT.

La méthode os.preadv ( ) 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.preadv ( ) lit les octets dans le fichier associé à descripteur, à partir de la position position et place ces données dans les objets octet-compatibles, éléments de tampons, en les remplissant l'un après l'autre. La position du curseur du fichier n'est pas modifier pendant la procédure.

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

L'option os.RWF_HIPRI indique que la lecture et l'écriture des données est de haute priorité. Permet aux systèmes de fichiers de type bloc d'utiliser le polling du périphérique, qui fournit une latence inférieure, mais peut utiliser des ressources supplémentaires.cette fonctionnalité est utilisable uniquement sur un descripteur de fichier ouvert à l'aide de l'option os.O_DIRECT.

L'option os.RWF_NOWAIT indique qu'il ne faut pas attendre pour des données qui ne sont pas immédiatement disponibles. Si cette option est spécifiée, l'appel système retourne instantanément s'il doit lire les données du stockage sous-jacent ou attendre un verrou.

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