指示（プログラミング）

コンピュータプログラミングにおいて、ディレクティブまたはプラグマ（「実用的な」に由来）とは、コンパイラ（またはその他の翻訳器）が入力をどのように処理するかを指定する言語構成要素です。プログラミング言語によっては、ディレクティブが言語の文法の一部である場合とそうでない場合があり、コンパイラごとに異なる場合があります。ディレクティブは、プリプロセッサによって処理されてコンパイラの動作を指定することも、インバンドパラメータ化の一形態として機能することもできます。

ディレクティブは、グローバルな動作を指定する場合もあれば、プログラミングコードのブロックなど、ローカルなセクションのみに影響を与える場合もあります。C言語プログラムなど、ディレクティブがオプションのコンパイラヒントであり、無視できる場合もありますが、通常は指示的なものであり、従わなければなりません。ただし、ディレクティブは言語自体に何らかの動作を実行するのではなく、コンパイラの動作を変更するだけです。

この用語は、開発環境に存在する既存のコンパイラ、アセンブラ、および言語構造を拡張する追加の実行可能処理をもたらす、コードに埋め込まれた独自のサードパーティタグおよびコマンド（またはマークアップ）を指すために使用されることがあります。「ディレクティブ」という用語は、「コマンド」という用語と同様に、さまざまな方法で使用されます。

CおよびC++では、シンプルなマクロプリプロセッサが言語でサポートされています。プリプロセッサによって処理されるべきソース行（例: や#define）は、プリプロセッサディレクティブ#includeと呼ばれます。

C言語のプリプロセッサディレクティブに似た構文構造、例えばC#の`<script>`など#ifも、通常は「ディレクティブ」と呼ばれますが、これらの場合、実際の前処理フェーズは含まれない場合があります。

条件ディレクティブの後に続く場合を除きdefined、すべてのプリプロセッサコマンドはハッシュ記号（#）で始まります。C ++26までは、キーワードexport、importおよびはmoduleプリプロセッサによって部分的に処理されていました。^{[ 1 ]}

指令はJOVIALに遡る。^{[ 2 ]}

COBOLにはCOPYディレクティブがあります。

ALGOL 68では 、ディレクティブはプラグマット(「pragmatic」から)と呼ばれ、pragmatまたはprと表記されます。C などの新しい言語では、これは「pragma」（「t」なし）と略されます。

ALGOL 68 におけるプラグマトの一般的な用途は、ストロッピングレジーム、つまり「キーワードの表示方法」を指定することです。以下に、POINT、UPPER、RES (予約語)、または引用符レジ​​ームを指定するさまざまなディレクティブを示します。POINTレジームまたは引用符レジ​​ームのいずれにおいても、プラグマトキーワード自体 ( prと略記) にストロッピングが使用されている点に注意してください。

。PRポイント.PR . PRアッパー.PR 。PR RES.PR​ 「pr」引用「pr」 

現在、ディレクティブは1970年代初頭に登場し、現在のC99規格にも引き継がれているC言語で最もよく知られています。C言語では、ディレクティブはCプリプロセッサへの命令、またはコンパイラ自体へのディレクティブとして使用され#pragmaます。また、より現代的な言語でもある程度使用されています（下記参照）。

• Adaでは、コンパイラディレクティブはプラグマ（「実用的な情報」の略）と呼ばれます。
• Common Lispでは、ディレクティブは宣言と呼ばれ、declare構文 (またはproclaim)を使用して指定されますdeclaim。^{[ 3 ]} 1 つの例外を除いて、宣言はオプションであり、プログラムのセマンティクスには影響しません。唯一の例外は でありspecial、これは適切な場所で指定する必要があります。
• Turbo Pascalでは、ディレクティブは「重要なコメント」と呼ばれます。これは、言語文法においてコメントと同じ構文に従うためです。Turbo Pascal では、重要なコメントとは、最初の文字がドル記号で、2 番目の文字が文字であるコメントのことです。たとえば、C の#include "file"ディレクティブに相当するのは、重要なコメントです{$I "file"}。
• Perlでは、モジュールをインポートするキーワード" " は、やなどuseのディレクティブを指定するためにも使用できます。use strict;use utf8;
• Haskell のプラグマは、特殊なコメント構文を使用して指定されます{-# INLINE foo #-}。例: ^{[ 4 ]}また、Haskell では、C プリプロセッサを使用することもできます{-# LANGUAGE CPP #-}。
• PHP はディレクティブを使用しますdeclare(strict_types=1)。
• PL /Iでは、ディレクティブはパーセント記号 ( ) で始まり、セミコロン( %) で終わります。;例: 、%INCLUDE foo;%NOPRINT;%PAGE;%POP;%SKIP;
• Pythonには2つのディレクティブがあります。1つは言語機能を変更するディレクティブ（ PEP 236 -- Back to the __future__from __future__ import featureで定義）で、Perlと同様に既存のモジュールインポート構文を使用します。もう1つはソースコードファイルのエンコーディングを指定するディレクティブ（コメント内）（PEP 263 -- Defining Python Source Code Encodingsで定義）です。より一般的なディレクティブステートメントがPEP 244 -- The `directive' statementで提案されましたが、却下されました。これらはすべて2001年に遡ります。coding
• ECMAScriptもディレクティブの構文を採用していますが、プラグマは関数呼び出しではなく、文字列リテラル（例：、または）useとして宣言される点が異なります。"use strict";"use asm";
• Visual Basicでは、Optionディレクティブには キーワード " " が使用されます。
  • Option Explicit On|Off- 有効にすると、変数の初回使用時の暗黙的な宣言が禁止され、事前に明示的な宣言が必要になります。
  • Option Compare Binary- 文字列の比較結果は、文字の内部バイナリ表現から派生したソート順に基づきます。たとえば、英語/ヨーロッパ言語コードページ (ANSI 1252) の場合、A < B < E < Z < a < b < e < z < À < Ê < Ø < à < ê < ø となります。組み込み演算子 (例: =、<>、<、>)、Select Case ブロック、および VBランタイム ライブラリの文字列関数 (例: InStr) に影響します。
  • Option Compare Text- 文字列の比較結果は、システムのロケールによって決定される大文字小文字を区別しないテキストのソート順に基づきます。たとえば、英語/ヨーロッパ言語コードページ (ANSI 1252) の場合、(A=a) < (À = à) < (B=b) < (E=e) < (Ê = ê) < (Z=z) < (Ø = ø) となります。組み込み演算子 (例: =、<>、<、>)、Select Case ブロック、および VB ランタイム ライブラリの文字列関数 (例: InStr) に影響します。
  • Option Strict On|Off- 許可しない場合:
    • 型指定のないプログラミング - 明示的な型指定のない宣言は、暗黙的に Object 型として扱われる。
    • 静的に Object 型として定義された値に対する遅延バインディング (つまり、CLR、DLR、および COM オブジェクトへの動的ディスパッチ)。
    • 暗黙的な縮小変換 - より狭い型へのすべての変換 (たとえば、Long から Integer、Object から String、Control から TextBox へ) は、​​変換演算子 (たとえば、CInt、DirectCast、CType) を使用してコード内で明示的に行う必要があります。
  • Option Infer On|Off- 有効にすると、コンパイラは初期化子からローカル変数の型を推論できるようになります。
• Rubyでは、インタープリタ ディレクティブはプラグマと呼ばれ、表記に続くファイル先頭のコメントで指定されますkey: value。たとえば、 は、coding: UTF-8ファイルがUTF-8文字エンコーディングでエンコードされていることを示します。
• C#では、コンパイラ ディレクティブはプリプロセス ディレクティブと呼ばれます。C# は厳密にはプリプロセッサを使用してこれらを処理するのではなく、コード内で直接処理します。コンパイラ ディレクティブにはさまざまな種類があり、そのほとんどは C や C++ のものと類似しています。これには、#pragmaコンパイラの警告やデバッガのチェックサムを制御するために特に使用されるディレクティブが含まれます。<sup>[ 5 ] [ 6 ]</sup> C# には、C や C++ では使用されないディレクティブもいくつかあります。これには、#nullableやが含まれます#region。C# では関数のようなマクロは許可されていませんが、条件付きコンパイルなどの目的で通常のマクロは許可されています。
• SQLite DBMSには、 他のDBMSと互換性のないコマンドを導入するために使用されるPRAGMAディレクティブが含まれています。<sup>[ 7 ]</sup>
• Solidityでは、コンパイラディレクティブはプラグマと呼ばれ、`pragma`キーワードを使用して指定されます。^{[ 8 ]}

• #pragma once – ヘッダーファイルの重複インクルードをブロックするC/C++ディレクティブ 

• OpenMPウェブサイト
• OpenACCウェブサイト
• OpenHMPPウェブサイト