Différences
Ci-dessous, les différences entre deux révisions de la page.
| Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
|
prog:lazarus:compilateur:directives:directives [01/05/2020 21:56] thierry [{$M+} / {$TYPEINFO ON}] |
prog:lazarus:compilateur:directives:directives [10/04/2023 16:13] (Version actuelle) thierry [{$MODESWITCH}] |
||
|---|---|---|---|
| Ligne 1: | Ligne 1: | ||
| ====== Directives de compilation ====== | ====== Directives de compilation ====== | ||
| Toutes les directives -> [[https://www.freepascal.org/docs-html/prog/progse2.html]] | Toutes les directives -> [[https://www.freepascal.org/docs-html/prog/progse2.html]] | ||
| + | ===== {$APPTYPE} ===== | ||
| + | |||
| + | |||
| + | Il est possible de déterminer le type d'application d'une application Windows ou Amiga au moment de l'exécution. La constante IsConsole, déclarée dans les unités système Win32 et Amiga en tant que | ||
| + | <code delphi> | ||
| + | Const | ||
| + | IsConsole : boolean ; | ||
| + | // contient True si l'application est une application console, | ||
| + | // False si l'application est une application GUI. | ||
| + | |||
| + | </code> | ||
| + | |||
| + | |||
| + | La directive {$APPTYPE XXX} accepte un argument qui spécifie le type d'application compilée. Il peut prendre les valeurs suivantes : | ||
| + | |||
| + | |||
| + | ==== CONSOLE ==== | ||
| + | Une application console. Un terminal sera créé et les descripteurs de fichiers d'entrée, de sortie et d'erreur standard seront initialisés. Sous Windows, une fenêtre de terminal sera créée. Il s'agit de la valeur par défaut. | ||
| + | |||
| + | Les applications linux sont toujours des applications de console. L'application elle-même peut décider de fermer les fichiers standard. | ||
| + | ==== FS ==== | ||
| + | Spécifie une application VIO plein écran sur os/2. Ces applications utilisent une API spéciale de type BIOS pour programmer l'écran. os/2 démarre ces applications toujours en plein écran. | ||
| + | |||
| + | ==== GUI ==== | ||
| + | En spécifiant la directive ''{$APPTYPE GUI}'', l'application sera considérée comme une application graphique ; aucune fenêtre de console ne sera ouverte lors de l'exécution de l'application. Aucun descripteur de fichier standard ne sera initialisé, leur utilisation (avec par exemple des instructions writeln) produira une erreur d'exécution. Si l'application est lancée à partir de la ligne de commande, l'invite de commande sera renvoyée immédiatement après le démarrage de l'application. | ||
| + | |||
| + | Sous os/2 et Mac OS, le type d'application GUI crée une application GUI, comme sous Windows. Sur os/2, il s'agit d'une véritable application Presentation Manager. | ||
| + | |||
| + | Il convient d'être prudent lors de la compilation d'applications GUI ; les fichiers Input et Output ne sont pas disponibles dans une application GUI, et toute tentative de lecture ou d'écriture dans ces fichiers entraînera une erreur d'exécution. | ||
| + | |||
| + | |||
| + | ==== TOOL ==== | ||
| + | |||
| + | Il s'agit d'une directive spéciale pour Mac OS. Elle indique au compilateur de créer une application outil : Elle initialise les fichiers Input, Output et StdErr, elle peut prendre des paramètres et renvoyer un code de résultat. Elle est implémentée comme un outil MPW qui ne peut être exécuté que par MPW ou ToolServer. | ||
| + | |||
| + | ===== {$H} / {$LONGSTRINGS} ===== | ||
| + | ''{$H+}'' -> String = AnsiString\\ | ||
| + | ''{$H-}'' -> String = ShortString | ||
| + | |||
| + | Si ''{$LONGSTRINGS ON}'' est spécifié, le mot-clé String (sans spécification de longueur) sera traité comme ''AnsiString''. | ||
| + | |||
| + | Ce commutateur correspond à l'option de ligne de commande ''-Sh''. | ||
| + | |||
| + | Par défaut, l'utilisation des ansistrings est désactivée, ce qui correspond à ''{$H-}''. | ||
| + | |||
| + | L'unité du système est compilée sans ansistrings, toutes ses fonctions acceptent des arguments à courte chaîne. Il en va de même pour toutes les unités RTL, sauf l'unité sysutils, qui est compilée avec ansistrings. | ||
| + | |||
| + | Cependant, l'instruction ''{$MODE}'' influence la valeur par défaut de ''{$H}'' :\\ | ||
| + | une directive ''{$MODE DELPHI}'' implique une instruction ''{$H+}'',\\ | ||
| + | tous les autres modes la désactivent.\\ | ||
| + | Par conséquent, vous devez toujours mettre ''{$H+}'' après une directive mode. | ||
| ===== {$i} / {$INCLUDE} ===== | ===== {$i} / {$INCLUDE} ===== | ||
| La directive ''{$I filename}'' ou ''{$INCLUDE filename}'' indique au compilateur d'inclure les fichier //filename//. Les instructions lues à cet endroit seront insérées comme si elles se trouvaient dans le fichier actuel. | La directive ''{$I filename}'' ou ''{$INCLUDE filename}'' indique au compilateur d'inclure les fichier //filename//. Les instructions lues à cet endroit seront insérées comme si elles se trouvaient dans le fichier actuel. | ||
| Ligne 35: | Ligne 86: | ||
| Source : [[https://www.freepascal.org/docs-html/prog/progsu40.html]] | Source : [[https://www.freepascal.org/docs-html/prog/progsu40.html]] | ||
| + | ===== {$IFDEF} {$ELSE} {$ENDIF} ===== | ||
| + | Voir -> [[https://wiki.lazarus.freepascal.org/Conditional_compilation]] | ||
| + | |||
| + | ==== Exemple d'utilisation dans un Projet ==== | ||
| + | Avec le code | ||
| + | <code delphi> | ||
| + | uses ... | ||
| + | {$IFDEF DEBUG_WS}LazLogger,{$ENDIF} | ||
| + | ... | ||
| + | </code> | ||
| + | |||
| + | On ajoute dans les Options du Projet la directive ''-dDEBUG_WS'' pour definir la directive ''DEBUG_WS'' dans tout le projet | ||
| + | {{:prog:lazarus:compilateur:directives:option_projet.png?direct|}} | ||
| + | |||
| + | |||
| ===== {$M+} / {$TYPEINFO ON} ===== | ===== {$M+} / {$TYPEINFO ON} ===== | ||
| Ligne 63: | Ligne 129: | ||
| Source:[[https://www.freepascal.org/docs-html/prog/progsu47.html]] | Source:[[https://www.freepascal.org/docs-html/prog/progsu47.html]] | ||
| + | |||
| + | ===== {$MODE} ===== | ||
| + | The {$MODE} sets the compatibility mode of the compiler. This is equivalent to setting one of the command line options -So, -Sd, -Sp or -S2. it has the following arguments: | ||
| + | |||
| + | * **Default**\\ Default mode. This reverts back to the mode that was set on the command line. | ||
| + | * **Delphi**\\ Delphi compatibility mode. All object-pascal extensions are enabled. This is the same as the command line option -Sd. Note that this also implies {$H ON} (i.e., in Delphi mode, ansistrings are the default). | ||
| + | * **DelphiUnicode**\\ Delphi compatibility mode. All object-pascal extensions are enabled, and additionally the String keyword refers to a unicode string. | ||
| + | * **ExtendedPascal**\\ Extended pascal mode. Only available in 3.2 and higher. | ||
| + | * **TP**\\ Turbo pascal compatibility mode. Object pascal extensions are disabled, except ansistrings, which remain valid. This is the same as the command line option -So. | ||
| + | * **FPC**\\ FPC mode. This is the default, if no command line switch is supplied. | ||
| + | * **OBJFPC**\\ Object pascal mode. This is the same as the -S2 command line option. | ||
| + | * **MACPAS**\\ MACPAS mode. In this mode, the compiler tries to be more compatible to commonly used pascal dialects on the Mac OS, such as Think Pascal, Metrowerks Pascal, MPW Pascal. | ||
| + | * **ISO**\\ Standard Pascal, ISO 7185 mode. In this mode, the compiler complies with the requirements of level 0 and level 1 of ISO/IEC 7185. | ||
| + | ===== {$MODESWITCH} ===== | ||
| + | Voir la page consacrée : [[prog:lazarus:compilateur:directives:modesswitch]] | ||
| + | ====== Sources & Resources ====== | ||
| + | * [[https://www.freepascal.org/docs-html/prog/progch1.html]] | ||
| + | |||
| + | |||