C言語 コンパイラエラー C2002の原因と対策を解説

本記事では、C言語の開発環境で発生するコンパイラ エラー C2002について説明します。

エラーは主にワイド文字定数の使用方法に誤りがある場合に発生し、例えばリテラルにLを付け忘れるといったケースが原因です。

また、STDDEF.hのインクルード不足や文字列リテラルの不適切な連結にも注意が必要です。

コンパイラエラー C2002の発生要因

ワイド文字定数の使用方法に関する誤り

Lプレフィックスの指定漏れ

ワイド文字を表現する場合、文字リテラルの前に必ずLを指定する必要があります。

Lの指定が漏れると、ワイド文字定数として認識されず、コンパイラエラー C2002 が発生します。

下記のサンプルコードでは、Lを指定せずにワイド文字を定義しているためエラーとなる可能性があります。

#include <stdio.h>
#include <wchar.h>
int main(void) {
    // 誤った例: Lプレフィックスが指定されていない
    wchar_t wideChar = '漢';  // 正しくは L'漢'
    wprintf(L"%lc\n", wideChar);
    return 0;
}

// コンパイルエラー例: コンパイラエラー C2002 が発生

バイト数超過のケース

ワイド文字定数はプラットフォームによって許容されるバイト数が決まっています。

例えば、特定の文字列が意図せず多くのバイトを含む場合、エラーが発生することがあります。

コンパイラは、定義されたバイト数を超える定数を検知し、エラー C2002 を通知します。

使用する文字数や文字コードに十分注意する必要があります。

たとえば、下記の例では、不適切なバイト数を含む可能性がある場合について説明します。

なお、実際の使用環境によって異なるため、環境固有の制約を確認してください。

#include <stdio.h>
#include <wchar.h>
int main(void) {
    // 誤った例: 連続する多くの文字を含むワイド文字定数
    const wchar_t *message = L"長い文字列を連続して定義する場合、許容バイト数を超えてしまう可能性があります";
    wprintf(L"%ls\n", message);
    return 0;
}

// コンパイルエラー例: 該当するワイド文字定数がバイト数制限を超えた場合にエラー発生

通常文字列リテラルとの連結制約

ワイド文字定数と通常の文字列リテラルを連結すると、型が混在するため、エラーが発生します。

リテラル同士を連結する場合は、すべて同じ型(すなわちワイド文字リテラルまたは通常文字列リテラル)で記述する必要があります。

下記の例は、誤ってワイド文字と通常文字列を連結している例です。

#include <stdio.h>
#include <wchar.h>
int main(void) {
    // 誤った例: ワイド文字リテラルと通常文字列リテラルの連結
    wchar_t *message = L"Wide" "Normal";
    wprintf(L"%ls\n", message);
    return 0;
}

// コンパイルエラー例: 型の不一致によりエラーが発生

ヘッダーファイル未インクルードの影響

STDDEF.hの不足によるエラー

ワイド文字を扱う際、特定の標準ヘッダーが必要になる場合があります。

特に、STDDEF.hが含まれていないと、コンパイラは定義済みの型情報やマクロを認識できず、エラー C2002 を発生させる可能性があります。

必要なヘッダーを確実にインクルードして、正しい型や定数が使用できるようにしましょう。

#include <stdio.h>
#include <wchar.h>
#include <stddef.h>  // 必要なヘッダーを追加
int main(void) {
    const wchar_t *message = L"正しいヘッダーがインクルードされています";
    wprintf(L"%ls\n", message);
    return 0;
}

正しいヘッダーがインクルードされています

プリプロセッサディレクティブの制限

ASCII要件の影響

Microsoft C++などの一部のコンパイラでは、プリプロセッサディレクティブに渡すテキスト引数はASCII文字のみを許容しています。

たとえば、#pragma messageディレクティブで、L"文字列"のようにワイド文字列を渡すとエラーが発生する場合があります。

プリプロセッサディレクティブでは、ワイド文字ではなく、ASCIIの文字列のみを使用するようにしてください。

#include <stdio.h>
// 正しい例: ASCII文字列を使用している
#pragma message("This is an ASCII message")
// 誤った例: ワイド文字列を使用するとエラーとなる可能性がある
// #pragma message(L"This message causes an error")
int main(void) {
    printf("プリプロセッサディレクティブでASCII文字列を使用した例です\n");
    return 0;
}

This is an ASCII message

エラー解決の対策

ソースコード修正による対応方法

正しいワイド文字定数の記述方法

ワイド文字定数を正しく記述するためには、必ずリテラルの前にLを付ける必要があります。

以下のサンプルコードでは、正しい形でワイド文字を記述しており、エラー C2002 を回避できます。

#include <stdio.h>
#include <wchar.h>
int main(void) {
    // 正しい例: Lプレフィックスを使用している
    wchar_t wideChar = L'漢';
    wprintf(L"%lc\n", wideChar);
    return 0;
}

漢

文字列リテラル連結の修正方法

ワイド文字リテラル同士の連結や、通常の文字列リテラル同士の連結は可能ですが、型の混在は避けなければなりません。

ワイド文字リテラル同士を連結する場合、すべてにLプレフィックスを記述してください。

下記のサンプルコードは正しい連結方法の例です。

#include <stdio.h>
#include <wchar.h>
int main(void) {
    // 正しい例: すべてのリテラルに L プレフィックスを付与して連結
    const wchar_t *message = L"Wide" L"Literal";
    wprintf(L"%ls\n", message);
    return 0;
}

WideLiteral

コンパイラ設定の確認

コンパイラ固有の仕様のチェック

各コンパイラには独自の仕様やオプションがあるため、コンパイルエラーの原因が環境固有である場合があります。

使用しているコンパイラのドキュメントやリリースノートを確認して、特にワイド文字やプリプロセッサディレクティブに関する仕様・制限を把握してください。

たとえば、Microsoft Visual C++では、ASCII文字列のみをプリプロセッサディレクティブで利用する必要があるため、その仕様に沿って設定を確認することが求められます。

設定変更によるエラー回避策

エラーを回避するために、コンパイラの設定を変更する選択肢もあります。

開発環境の設定画面や、コンパイル時に渡すオプションを確認して、ワイド文字リテラルやプリプロセッサの動作に影響を与える項目がないかチェックしてください。

場合によっては、特定のフラグを無効化することでエラーを回避できることもあります。

コンパイラ固有の設定を見直し、最適な設定を選択することで、エラーの発生を未然に防ぐことができるでしょう。

まとめ

この記事では、コンパイラエラー C2002 の発生要因として、ワイド文字定数の記述ミス(Lプレフィックスの省略、バイト数超過、通常文字列との誤った連結)や、必要なヘッダーファイル(STDDEF.h)の未インクルード、プリプロセッサディレクティブでのASCII文字制限について説明しています。

また、正しい記述方法やコンパイラ設定の見直しによりエラーを回避できる方法が示されています。