PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Déclaration d'une variable de type Enregistrement
  • Accès aux rubriques
  • Lecture et affectation d'une variable de type Enregistrement
  • Cas particuliers
  • Fonctions manipulant le type Enregistrement
  • Propriétés spécifiques à la description des variables de type Enregistrement
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Le type Enregistrement permet de manipuler (modifier, sauvegarder, ...) les valeurs d’un enregistrement. Cet enregistrement peut être un enregistrement d'un fichier de données, d'une requête ou d'une vue. La variable associée au type Enregistrement sera structurée comme un enregistrement de la base de données.
Exemples d'utilisation : Il est ainsi possible de mémoriser dans différentes variables le contenu de différents enregistrements pour les comparer ou comparer certaines rubriques.
Versions 23 et supérieures
iPhone/iPad Ce type de variable est désormais disponible pour les applications iPhone/iPad.
Android Ce type de variable est désormais disponible pour les applications Android.
Widget Android Ce type de variable est désormais disponible en mode Widget Android.
Nouveauté 23
iPhone/iPad Ce type de variable est désormais disponible pour les applications iPhone/iPad.
Android Ce type de variable est désormais disponible pour les applications Android.
Widget Android Ce type de variable est désormais disponible en mode Widget Android.
iPhone/iPad Ce type de variable est désormais disponible pour les applications iPhone/iPad.
Android Ce type de variable est désormais disponible pour les applications Android.
Widget Android Ce type de variable est désormais disponible en mode Widget Android.
Exemple
EnregClient est un Enregistrement de CLIENT

HLitPremier(CLIENT, NUMCLI)
SI PAS HEnDehors() ALORS
EnregClient = CLIENT
// Affichage du nom et prénom du client
Info(EnregClient.NOM, EnregClient.PRENOM)
FIN
EnregClient est un Enregistrement de CLIENT

EnregClient.Nom = "DUPONT"
EnregClient.Prénom = "Paul"
EnregClient.Ville = "MONTPELLIER"

// Affecte le contenu de la variable EnregClient dans le buffer du fichier CLIENT
CLIENT = EnregClient  

HAjoute(CLIENT)

// Il est également possible de faire : HAjoute(CLIENT, EnregClient)
Remarques

Déclaration d'une variable de type Enregistrement

La syntaxe de déclaration d'une variable de type Enregistrement est la suivante :
<Nom Variable> est un Enregistrement [de <Nom du fichier de l'analyse>]
  • Si le paramètre <Nom du fichier de l'analyse> est indiqué, l'enregistrement est associé à une description d'un des fichiers de données présent dans l'analyse. Dans ce cas, il est possible de manipuler les différentes rubriques de l'enregistrement.
  • Si le paramètre <Nom du fichier de l'analyse> n'est pas indiqué, la structure de l'enregistrement sera construite dynamiquement en fonction du buffer du fichier qui lui sera alloué.

Accès aux rubriques

Pour accéder aux rubriques d'une variable de type Enregistrement, la syntaxe est la suivante :
  • Pour affecter une rubrique de la variable :
    <Nom Variable>.<Nom rubrique> = <Valeur à affecter>
  • Pour récupérer la valeur des rubriques :
    <Valeur> = <Nom Variable>.<Nom rubrique>
Remarque : Lors de l'utilisation d'une variable de type Enregistrement associée à un fichier de données de l'analyse, l'éditeur de code propose automatiquement les différentes rubriques de l'enregistrement :

Lecture et affectation d'une variable de type Enregistrement

Une variable de type Enregistrement peut être lue ou affectée. La syntaxe est la suivante :
  • Pour mémoriser le buffer d'un fichier de données dans une variable de type Enregistrement :
    <Nom de la variable Enregistrement> = <Nom du fichier de données>
  • Pour affecter le buffer d'un fichier de données depuis une variable de type Enregistrement :
    <Nom du fichier de données> = <Nom de la variable Enregistrement>

Cas particuliers

  • La fonction HRécupèreEnregistrement utilisée sur une variable de type Enregistrement retourne une chaîne de caractères contenant la valeur de chaque rubrique séparée par un caractère TAB.
  • Si une variable de type Enregistrement typée sur un fichier de données est affectée avec le buffer d'un autre fichier, il n'y a pas d'erreur de compilation. Une copie homonymique des buffers est effectuée : seules les rubriques de même nom de chaque buffer seront affectées. Les autres rubriques ne seront pas affectées.
  • Seule la sérialisation de type JSON est disponible pour ce type de variable (fonction Sérialise). Aucune désérialisation n'est disponible.

Fonctions manipulant le type Enregistrement

Les fonctions suivantes utilisent le type Enregistrement :
Versions 09 et supérieures
HAjoute
Nouveauté 09
HAjoute
HAjoute
Ajoute :
  • l'enregistrement présent en mémoire dans le fichier de données (la requête ou la vue).
  • l'enregistrement présent dans une variable de type Enregistrement dans le fichier de données (la requête ou la vue).
Versions 09 et supérieures
HAttacheMémo
Nouveauté 09
HAttacheMémo
HAttacheMémo
Permet d'associer un fichier à une rubrique de type mémo binaire ou d'annuler l'attachement existant entre un fichier et une rubrique binaire.
Versions 09 et supérieures
HCopieEnreg
Nouveauté 09
HCopieEnreg
HCopieEnreg
Copie :
  • le contenu de l'enregistrement en cours (chargé en mémoire) dans l'enregistrement en cours d'un fichier de données.
  • le contenu d'une variable de type Enregistrement dans l'enregistrement en cours d'un fichier de données.
Versions 09 et supérieures
HExtraitMémo
Nouveauté 09
HExtraitMémo
HExtraitMémo
Extrait le contenu d'une rubrique de type mémo binaire d'un fichier HFSQL, d'une requête ou d'une vue HFSQL dans un fichier physique (sur le disque).
Versions 09 et supérieures
HInfoMémo
Nouveauté 09
HInfoMémo
HInfoMémo
Renvoie les caractéristiques des mémo binaire et texte.
Versions 09 et supérieures
HListeRubrique
Nouveauté 09
HListeRubrique
HListeRubrique
Renvoie la liste des rubriques :
  • présentes dans un fichier de données (d'une requête ou d'une vue) reconnu par le moteur HFSQL. Les fichiers de données définis par les fonctions HDéclare, HDéclareExterne et HDécritFichier sont pris en compte.
  • présentes dans une variable de type Enregistrement.
Versions 09 et supérieures
HRAZ
Nouveauté 09
HRAZ
HRAZ
Initialise :
  • une ou toutes les variables des rubriques d'un fichier de données avec leurs valeurs par défaut.
  • une ou toutes les rubriques d'une variable de type Enregistrement avec leurs valeur par défaut.
Versions 09 et supérieures
HRécupèreEnregistrement
HRécupèreEnregistrement
Renvoie le contenu de l'enregistrement en cours (dans un fichier, une vue, une requête, ...).
Remarque : Pour réinitialiser le contenu d’une variable de type Enregistrement, il est également possible d’utiliser la fonction VariableRAZ.

Propriétés spécifiques à la description des variables de type Enregistrement

Les propriétés suivantes peuvent être utilisées pour connaître les caractéristiques d'une variable de type Enregistrement :
Nom de la propriétéType manipuléEffet
ContenuChaîne de caractèresContenu de l'enregistrement en cours (identique au résultat renvoyé par la fonction HRécupèreEnregistrement).
Cette propriété est disponible en lecture uniquement.
FichierAssociéChaîne de caractèresNom du fichier HFSQL sur lequel la variable est basée.
Cette propriété est disponible en lecture uniquement.
Remarque : Ces propriétés peuvent être utilisées avec une des deux syntaxes suivantes :
  • <Nom de la variable>..<Nom de la propriété>
  • <Nom de la variable>.<Nom de la propriété>
Version minimum requise
  • Version 19
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire