PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

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
HImporteTexte_55 (Fonction)
En anglais : HImportText_55
La fonction HImporteTexte_55 est équivalente à la fonction HImporteTexte disponible avec WINDEV 5.5.
Cette fonction est conservée uniquement pour compatibilité (cette fonction sera encore supportée dans la prochaine version).
En version 8, la fonction HImporteTexte a évolué et permet de gérer un résultat de fonction plus simple. Pour bénéficier de toutes les nouveautés, utilisez la nouvelle syntaxe de la fonction HImporteTexte.
Voici la documentation disponible avec WINDEV 5.5. Attention : les noms des variables ont changé.
 
But
Importer un fichier texte dans un fichier Hyper File.
Syntaxe
<CodeErreur> = HImporteTexte_55(<NomFichierLogiqueHF> , <NomFichierTexte> [ , <ListeRubriques> [ , <Séparateurs> [ , <ModeImportation> [ , <HandleFenetre> ]]]])
  • <CodeErreur> est un entier indiquant le résultat de l'importation (0 en cas de succès)
  • <NomFichierLogiqueHF> est une chaîne de caractères correspondant au nom du fichier logique Hyper File destination de l'importation.
  • <NomFichierTexte> est une chaîne de caractères correspondant au nom du fichier texte à importer, avec son chemin complet
  • <ListeRubriques> est une chaîne de caractères spécifiant la liste des rubriques du fichier Hyper File présentes dans le fichier texte
  • <Séparateurs> est une chaîne de caractères permettant de définir les différents séparateurs employés (séparateur de colonnes, de lignes, et le délimiteur de chaînes)
  • <ModeImportation> est un entier permettant de définir les caractéristiques de l'importation (voir Détail)
  • <HandleFenetre> est un entier long qui contient le handle de la fenêtre recevant la jauge, ou NULL si pas de jauge.
Détail
La fonction HImporteTexte_55 permet d'importer le contenu d'un fichier texte dans un fichier Hyper File, précédemment décrit sous l'éditeur d'analyse.
Le paramètre <ListeRubriques> permet d'indiquer quelles sont les rubriques du fichier <NomFichierLogiqueHF> à importer. Ce paramètre est de la forme :
"<NomRubrique1> , <NomRubrique2> , <NomRubrique3>, ..., <NomRubriqueN>"

Dans le fichier texte à importer, chaque enregistrement correspond à une "ligne", et chaque rubrique correspond à une "colonne".

Par défaut, les séparateurs utilisés sont :
  • la virgule pour les colonnes
  • la double quote ( " ) pour les chaînes
  • RC (Retour Chariot) pour les lignes.
Le paramètre <Séparateur> permet de modifier les séparateurs utilisés par défaut. Ce paramètre est de la forme :
<SéparateurColonnes> + Caract(127) + <DélimiteurChaînes> + Caract(127) + <SéparateurLignes>

Attention : le délimiteur de chaînes est limité à un caractère.
Exemple : Si les colonnes sont séparées dans le fichier texte par une tabulation (TAB) , <Séparateur> = TAB+ Caract(127)+" " " "+ Caract(127)+RC
Les caractéristiques de l'importation sont données par le paramètre <ModeImportation>. Ce paramètre correspond à une des constantes (ou à une combinaison des constantes suivantes :
hImpNormalAjout des enregistrements importés au fichier (.FIC) existant (valeur par défaut)
hImpCréationCréation du fichier où les enregistrements sont ajoutés (si le fichier ".Fic" existe déjà, il est écrasé)
hImpOEM2ANSIConversion OEM vers ANSI des chaînes importées
hImpTestDoublonTest des doublons lors de l'importation
hImpTestIntegriteTest de l'intégrité lors de l'importation
hImpSansDelimiteurLes délimiteurs de chaînes ne sont pas pris en compte
Remarques :
  • hImpSansDélimiteur permet de considérer le séparateur de colonnes comme séparateur de chaînes.
  • Importation d'une ligne sans séparateur de chaînes :
    La ligne du fichier texte est la suivante : Martin,Jean,34000,Montpellier
    L'enregistrement correspondant dans le fichier Hyper File sera :
    • Nom : Martin
    • Prénom : Jean
    • CodeP : 34000
    • Ville Montpellier
  • Importation d'une ligne avec séparateur de chaînes :
    La ligne du fichier texte est la suivante : "Martin","Jean, Pierre","34000","Montpellier"
    L'enregistrement correspondant dans le fichier Hyper File sera :
    • Nom : Martin
    • Prénom : Jean, Pierre
    • CodeP : 34000
    • Ville Montpellier
  • Les différents <codes d'erreurs> renvoyés par HImporteTexte sont les suivants :
    • 0 : Importation réussie
    • 1: erreur d'allocation de la structure d'importation
    • 2: erreur à l'init de HF
    • 3: fichier inconnu
    • 4: fichier texte introuvable
    • 5: mode invalide
    • 6: liste des rubriques invalide
    • 7: ouverture du fichier HF
    • 8: ouverture du fichier texte
    • 9: fin de fichier atteinte
    • 10: allocation du buffer de lecture
    • 11: chaîne incorrecte
    • 12: erreur pendant la récupération d'une colonne
    • 13: erreur pendant le transfert d'une colonne vers une rubrique HF
    • 14: ligne incorrecte
Notes
  • Les types de rubrique Hyper File gérés sont les suivants :
    • Caractères,
    • Entier court non signé sur 1 octet
    • Entier signé et non signé sur 16 bits
    • Entier signé sur 32 bits
    • Réel simple sur 32 bits
    • Réel au format TurboPascal
    • Réel double sur 64 bits
    • Type monétaire (sur 10 octets)
    • Chaîne :
      • dynamique (64 k maximum)
      • comblée par des espaces
      • précédée par sa longueur
      • terminée par un 0
    • Les rubriques tableau ne sont pas gérées
  • Cette fonction ne concerne que les fichiers Hyper File.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire