System.Rewrite

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

procedure Rewrite(var F: File; [ RecSize: Integer]); overload;
procedure Rewrite(var F: File; [ RecSize: Integer]); overload;

Propriétés

Type Visibilité  Source Unité  Parent
procedure public System.pas System System

Description

Crée puis ouvre un nouveau fichier.

Dans le code Delphi, Rewrite crée un nouveau fichier externe ayant pour nom celui qui a été affecté à F.

F est une quelconque variable fichier associée à un fichier externe à l'aide de AssignFile. RecSize est une expression facultative qui ne peut être spécifiée que si F est un fichier non typé. Si c'est le cas, RecSize spécifie la taille d'enregistrement à utiliser dans le transfert des données. Si RecSize est omis, une taille d'enregistrement par défaut de 128 octets est supposée. Si RecSize est égal ou inférieur à 0, il déclenche une Erreur d'E/S 106.

Si un fichier externe portant le même nom existe déjà, il est supprimé et un nouveau fichier vide le remplace.

Si F est déjà ouvert, il est d'abord fermé puis rouvert. La position de fichier en cours devient le début du fichier.

Si un nom vide a été affecté à F, par exemple, AssignFile(F,''), F fera référence au fichier standard en entrée après l'appel à Rewrite.

Après l'appel à Rewrite, Eof(F) est toujours à True.

Si une erreur d'E/S survient, Rewrite ferme le fichier. Vous ne devez pas appeler CloseFile.

Remarque :  {$I+} vous permet de gérer les erreurs d'exécution à l'aide des exceptions. Si vous utilisez {$I-}, vous devez faire appel à IOResult afin de détecter les erreurs d'E/S.

Voir aussi

Exemples