Afficher : Delphi C++
Préférences d'affichage

System.Classes.TCustomMemoryStream.Seek

De RAD Studio API Documentation

Delphi

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

C++

virtual __int64 __fastcall Seek(const __int64 Offset, TSeekOrigin Origin)/* overload */;
inline int __fastcall  Seek(int Offset, System::Word Origin){ return TStream::Seek(Offset, Origin); }
inline __int64 __fastcall  Seek _DEPRECATED_ATTRIBUTE0 (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

Exemples de code

Outils personnels
Traductions