System.Classes.TStream.CopyFrom

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function CopyFrom(const Source: TStream; Count: Int64 = 0; BufferSize: Integer = $100000): Int64;

C++

__int64 __fastcall CopyFrom(TStream* const Source, __int64 Count = 0LL, int BufferSize = 0x100000);

Propriétés

Type Visibilité  Source Unité  Parent
function public
System.Classes.pas
System.Classes.hpp
System.Classes TStream


Description

Copie directement le nombre spécifié d'octets d'un flux vers un autre flux.

Utilisez CopyFrom pour copier les données d'un flux vers un autre flux. L'utilisation de CopyFrom évite de devoir créer un tampon depuis lequel il faut lire les données et les écrire, et qu'il faut enfin libérer.

CopyFrom copie Count octets du flux spécifié par Source dans ce flux. La méthode déplace ensuite la position en cours de Count octets et renvoie le nombre d'octets copiés.

Si Count a la valeur 0, CopyFrom définit la position de Source à 0 avant de lire les données, puis copie tout le contenu de Source dans ce flux. Si Count est supérieur ou inférieur à 0, CopyFrom lit à partir de la position en cours dans Source.

Puisque la méthode CopyFrom utilise les méthodes ReadBuffer et WriteBuffer pour rendre la copie effective, si le paramètre Count est supérieur à la taille SourceStream, ReadBuffer déclenche une exception indiquant qu'une erreur de lecture de flux s'est produite.

Voir aussi

Exemples de code