コンパイラー・オプションの説明および一般的な規則

このセクションでは、現在のすべての Linux*、Mac OS* X、Windows* コンパイラー・オプションについて、アルファベット順に説明します。

オプションの説明

各オプションの説明には、次の情報が含まれています。

• オプションの簡単な説明
• IDE オプション

  Windows、Linux、Mac OS X システムにおける統合開発環境 (IDE) のプロパティー・ページに関連する情報を提供します。オプションが表示されるプロパティー・ページ、およびオプションのカテゴリーを紹介します。Windows の IDE は Microsoft* Visual Studio* .NET、Linux の IDE は Eclipse*、Mac OS X の IDE は Xcode* です。そのオプションに相当する IDE オプションがない場合は「なし」と記述されます。

• アーキテクチャー

  オプションを使用できるアーキテクチャーを示します。アーキテクチャーの種類は以下のとおりです。

  • IA-32 アーキテクチャー
  • インテル(R) 64 アーキテクチャー
  • IA-64 アーキテクチャー
• 構文

  Linux および Mac OS X システムで使用される構文と Windows システムで使用される構文を説明します。使用できる構文がない (オプションが有効ではない) システムでは、「なし」と記述されます。

• 引数

  オプションに対する引数 (パラメーター) を説明します。オプションに引数がない場合には、「なし」と記述されます。

• デフォルト

  オプションのデフォルト設定です。

• 説明

  オプションの詳細な説明です。該当する引数がある場合にはその説明も含まれます。

• 代替オプション

  このオプションは、説明されているオプションと同義のオプションです。代替オプションがない場合は、「なし」と記述されます。
  多くのコマンドライン・オプションでは、オプション名でハイフン ("-") の代わりに、古い記述方法の下線 ("_") を使用しています。この古い記述方法は有効です。

オプションの説明には次の項目が含まれるものもあります。

• 例

  オプションを含む簡単なサンプルです。

• 関連情報

  説明されているオプションや関連するオプションについての詳細を得られるリソースを紹介します。

コンパイラー・オプションの一般的な規則

複数のオプションを 1 つのダッシュ (Linux および Mac OS X) またはスラッシュ (Windows) だけで指定することはできません。次に例を示します。

• Linux および Mac OS X システム: -wc (誤)、-w -c (正)
• Windows システム: /wc (誤)、/w /c (正)

一部のコンパイラー・オプションでは、大文字と小文字が区別されます。例えば、-c (または /c) と -C (または /C) は 2 つの異なるオプションです。

すべてのコンパイラー・オプションは、大文字と小文字を区別します。 一部のオプションは、大文字と小文字では意味が異なります。例えば、"c" オプションはリンクを抑止しますが、"C" オプションは前処理済みのソース出力の中にコメントを書き込みます。

コマンドラインで指定されたオプションは、すべてのファイルに適用されます。

オプションの引数は、ファイル名、文字列、文字、または数字です。文字列に空白が含まれている場合、文字列を二重引用符 (") で囲む必要があります。次に例を示します。

• Linux および Mac OS X システムでは、-dynamic-linkermylink (ファイル名) または -Umacro3 (文字列) です。
• Windows システムでは、 /Famyfile.s (ファイル名) または /V"version 5.0" (文字列) です。

コンパイラー・オプションは任意の順番で指定できます。

Windows システムでは、すべてのコンパイラー・オプションはコマンドラインで /link オプションの前に指定しなければなりません (該当する場合)。

特定のオプションを指定しなければ、コマンドラインは指定されたファイルに対してコンパイルとリンクの両方を行います。

オプションを一意に識別できるだけの文字数を入力すれば、いくつかのオプション名は短縮可能です。

一部のオプションは、オプション名の後に 1 つ以上のキーワード引数を受け付けます。例えば、arch オプションは複数のキーワードを受け付けます。

通常、複数のキーワードを指定するには、そのオプションを複数回指定します。ただし、例外もあります。次のオプションは有効です: -axNB (Linux) または /QaxNB (Windows)

注

コンパイラー・オプションは、#pragma を使用して無効にしない限り、コンパイル全体で効果があります。

オプションを無効にするには、オプションの否定形を指定します。

Windows システムでは、コマンドラインの最後に /Od を指定すると、1 つまたは複数のオプションを無効にすることができます。

注

Windows システムでは、/Od オプションは /Od、/O1、/O2、/O3、および /Ox を含む相互排他的なオプショングループの一部です。同じオプショングループのオプションを 2 つ以上指定した場合、コマンドラインで最後に指定したオプションが、その前に指定したオプションよりも優先されます。

コマンドライン上に、オプションを有効にするバージョンと無効にするバージョンの両方がある場合、最後に指定したバージョンが優先されます。

コンパイラー・オプションのリストと機能別グループ

すべてのコンパイラー・オプションのリストを表示するには、コマンドラインで help オプションを指定します。

コンパイラー・オプションの機能別グループを表示するには、help オプションで機能カテゴリーを指定します。例えば、コンパイラーで表示される診断メッセージに影響を与えるオプションのリストを表示するには、次のいずれかのコマンドを入力します。

-help diagnostics     !Linux および Mac OS X システム
/help diagnostics     !Windows システム

指定することができるカテゴリーについては、help を参照してください。