System.Classes.TCustomMemoryStream.Seek

• Aller au parent : TCustomMemoryStream

Delphi

function Seek(const Offset: Int64; Origin: TSeekOrigin): Int64; override;

C++

virtual __int64 __fastcall Seek(const __int64 Offset, TSeekOrigin Origin)/* overload */;
inline System::LongInt __fastcall  Seek(System::LongInt Offset, System::Word Origin){ return TStream::Seek(Offset, Origin); }
inline __int64 __fastcall  Seek(const __int64 Offset, System::Word Origin){ return TStream::Seek(Offset, Origin); }

Propriétés

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

Description

Déplace la position en cours dans le flux de Offset octets par rapport à la position de départ spécifiée par Origin.

La méthode Seek permet de déplacer, du décalage spécifié, la position en cours dans le flux mémoire. Seek permet à une application de lire ou d'écrire à un emplacement particulier dans la mémoire (Memory) associée au flux mémoire.

Si Offset a une valeur négative, le déplacement se fait en arrière à partir du point de départ spécifié. Le tableau suivant énumère les différentes valeurs que peut prendre Origin et leur signification.

Valeur	Signification
soBeginning	Offset se fait à partir du début de Memory. Seek se déplace vers la position Offset. Offset doit être >= 0.
soCurrent	Offset se fait par rapport à la position en cours. Seek se déplace sur Position + Offset.
soEnd	Offset se fait depuis la fin de Memory. Offset doit être <= 0 afin d'indiquer le nombre d'octets avant la fin du tampon mémoire.

Seek renvoie la nouvelle valeur de la propriété Position.

Remarque :  Seek ne fait pas de vérification sur la valeur transmise dans Offset. Il ne faut pas appeler Seek avec un décalage déplaçant la position en cours avant 0 (avant le début de Memory) ou après Size (après la fin du tampon mémoire).

Voir aussi

• System.Classes.TSeekOrigin
• System.Classes.TCustomMemoryStream.Memory
• System.Classes.TStream.Position
• System.Classes.TCustomMemoryStream.Read
• System.Classes.TStream.Size
• System.Classes.TStream.Write
• System.Classes
• System.Classes
• System.Classes

Exemples de code

• ComponentToString (Delphi)
• ComponentToString (C++)