4D v16.3

Identifiants

Accueil

 
4D v16.3
Identifiants

Identifiants  


 

 

Cette section détaille les règles d'écriture et de nommage appliquées aux divers identifiants utilisés dans le langage de 4D (variables, tableaux, formulaires, etc.) :

  • Un nom doit commencer par un caractère alphabétique (une lettre) ou un tiret bas.
  • Le nom peut ensuite contenir des caractères alphabétiques, des caractères numériques, des espaces et des tirets bas (_).
  • Les virgules, barres de fraction, guillemets et deux points (:) sont interdits.
  • Les points (.) et les crochets ([ ]) sont interdits dans les noms de tables, champs, méthodes ou variables lorsque la notation objet est activée (cf. section Notation objet).
  • Les caractères réservés car utilisés comme opérateurs, comme l’astérisque (*) ou le +, sont interdits.
  • 4D ignore les espaces superflus.

Note : Des règles supplémentaires sont à respecter lorsque les objets doivent être manipulés via le SQL : seuls les caractères _0123456789abcdefghijklmnopqrstuvwxyz sont acceptés, et le nom ne doit pas comporter de mot-clé SQL (commande, attribut, etc.). La zone "SQL" de l'inspecteur de l'éditeur de Structure signale automatiquement les caractères non autorisés dans un nom de table ou de champ.

Tables  

Vous désignez une table en plaçant son nom entre crochets : [...]. Un nom de table peut contenir jusqu’à 31 caractères.

Exemples

 TABLE PAR DEFAUT([Commandes])
 FORM FIXER ENTREE([Clients];"Entrée")
 AJOUTER ENREGISTREMENT([Lettres])

Champs  

Vous désignez un champ en spécifiant d’abord la table à laquelle il appartient. Le nom du champ se place immédiatement derrière celui de la table. Un nom de champ peut contenir jusqu’à 31 caractères.

Exemples
 [Commandes]Total:=Somme([Ligne]Montant)
 CHERCHER([Clients];[Clients]Nom="Dupont")
 [Lettres]Texte:=Capitaliser texte([Lettres]Texte)

Vous désignez une variable interprocess en faisant précéder son nom des symboles (<>), formés des caractères “inférieur à” suivi de “supérieur à”.

Note : Cette syntaxe peut être utilisée sous Windows et Mac OS. De plus, sous Mac OS, vous pouvez également utiliser le caractère "diamant" (Option + v sur un clavier français).

Le nom d’une variable interprocess peut contenir jusqu’à 255 caractères(*), symbole <> non compris.

(*) 31 caractères si l'option de compatibilité "Enregistrer les méthodes en Unicode" est désélectionnée (cf. section Page Compatibilité).

Exemples

 <>vlProcessID:=Numero du process courant
 <>vsKey:=Caractere(KeyCode)
 Si(<>vtNom#"")

Vous désignez une variable process en écrivant simplement son nom (qui ne doit pas commencer par les symboles $ ou <>). Ce nom peut contenir jusqu’à 255 caractères(*).

(*) 31 caractères si l'option de compatibilité "Enregistrer les méthodes en Unicode" est désélectionnée (cf. section Page Compatibilité).

Exemples

 vrGrandTotal:=Somme([Comptes]Montant)
 Si(bValider=1)
    vsNomCourant:=""

Vous désignez une variable locale en faisant précéder son nom du symbole dollar ($). Le nom d’une variable locale peut contenir jusqu’à 255 caractères(*), signe dollar non compris.

(*) 31 caractères si l'option de compatibilité "Enregistrer les méthodes en Unicode" est désélectionnée (cf. section Page Compatibilité).

Exemples

 Boucle($vlEnregistrement;1;100)
    Si($vsTempVar="No")
       $vsMaChaîne:="Bonjour à tous"

Vous désignez un tableau en écrivant simplement son nom, qui est celui que vous passez à une commande de déclaration de tableau (par exemple TABLEAU ENTIER LONG) lorsque vous créez le tableau. Les tableaux sont des variables, et comme pour les variables, il existe trois types de tableaux qui se différencient par leur portée :

  • Tableaux interprocess,
  • Tableaux process,
  • Tableaux locaux.

Tableaux interprocess
Le nom d’un tableau interprocess est précédé du symbole (<>), formé des caractères “inférieur à” suivi de “supérieur à”.

Note : Cette syntaxe peut être utilisée sous Windows et Mac OS. De plus, sous Mac OS, vous pouvez également utiliser le caractère "diamant" (Option + v sur un clavier français).

Le nom d’un tableau interprocess peut contenir jusqu’à 255 caractères(*), symbole <> non compris.

Exemples

 TABLEAU TEXTE(<>atSujets;Enregistrements dans table([Topics]))
 TRIER TABLEAU(<>asMotsClés;>)
 TABLEAU ENTIER(<>aiGrosTableau;10000)

Tableaux process
Vous désignez un tableau process en écrivant simplement son nom (qui ne doit pas commencer par les symboles $ ou <>). Ce nom peut contenir jusqu’à 255 caractères(*).

Exemples

 TABLEAU TEXTE(atSujets;Enregistrements dans table([Topics]))
 TRIER TABLEAU(asMotsClés;>)
 TABLEAU ENTIER(aiGrosTableau;10000)

Tableaux locaux
Un tableau est déclaré local lorsque son nom est précédé du signe dollar ($). Le nom d’un tableau local peut contenir jusqu’à 255 caractères(*), signe dollar non compris.

Exemples

 TABLEAU TEXTE($atSujets;Enregistrements dans table([Topics]))
 TRIER TABLEAU($asMotsClés;>)
 TABLEAU ENTIER($aiGrosTableau;10000)

(*) 31 caractères si l'option de compatibilité "Enregistrer les méthodes en Unicode" est désélectionnée (cf. section Page Compatibilité).

Eléments de tableaux
Vous désignez un élément d’un tableau local, process ou interprocess à l’aide d’accolades ({…}). L’élément référencé (l’indice) est indiqué par une expression numérique.

Exemples

  ` Adresser un élément d'un tableau interprocess
 Si(<>asMotsClés{1}="Stop")
    <>atSujets{$vlElem}:=[Topics]Sujet
    $viValeurSuivante:=<>aiGrosTableau{Taille tableau(<>aiGrosTableau)}
 
  ` Adresser un élément d'un tableau process
    Si(asMotsClés{1}="Stop")
       atSujets{$vlElem}:=[Topics]Sujet
       $viValeurSuivante:=aiGrosTableau{Taille tableau(aiGrosTableau)}
 
  ` Adresser un élément d'un tableau local
       Si($asMotsClés{1}="Stop")
          $atSujets{$vlElem}:=[Topics]Sujet
          $viValeurSuivante:=$aiGrosTableau{Taille tableau($aiGrosTableau)}

Eléments de tableaux à deux dimensions
Vous désignez un élément d’un tableau à deux dimensions à l’aide d'une double paire d’accolades ({…}). L’élément référencé (l’indice) est indiqué par deux expressions numériques dans deux paires d’accolades.

Exemples

  ` Adresser un élément d'un tableau interprocess à deux dimensions
 Si(<>asMotsClés{$vlLigneSuivante}{1}="Stop")
    <>atSujets{10}{$vlElem}:=[Topics]Sujet
    $viValeurSuivante:=<>aiGrosTableau{$vlSet}{Taille tableau(<>aiGrosTableau{$vlSet})}
 
  ` Adresser un élément d'un tableau process à deux dimensions
    Si(asMotsClés{$vlLigneSuivante}{1}="Stop")
       atSujets{10}{$vlElem}:=[Topics]Sujet
       $viValeurSuivante:=aiGrosTableau{$vlSet}{Taille tableau(aiGrosTableau{$vlSet})}
 
  ` Adresser un élément d'un tableau interprocess à deux dimensions
       Si($asMotsClés{$vlLigneSuivante}{1}="Stop")
          $atSujets{10}{$vlElem}:=[Topics]Sujet
          $viValeurSuivante:=$aiGrosTableau{$vlSet}{Taille tableau($aiGrosTableau{$vlSet})}

Lorsque la notation objet est activée (cf. section Notation objet), vous désignez un attribut d'objet (aussi appelé propriété d'objet) en saisissant son nom précédé d'un point (.) à la suite du nom de l'objet (ou de l'attribut) qui le contient. Un nom d'attribut peut contenir jusqu'à 255 caractères et est sensible à la casse.

Exemples :

 monObjet.monAttribut:="10"
 $valeur:=$clientObj.data.address.city

Note : Des règles supplémentaires s'appliquent aux noms des attributs d'objets (ils doivent être conformes à la spécification ECMA Script). Pour plus d'informations, reportez-vous à la section Utiliser la notation objet (préversion).

Vous désignez un formulaire en utilisant une expression de type chaîne alphanumérique qui représente son nom. Le nom d’un formulaire peut contenir jusqu’à 31 caractères.

Exemples

 FORM FIXER ENTREE([Personnes];"Entrée")
 FORM FIXER SORTIE([Personnes];"Sortie")
 DIALOGUE([Stock];"Boîte de note"+Chaine($vlStage))

Vous désignez un objet de formulaire en passant son nom sous forme de chaîne, précédée du paramètre *. Un nom d'objet peut contenir jusqu'à 255 octets.

Exemple :

 OBJET FIXER POLICE(*;"Binfo";"Times")

Voir aussi la section Objets de formulaires.

Note : Ne confondez pas les objets de formulaire (boutons, list box, variables saisissables...) et les objets du langage 4D. Les objets du langage de 4D sont créés et manipulés via la notation objet ou des commandes dédiées (cf. Objets (Langage)).

Vous désignez une méthode (procédure ou fonction utilisateur) en saisissant son nom. Ce nom peut contenir jusqu’à 31 caractères.

Note : Une méthode qui ne retourne pas de résultat est appelée une procédure. Une méthode qui retourne un résultat est appelée une fonction utilisateur.

Exemples

 Si(Nouveau client)
    EFFACER VALEURS DUPLIQUEES
    APPLIQUER A SELECTION([Employés];AUGMENTER SALARIES)

Conseil : Nous vous recommandons d'adopter, pour nommer vos méthodes, la même convention que celle utilisée dans le langage de 4D : écrivez les noms de vos procédures en caractères majuscules, et vos fonctions en minuscules avec la première lettre en majuscule. Ainsi, lorsque vous réouvrirez une base au bout de plusieurs mois, vous identifierez immédiatement si une méthode retourne ou non un résultat, en regardant son nom dans la fenêtre de l'Explorateur.

Note : Lorsque vous souhaitez appeler une méthode, vous saisissez simplement son nom. Toutefois, certaines commandes intégrées telles que APPELER SUR EVENEMENT, ainsi que les commandes des plug-ins, nécessitent que vous passiez le nom d'une méthode en tant que chaîne lorsqu'un paramètre de type méthode est requis (cf. exemples ci-dessous).

Exemples

  ` Cette commande attend une méthode (fonction) ou une formule
 CHERCHER PAR FORMULE([aTable];Recherche Spéciale)
  ` Cette commande attend une méthode (procédure) ou une formule
 APPLIQUER A SELECTION([Employés];AUGMENTER SALARIES)
  ` Mais cette commande attend un nom de méthode
 APPELER SUR EVENEMENT("GERER EVENEMENTS")

Les méthodes peuvent accepter des paramètres (ou arguments). Le paramètres sont passés à la méthode entre parenthèses, à la suite du nom de la méthode. Les paramètres sont séparés par des points virgule (;). Les paramètres sont passés à la méthode appelée en tant que variables locales numérotées séquentiellement : $1, $2,…, $n. De plus, plusieurs paramètres consécutifs (s'ils sont les derniers) peuvent être adressés à l'aide de la syntaxe ${n}où n, expression numérique, est le numéro du paramètre.
A l’intérieur d'une fonction, la variable locale $0 contient la valeur à retourner.

Exemples

  ` Dans ELIMINER ESPACES, $1 est pointeur sur le champ [Personnes]Nom
 ELIMINER ESPACES(->[Personnes]Nom)
 
  ` Dans Créateur tableau :
  ` - $1 est un numérique qui vaut 1
  ` - $2 est un numérique qui vaut 5
  ` - $3 est un texte ou un alpha qui vaut "Super"
  ` - La valeur résultante est assignée à $0
 $vsRésultat:=Créateur tableau(1;5;"Super")
 
  ` Dans Poubelle :
  ` - Les trois paramètres sont de type Texte ou Alpha
  ` - Vous pouvez y accéder par $1, $2 ou $3
  ` - Vous pouvez y accéder en écrivant, par exemple, ${$vlParam} où $vlParam vaut 1, 2 ou 3
  ` - La valeur résultante est assignée à $0
 vtClone:=Poubelle("est";"le";"il")

Vous désignez une commande de plug-in en écrivant son nom tel qu'il est défini dans le plug-in. Le nom d'une commande de plug-in peut contenir jusqu'à 31 caractères.

Exemple

 $erreur:=SMTP_From($smtp_id;"henry@gmail.com")

Dans 4D, il existe deux types d'ensembles qui se distinguent par leur portée :

  • Ensembles interprocess,
  • Ensembles process.

On peut également distinguer un troisième type d'ensemble, spécifique à 4D Server:

  • Ensembles clients.

Ensembles interprocess
Un ensemble est déclaré interprocess lorsque son nom, qui est une expression de type chaîne alphanumérique, est précédé du symbole (<>), formé des caractères “inférieur à” suivi de “supérieur à”.

Note : Cette syntaxe peut être utilisée sous Windows et Mac OS. De plus, sous Mac OS, vous pouvez également utiliser le caractère "diamant" (Option + v sur un clavier français).

Le nom d’un ensemble interprocess peut comporter jusqu’à 255 caractères, symbole <> non compris.

Ensembles process
Vous déclarez un ensemble process en passant simplement une expression de type chaîne qui représente son nom (et qui ne doit pas débuter par les symboles <> ou $). Le nom d’un ensemble process peut comporter jusqu’à 255 caractères.

Ensembles client
Le nom d'un ensemble client doit être précédé du symbole dollar ($). Ce nom peut comporter jusqu'à 255 caractères, symbole dollar non compris.

Note : Les ensembles sont gérés par le serveur. Dans certains cas, pour des raisons particulières ou d'optimisation, vous pourrez avoir besoin d'utiliser des ensembles localement, sur les postes clients. Pour cela, il vous suffit de créer des ensembles client.

Exemples

  ` Ensembles interprocess
 UTILISER ENSEMBLE("<>Enregistrements supprimés")
 NOMMER ENSEMBLE([Clients];"<>Commandes clients")
 Si(Enregistrements dans ensemble("<>Sélection"+Chaine($i))>0)
  ` Ensembles process
    UTILISER ENSEMBLE("Enregistrements supprimés")
    NOMMER ENSEMBLE([Clients];"Commandes clients")
    Si(Enregistrements dans ensemble("Sélection"+Chaine($i))>0)
  ` Ensembles client
       UTILISER ENSEMBLE("$Enregistrements supprimés")
       NOMMER ENSEMBLE([Clients];"$Commandes clients")
       Si(Enregistrements dans ensemble("$Sélection"+Chaine($i))>0)

Dans 4D, il existe deux types de sélections temporaires, qui se distinguent par leur portée :

  • Sélections temporaires interprocess,
  • Sélections temporaires process.

Sélections temporaires interprocess
Vous désignez une sélection temporaire interprocess en utilisant une expression de type chaîne débutant par le symbole (<>), formé des caractères “inférieur à” suivi de “supérieur à”.

Note : Cette syntaxe peut être utilisée sous Windows et Mac OS. De plus, sous Mac OS, vous pouvez également utiliser le caractère "diamant" (Option + v sur un clavier français).

Le nom d'une sélection temporaire interprocess peut contenir jusqu’à 255 caractères, symbole <> non compris.

Sélections temporaires process
Vous déclarez une sélection temporaire process en passant simplement une expression de type chaîne qui représente son nom (et qui ne doit pas débuter par les symboles <> ou $). Le nom d’une sélection temporaire process peut comporter jusqu’à 255 caractères.

Exemples

  ` Sélection temporaire interprocess
 UTILISER SELECTION([Clients];"<>ParCodePostal")
  ` Sélection temporaire process
 UTILISER SELECTION([Clients];"ParCodePostal")

Process  

En mode mono-utilisateur, ou sur le poste client en mode client/serveur, il existe deux types de process :

  • Process globaux,
  • Process locaux.

Process globaux
Vous déclarez un process global en passant une expression de type chaîne de caractères qui représente son nom (qui ne doit pas commencer par le symbole $). Le nom d’un process peut comporter jusqu’à 255 caractères.

Process locaux
Vous déclarez un process local lorsque son nom est précédé du symbole dollar ($). Le nom d’un process peut comporter jusqu’à 255 caractères, symbole dollar non compris.

Exemple

  ` Lancer le process global "Ajouter Clients"
 $vlProcessID:=Nouveau process("P_AJOUT_CLIENTS";48*1024;"Ajouter Clients")
  ` Lancer le process local "$Suivre Souris"
 $vlProcessID:=Nouveau process("P_SUIVRE_SOURIS";16*1024;"$Suivre Souris")

Le tableau suivant résume les principes de nommage des identifiants dans les méthodes.

IdentifiantLongueur max.Exemple
Table31[Factures]
Champ31[Employés]Nom
Variable/Tableau interprocess<> + 255(*)<>vlProcessSuivantID
Variable/Tableau process255(*)vsNomCourant
Variable/Tableau local(e)$ + 255(*)$vlCompteurLocal
Attributs d'objets255$o.monAttribut
Formulaire31"Formulaire Web perso"
Objet de formulaire255"MonBouton"
Méthode 31M_AJOUTER_CLIENTS
Commande de plug-in31WR INSERER TEXTE
Ensemble interprocess<> + 255"<>Enregistrements à archiver"
Ensemble process255"Enregistrements actuels"
Ensemble client$ + 255"$Sujets précédents"
Sélection temporaire255"Employés de A à Z"
Sélection temporaire interprocess<> + 255"<>Employés de Z à A"
Process local$ + 255"$SuivreEvénements"
Process global255"P_MODULE_FACTURES"
Sémaphore255"monsémaphore"

(*)31 si l'option de compatibilité "Enregistrer les méthodes en Unicode" est désélectionnée (cf. section Page Compatibilité).

Note : En cas d'utilisation de caractères non romans dans les noms des identifiants, leur taille maximum peut être inférieure.

Veillez à utiliser des noms uniques pour les différents éléments de votre base. Si un identifiant d’un certain type a le même nom qu’un autre identifiant d’un autre type (par exemple, si un champ est baptisé Personnes et qu’une variable est également nommée Personnes), 4D utilise un système de priorité.

4D identifie les noms utilisés dans les méthodes en fonction de l’ordre de priorité suivant :

1. Champs
2. Commandes
3. Méthodes
4. Routines de plug-ins
5. Constantes prédéfinies
6. Variables

Par exemple, 4D dispose d’une fonction interne appelée Date. Si vous appelez Date une de vos méthodes, 4D considérera “Date” comme étant la fonction interne et non votre méthode. Vous ne pourrez pas appeler votre méthode. En revanche, si vous nommez un champ “Date”, 4D considérera que vous souhaitez appeler votre champ et non la fonction intégrée.



Voir aussi  

Constantes
Méthodes
Opérateurs
Pointeurs
Présentation des tableaux
Types de données
Variables

 
PROPRIÉTÉS 

Produit : 4D
Thème : Présentation du langage
Nom intl. : Identifiers

 
HISTORIQUE 

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)