DESCRIPTION.

Copie des données d'un fichier vers un autre où l'un des fichiers doit être à l'extrémité d'un tube.

SYNTAXE.

Variable = os.splice ( source , destination , octets , depart , arrivee )

Variable = ⇨ variable qui recevra la valeur retournée [ optionnel ]

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

source ⇨ descripteur du fichier source [ OBLIGATOIRE ]

destination ⇨ descripteur du fichier destination [ OBLIGATOIRE ]

octets ⇨ quantité d'octets à copier [ OBLIGATOIRE ]

depart ⇨ position du curseur dans source [ OBLIGATOIRE ]

arrivee ⇨ position du curseur dans destination [ OBLIGATOIRE ]

REMARQUES.

source et destination doivent être : 

- un int ( ) identifiant le descripteur du fichier ;

- None si le fichier est l'extrémité d'un tube.

octets doit être un int ( ) indiquant la quantité d'octets à lire.

depart et arrivee doivent être doit être : 

- un int ( ) indiquant la position depuis laquelle seront lues et/ou écrites les données ;

- None lire et/ou écrire les données depuis la position courante du curseur.

La méthode os.splice ( ) n'est disponible que pour les noyaux Linux 2.6.17 et supérieur avec glibc 2.5+. Son utilisation sous d'autres OS, tel que Windows de Microsoft, lèvera une exception. 

L'appel de la méthode os.splice ( ) va transférer octets octets depuis source vers destination à condition qu'moins l'un d'eux, fasse référence à un tube et qu'il n'y aurait pas de sens à bloquer car il n'y a pas d'écrivains connectés à l'extrémité d'écriture du tube.

source et destination doivent résider dans le même système de fichiers, sinon une une exception est levée

Cette copie est faite sans le coût additionnel de transférer les données depuis le noyau vers l'espace utilisateur puis dans le sens inverse vers le noyau. En outre, certains systèmes de fichiers peuvent implémenter des optimisations supplémentaires. Cette copie est faite comme si les deux fichiers étaient ouverts en mode binaire.

EXEMPLE.

import os

TPL_Extremites = os.pipe (  )

os.sendfile ( None , None , 1024 , None , None )