Langage de programmation - Turbo Pascal - Référence de procédures et de fonctions

RENAME	Renomme
Turbo Pascal 1+	System

Syntaxe

Procedure Rename(Var fich:File; nouveaunom:String);	Syntaxe normal
Procedure Rename(Var fich:File; nouveaunom:PChar);	Syntaxe étendu

Paramètres

Nom	Description
fich	Ce paramètre permet d'indiquer l'identificateur de fichier
nouveaunom	Ce paramètre permet d'indiquer le nouveau nom du fichier

Description

Cette procédure permet de renommer le nom d'un fichier.

Remarques

Le paramètre fich est une variable de tout type de fichier. Le paramètre nouveaunom est une expression de type chaîne de caractères ou une expression de type de données PChar si la syntaxe étendue est activée. Le fichier externe associé à fich est renommé nouveaunom. D'autres opérations sur le paramètre fich opèrent sur le fichier externe avec le nouveau nom.
Avec la directive {$I-}, la fonction IOResult renvoie 0 si l'opération a réussi; sinon, il renvoie un code d'erreur différent de zéro.
La procédure Rename ne s'utilise jamais sur un fichier ouvert.

Exemple

L'exemple suivant permet de renommer le nom de fichier ANCIEN.PAS en NOUVEAU.PAS :


	
Program RenameSamples;

 
Var

 F:File;

 Err:Word;

 
BEGIN

  {$I-}Assign(F,'ANCIEN.PAS');

  Rename(F,'NOUVEAU.PAS');

  {$I+}

  Err:=IoResult;

  If Err<>0Then WriteLn('Erreur numero ',Err,' lors de renommage');

END.

Référence

Aide-mémoire de Turbo Pascal versions de 3 à 6, Edition Marabout, De Groote, Virga, 1992, ISBN: 2-501-01833-8, page 355.

Dernière mise à jour : Dimanche, le 25 janvier 2015

Section courante

A propos

Section administrative du site

RENAME