DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des fichiers externes
  • Gestion des erreurs
  • Position en cours
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
<Variable FichierDisque>.Positionne (Fonction)
En anglais : <DiskFile variable>.Seek
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).
L'utilisation des fonctions de lecture (<Variable FichierDisque>.Lit, <Variable FichierDisque>.LitLigne) et d'écriture (<Variable FichierDisque>.Ecrit, <Variable FichierDisque>.EcritLigne) modifie la position en cours.
Exemple
WINDEVWEBDEV - Code ServeurEtats et RequêtesJavaCode Utilisateur (MCU)Ajax
// Ouverture d'un fichier externe 
MonFichierTxt est un FichierDisque
ResPosition est un entier
SI MonFichierTxt.Ouvre("C:\MesRépertoires\Fichier.txt", foLectureEcriture) ALORS
...
// Récupération de la position en cours
ResPosition = MonFichierTxt.Positionne(0, fpCourant)
...
FIN
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 <Variable FichierDisque>.Ouvre ou <Variable FichierDisque>.Cré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 :
fpCourantLa position d'origine correspond à la position en cours.
fpDébutLa position d'origine correspond au premier octet du fichier (position 0).
fpFinLa 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 : wd300std.dll
Version minimum requise
  • Version 28
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 06/09/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale