Skip to main content

Boîte de dialogue : Paramètres d'analyse statique : Conventions de dénomination

Une fonction: Dans la boîte de dialogue, vous définir les préfixes pour les types de données et les portées des variables, ainsi que les préfixes pour les POU et les types de données définis par l'utilisateur (DUT). Contrôles d'analyse statique conformité avec les conventions de nommage. Lorsqu'une convention n'est pas respectée, l'analyse statique signale un message d'erreur dans le messages voir. Pour plus d'informations, consultez : Configuration et exécution d'une analyse statique

Appeler:

  • Projet → Paramètres du projet menu, Analyse statique Catégorie, Ouvrir la boîte de dialogue de configuration lien

  • Construire → Analyse statique → Paramètres menu

Exigence:

  • le CODESYS Static Analysis le paquet est installé.

  • Un projet est ouvert.

Les messages d'erreur s'affichent au format suivant : sa_icon_message.png NC <prefix of convention number> : <message text>. NC signifie "convention de dénomination". Par exemple, le message d'erreur sa_icon_message.pngNC0102 : Nom invalide… signifie une violation de la convention de dénomination 102 pour les POU de type PROGRAM.

Astuce

Vous pouvez utiliser le 'naming' pragma pour désactiver les conventions de nommage pour les individus identifiants. Les identifiants peuvent commencer par n'importe quoi, pas nécessairement par le préfixe.

Filtre

Champ de saisie des chaînes à rechercher

Tableau avec les conventions de nommage

Noms

Nœuds et éléments pour lesquels un préfixe peut être défini.

Le nombre entre parenthèses après chaque élément (par exemple, PROGRAMME (102)) est le numéro de convention de préfixe signalé en cas de non-respect d'une convention de dénomination.

Préfixe

Champ de saisie du préfixe

  • Plusieurs préfixes peuvent être spécifiés au moyen d'une séparation par des virgules.

    Exemple:

    Préfixe pour les POU, PROGRAM (102): prog, PRG_

    Préfixe pour les POU, FUNCTION (103): fun, FUN_

  • Les expressions régulières (RegEx) sont également possibles pour les préfixes. Pour ce faire, un @ doit être préfixé.

    Exemple:

    Le nom doit commencer par x et peut contenir un caractère de la portée a-dA-D: @x[a-dA-D].

  • Pour les variables de type Alias et POU de type Propriété, le préfixe peut être défini avec l'espace réservé {datatype}.

Préfixes pour les variables

Nœud organisationnel pour toutes les variables pour lesquelles un préfixe peut être défini en fonction du type de données ou de la portée.

Préfixes pour les POU

Nœud organisationnel pour tous les types de POU et portées de méthode pour lesquels un préfixe peut être défini

Préfixes pour les DUT

Nœud organisationnel pour les types de données DUT (structure, énumération, alias ou union) pour lesquels un préfixe peut être défini

Préfixes pour les types personnalisés

Nœud organisationnel pour les types personnalisés spéciaux (en particulier ceux des bibliothèques)

Vous pouvez étendre la liste avec des conventions : Cliquez sur l'espace vide en dessous. Dans le Assistant de saisie boîte de dialogue, spécifiez le nom d'un type personnalisé ou sélectionnez un type personnalisé.

Pour supprimer une convention, sélectionnez-la et appuyez sur la Suppr clé.

Remarque : Ces conventions sont prioritaires sur les préfixes qui sont définis avec l'attribut {attribute 'nameprefix' := '<prefix>'}.

Choix

Le premier caractère après le préfixe doit être une lettre majuscule

standard icon: L'analyse statique signale une erreur pour une variable lorsque le premier caractère du nom de la variable après le préfixe défini n'est pas une lettre majuscule.

Combiner le préfixe de portée avec le préfixe de type de données

standard icon: comme espace de noms, une variable doit avoir le préfixe défini suivi du préfixe défini pour son type de données.

Exemple : Les préfixes suivants sont définis : g_ pour VAR_GLOBAL, et r pour le type de données RÉEL.

L'analyse du code signale des erreurs pour les variables REAL globales qui n'ont pas le préfixe g_r avoir.

_cds_icon_option_deactivated.png: Si des conventions pour l'espace de noms sont spécifiées pour une variable, ces conventions sont prises en compte. Par conséquent, toutes les conventions de type de données sont ignorées.

Exemple : Les préfixes suivants sont définis : g_ pour VAR_GLOBAL, et r pour le type de données RÉEL.

L'analyse du code ne signale que les erreurs globales REAL-Variables qui n'ont pas le préfixe g_ avoir.

Préfixes récursifs pour les types de données combinables

standard icon: Les variables de types de données combinés doivent avoir des préfixes composés qui suivent les conventions de dénomination définies.

Exemple:

ppiVariable : POINTER TO POINTER TO INT;

Le préfixe p a été défini pour les variables de type de données POINTER, et le préfixe I a été défini pour le type de données INT.

L'analyse de code statique signale des erreurs pour toutes les variables de type de données POINTER TO POINTER TO INT, pas le préfixe ppi avoir.

refaiVar : REFERENCE TO ARRAY[1..3] OF INT;

Le préfixe ref a été défini pour le type de données REFERENCE TO, le préfixe a pour un tableau, et le préfixe I pour le type de données INT.

L'analyse de code statique signale des erreurs pour toutes les variables de type de données REFERENCE TO ARRAY[1..3] OF INT, pas le préfixe refai avoir.

Exemple

La convention de nommage suivante correspond en grande partie aux recommandations décrites dans CODESYS pour les "identifiants".

_san_prefixes_for_variables_types.png
_san_prefixes_for_variables_scopes.png
_san_prefixes_for_pous_and_duts.png

Exemple

La convention de nommage (1) fait référence au POU standard TON. Par conséquent, les déclarations de la bibliothèque spéciale POU sont vérifiées pour le préfixe "ton_". Cliquez sur l'espace vide (2) pour insérer plus de conventions de nommage.

_san_img_prefixes_for_user_defined_types.png