DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Attention : Il s'agit de la version 26 de cette page de documentation. Cette fonctionnalité peut avoir été modifiée ou supprimée en version supérieure.
Aide / WLangage / Gestion des bases de données / Fonctions HFSQL / Fonctions Hyper File compatibles
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
HSubstNom (Fonction)
En anglais : HSubstName
HFSQLDisponible uniquement avec ce type de connexion
Avertissement
La fonction HSubstNom est conservée uniquement pour compatibilité (cette fonction sera encore supportée dans la prochaine version).
A partir de la version 8, la fonction HSubstNom est remplacée par la fonction HChangeNom.
Voici la documentation de la fonction HSubstNom disponible avec WINDEV 5.5.
 
But
Modifier le nom (physique) d'un fichier de données
Syntaxe
HSubstNom(<NomLogiqueFic>, <NomPhysiqueFic>)
  • <NomLogiqueFic> est le nom du fichier donné lors de sa description.
  • <NomPhysiqueFic> est le nom physique donné au fichier sur le disque (260 caractères maxi, si le disquet supporte les noms longs).
Détail
Par défaut un fichier est créé sous :
  • nom long si le disque supporte les noms longs
  • nom logique si le disque ne supporte pas les noms longs
Après l'appel de HSubstNom, le fichier ayant le nom logique <Nom_Logique> sera ouvert sous le nom <Nom_Physique>.
Les modifications de nom sont mémorisées dans le fichier ".REP", s'il est branché.
HSubstNom dont le paramètre <Nom_Physique> est une chaîne vide annule la substitution de nom demandée pour <Nom_Logique>.
Si le fichier est déjà ouvert, HSubstNom n'a pas d'effet. Il faut alors au préalable fermer le fichier avec HFerme.
Attention : HSubstNom est limité à 50 fichiers : il n'est possible de changer le nom que pour 50 fichiers différents.
Notes
  • Par défaut, le nom physique correspond au nom logique. HSubstNom doit être utilisé lorsque le nom défini lors de la description du fichier est différent du nom du fichier sur le disque.
  • Par défaut la gestion du .REP est branchée.
  • HSubstNom peut être appelée plusieurs fois avec des paramètres différents. Si le même nom de fichier logique est redéfini plusieurs fois, le dernier nom sera pris en compte lors de l'ouverture du fichier.
  • Le nom physique du fichier ne doit contenir ni le lecteur, ni le répertoire.
  • Pour modifier le lecteur et/ou le répertoire d'un fichier, il faut utiliser HSubstRep ou HAssigne.
  • Les appels des autres fonctions doivent toujours faire référence au <Nom_Logique> et non pas au nom physique.
  • La fermeture du fichier (HFerme) conserve le HSubstNom.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 18/08/2020

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