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.

From the Free Pascal wiki, page "Hint Directives/fr", as it stood on 2020-02-17 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's Licensing page. If you have concerns about this material, message the admin.