System.Classes.TStream.WriteBuffer

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

procedure WriteBuffer(const Buffer; Count: NativeInt); overload;
procedure WriteBuffer(const Buffer: TBytes; Count: NativeInt); overload; inline;
procedure WriteBuffer(const Buffer: TBytes; Offset, Count: NativeInt); overload;

C++

void __fastcall WriteBuffer(const void *Buffer, System::NativeInt Count)/* overload */;
void __fastcall WriteBuffer(const System::Sysutils::TBytes Buffer, System::NativeInt Count)/* overload */;
void __fastcall WriteBuffer(const System::Sysutils::TBytes Buffer, System::NativeInt Offset, System::NativeInt Count)/* overload */;

Propriétés

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


Description

Ecrit Count octets depuis Buffer vers le flux.

WriteBuffer tente d'écrire Count octets depuis Buffer vers la position en cours dans le flux, puis WriteBuffer avance la position en cours selon Count. Si le flux ne peut écrire le nombre spécifié d'octets, une exception EWriteError est déclenchée.

Offset spécifie une position basée sur zéro dans Buffer à partir de laquelle sera écrit le premier octet.

Utilisez la méthode WriteBuffer pour enregistrer des données dans un flux. WriteBuffer est utilisée dans les situations où le nombre d'octets écrit est connu et impératif, par exemple pour l'écriture de structures. Utilisez WriteBuffer pour les opérations standard d'entrées/sorties dans un flux.

WriteBuffer est utilisée en interne pour écrire dans un flux. Cette méthode est utilisée par d'autres objets, comme les chaînes ou les listes, afin d'écrire des chaînes dans un tampon.

WriteBuffer appelle Write pour effectuer réellement l'écriture.

Voir aussi