DESCRIPTION.

Recopie un nombres d'octets d'un fichier dans un autre.

SYNTAXE.

Valeurs = os.copy_file_range ( source , destination , octets , debut , decalage )

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

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

source ⇨ fichier source [ OBLIGATOIRE ]

destination ⇨ fichier destination [ OBLIGATOIRE ]

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

debut ⇨ position du premier octet à copier [ optionnel ]

decalage ⇨ position du premier octet copier [ optionnel ]

REMARQUES.

source doit être un str ( ) identifiant un fichier valide. source est le fichier qui fournira les octets à copier.

destination doit être un str ( ) identifiant un fichier valide. destination est le fichier qui recevra et ajoutera les octets à copier.

source et destination doivent être présents dans le même système de fichiers, sinon une exception est levée.

octets doit être un int ( ) indiquant la quantité d'octets du fichier source qui seront copiés dans le fichier destination.

debut doit être un int ( ) indiquant la position du premier octet, dans source, qui sera copié dans destination. Si debut est omis, où s'il vaut None, valeur par défaut, alors debut sera la position actuel du pointeur dans source.

decalage doit être un int ( ) indiquant la position où sera copié, dans destination, le premier octet lu de puis source. Si decalage est omis, où s'il vaut None, valeur par défaut, alors decalage sera la position actuel du pointeur dans destination.

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

source et destination doivent être présents dans le même système de fichiers, sinon 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.

L'appel de la méthode os.copy_file_range ( ) retourne un int ( ) indiquant le nombre d'octets réellement copiés, cela peut donc être inférieur octets.

Voir le manuel de Linux pour plus de détails sur la commande copy_file_range().

EXEMPLE.

import os

os.copy_file_range ( "votresoures.txt" , "votredestintion.txt." , 127 )