Hint Directives/fr

From Free Pascal wiki

English (en) suomi (fi) français (fr)

Utilisation des directives de conseil

Chaque fois qu'un identificateur marqué par une directive de conseil est rencontré par le compilateur, un avertissement sera affiché, correspondant au conseil spécifié.

  • deprecated
    • L'usage de cet identificateur est déprécié, il faut en utiliser un autre à la place. Le mot-clé deprecated peut être suivi d'une constante chaîne contenant un message. Le compilateur affichera alors le message chaque fois que l'identificateur est rencontré.
  • experimental
    • L'usage de l'identificateur est expérimental : il est utilisé pour indiquer de nouvelles caractéristiques qui devraient être utilisées avec précaution.
  • platform
    • Indique un identificateur spécifique à une plate-forme : il peut ne pas être défini pour toutes les plates-formes.
  • unimplemented
    • Cela devrait être utilisé uniquement pour les procédures et fonctions. Elle signale qu'une caractéristique particulière n'est pas encore implémentée.

Soient les exemples suivants : The following are examples:

Const  
  AConst = 12 deprecated;  
 
var  
  p : integer platform;  
 
Function Something : Integer; experimental;  
 
begin  
  Something:=P+AConst;  
end;  
 
begin  
  Something;  
end.

Il en résulte les sorties suivantes :

testhd.pp(11,15) Warning: Symbol "p" is not portable  
testhd.pp(11,22) Warning: Symbol "AConst" is deprecated  
testhd.pp(15,3) Warning: Symbol "Something" is experimental

Les directives de conseil peuvent suivre toutes sortes d'identificateurs : unités, constantes, types, variables, fonctions, procédures et méthodes.