Renvoie et modifie la position en cours dans un fichier externe.
A l'ouverture d'un fichier, la position en cours correspond :
- au premier octet du fichier,
- au dernier octet du fichier si le fichier est ouvert en mode "ajout" (constante foAjout).
Syntaxe
<Résultat> = <Fichier manipulé>.Positionne(<Déplacement> , <Position d'origine>)
<Résultat> : Entier
- Position en cours après modification,
- -1 en cas d'erreur. Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
<Fichier manipulé> : Variable de type FichierDisque
Nom de la variable de type FichierDisque initialisée avec la fonction fOuvre ou fCrée.
<Déplacement> : Entier
Nombre d'octets (caractères) correspondant au déplacement voulu dans le fichier. Dans le cas d'un déplacement depuis la fin du fichier (constante fpFin), ce nombre doit être négatif.
<Position d'origine> : Constante
Indique la position d'origine : | |
| fpCourant | La position d'origine correspond à la position en cours. |
| fpDébut | La position d'origine correspond au premier octet du fichier (position 0). |
| fpFin | La position d'origine correspond au dernier octet du fichier. |
Remarques
Gestion des erreurs
La fonction
<Variable FichierDisque>.Positionne génère une erreur dans les cas suivants :
- le fichier n'est pas ouvert,
- le fichier est bloqué par un autre poste ou par une autre application.
Position en cours
Pour récupérer la position en cours dans le fichier externe, utilisez la syntaxe suivante :
NomFichier est un FichierDisque
...
PositionEnCours = NomFichier.Positionne(0, fpCourant)
Aucun déplacement n'est effectué dans le fichier spécifié.
Classification Métier / UI : Code métier
Composante : wd280std.dll