Quelltext der Seite Compiler-Anweisung

{{Belege fehlen}}
Eine '''Compiler-Anweisung''' ({{enS|compiler directive}} oder ''pragma'') ist eine in den [[Quelltext]] eingefügte Steueranweisung für den [[Compiler]]. Der Umfang und die [[Syntax]] von Compiler-Anweisungen sind von der [[Programmiersprache]] und teilweise auch vom gewählten Compiler abhängig.

== Beispiele ==

In der Programmiersprache [[Algol 68|Algol&nbsp;68]] werden Compiler-Direktiven zwischen <code>'''pr'''</code> und <code>'''pr'''</code> oder zwischen <code>'''pragmat'''</code> und <code>'''pragmat'''</code> eingeschlossen.<ref>{{Webarchiv | url=http://burks.brighton.ac.uk/burks/language/other/a68rr/rr9.htm#92 | wayback=20071017051614 | text=''Revised Report on the Algorithmic Language ALGOL 68''.}}</ref> Dies ist der Ursprung des Begriffs ''Pragmat''.

[[C (Programmiersprache)|C]]-Compiler verwenden einen [[C-Präprozessor]], der Compiler-Direktiven interpretiert.<ref>{{Internetquelle |url=https://gcc.gnu.org/onlinedocs/cpp/Pragmas.html |titel=Pragmas (The C Preprocessor) |abruf=2025-02-26}}</ref> Beispielsweise weist <syntaxhighlight lang="c"  style="white-space: nowrap" inline>#include <foo.h></syntaxhighlight> den Präprozessor an, den Inhalt der Datei ''foo.h'' an dieser Stelle im Quelltext einzufügen.<ref>{{Literatur |Autor=Jörg Wiegelmann |Titel=Softwareentwicklung in C für Mikroprozessoren und Mikrocontroller: C-Programmierung für Embedded-Systeme |Auflage=7., neu bearbeitete und erweiterte Auflage |Verlag=VDE Verlag GmbH |Ort=Berlin Offenbach |Datum=2017 |ISBN=978-3-8007-4328-5 |Seiten=19 Abs. 3.2.7 Präprozessor}}</ref> Mit der Anweisung <syntaxhighlight lang="c"  style="white-space: nowrap" inline>#pragma eigenschaft</syntaxhighlight> wird eine Eigenschaft dem Compiler angezeigt. Ein Beispiel für eine Eigenschaft ist die Annotation eines parallelisierbaren Code-Blocks, falls der C-Compiler den [[OpenMP]]-Standard unterstützt:
<syntaxhighlight lang="c">
#pragma omp parallel for reduction(+:c)
 for (int i = 0; i < length; ++i)
     c += a[i]*b[i];
</syntaxhighlight>

In der Programmiersprache [[Pascal (Programmiersprache)|Pascal]] werden Compiler-Direktiven als spezielle Kommentare definiert. Kommentare, deren erstes Zeichen ein <code>$</code> ist, werden als Direktive interpretiert. Beispielsweise schaltet <code>{$Q+}</code> die [[Codegenerator|Codegenerierung]] von Indexüberprüfungen von Arrayzugriffen ein.

In der Programmiersprache [[Ada (Programmiersprache)|Ada]] werden Compiler-Direktiven durch das [[Schlüsselwort (Programmierung)|Schlüsselwort]] <code>pragma</code> eingeleitet. So wird z.&nbsp;B. mit <code>'''pragma''' OPTIMIZE(TIME);</code> die [[Programmoptimierung]] gesteuert.

Der [[Haskell (Programmiersprache)|Haskell]]-Compiler [[Glasgow Haskell Compiler|GHC]] unterstützt das Setzen von Kommandozeilen-Optionen auch in der Quelltextdatei über Compiler-Direktiven. Ein Beispiel ist die Aktivierung von ghc-Haskell-Spracherweiterungen, die mit der Direktive <code style="white-space: nowrap">{-# OPTIONS_GHC -fglasgow-exts #-}</code> angefordert wird.

In der [[SAP]]-Programmiersprache [[ABAP]] werden Pragmas verwendet, um Warnungen verschiedener Prüfwerkzeuge auszublenden.<ref>{{Internetquelle |url=https://help.sap.com/doc/abapdocu_751_index_htm/7.51/de-DE/abenpragma.htm |titel=Pragmas - ABAP-Schlüsselwortdokumentation |abruf=2025-05-08}}</ref> Der Programmierer erklärt damit, dass er die betreffende Syntax bewusst verwendet und den konkreten Einsatz auf Unbedenklichkeit geprüft hat. So können etwa performance-kritische Anweisungen hingenommen werden, wenn im konkreten Einsatzzweck keine langen Laufzeiten zu erwarten sind oder aber bewusst toleriert werden können.

== Einzelnachweise ==
<references />

[[Kategorie:Programmierung]]