C言語：warning: format ‘%d’ expects argument of type ‘int’ の原因と解決策

2026年5月28日

標準ライブラリ・入出力

C言語でプログラムを記述し、コンパイルを行った際に「warning: format ‘%d’ expects argument of type ‘int’」という警告が表示されることがあります。

この警告は、printf関数などの書式付き出力関数において、指定した書式指定子と実際に渡した引数の型が一致していないことを示しています。

プログラム自体は動作することもありますが、型不一致は将来的なバグや予期せぬ動作、あるいはセキュリティ上の脆弱性の原因となる重大な問題です。

本記事では、この警告が発生する具体的な原因とその修正方法について、初心者から中級者まで納得できるレベルで詳しく解説します。

目次 [ close ]

警告が発生する背景とその意味

C言語のprintf関数は、可変引数という特殊な仕組みを利用して、任意の数の引数を受け取ることができます。

しかし、printf関数自体は引数として渡されたデータの型を、コンパイル時に自動で判別する機能を持ち合わせていません。

そのため、プログラマが第一引数の「書式文字列」の中で、どの引数をどの型として解釈するかを明示的に指示する必要があります。

警告文にあるformat '%d' expects argument of type 'int'は、「%dという書式指定子にはint型のデータを渡すべきですが、実際には異なる型のデータが渡されています」という意味です。

近年のコンパイラ（GCCやClangなど）は、静的解析機能によってこの不一致を検出し、開発者に修正を促してくれます。

よくある発生原因

この警告が発生するケースは多岐にわたりますが、代表的なパターンを理解しておくことで、デバッグの時間を大幅に短縮できます。

long型やlong long型を渡している

最も頻繁に見られる原因の一つが、int型よりも大きな整数型であるlong型やlong long型を%dで出力しようとすることです。

多くの64bit環境において、int型は32bit、long型は64bitとして定義されています。

サイズが異なるデータを渡すと、関数内部でのメモリ読み出し範囲がずれ、誤った値が表示される原因となります。

C言語

#include <stdio.h>

int main(void) {
    long large_value = 1234567890123L;
    // long型に対して%dを使用しているため警告が発生
    printf("Value: %d\n", large_value);
    return 0;
}

実行結果

Value: -191227617（期待しない値が出力される可能性がある）

アドレス（ポインタ）を渡している

変数の値を表示したい場合に、誤って変数名の前に&（アンパサンド）を付けてしまい、アドレスを渡してしまうミスもよくあります。

ポインタはメモリアドレスを保持する特別な型であり、数値としてのint型とは根本的に異なります。

コンパイラは、「intを期待している場所に int*（ポインタ）が渡された」として警告を出します。

C言語

#include <stdio.h>

int main(void) {
    int score = 100;
    // 誤ってアドレスを渡している
    printf("Score: %d\n", &score);
    return 0;
}

size_t型を出力しようとしている

配列の要素数やsizeof演算子の結果を表すsize_t型を、安易に%dで出力しようとすると警告が出ます。

size_t型はプラットフォームによってunsigned intであったりunsigned longであったりと定義が異なります。

特にモダンな開発環境では、size_tは符号なしの64bit整数であることが多く、%d（符号あり32bit整数）とは互換性がありません。

正しい書式指定子の選び方

警告を解消するためには、変数の型に合わせた正確な書式指定子を選択する必要があります。

以下に、C言語で標準的に使用される型と、それに対応する書式指定子の対応表をまとめました。

型名	意味	書式指定子
int	標準的な符号あり整数	%d
unsigned int	符号なし整数	%u
long	大きな符号あり整数	%ld
long long	非常に大きな符号あり整数	%lld
size_t	メモリサイズや要素数	%zu
float / double	浮動小数点数	%f
void*	ポインタ（アドレス）	%p

このように、データの型ごとに専用の指定子が用意されています。

例えば、long型を表示したい場合は%ldを使用し、size_t型を表示したい場合は%zuを使用するのが正しい作法です。

具体的な修正例と実践的なテクニック

それでは、先ほど挙げた警告が発生するコードをどのように修正すべきか、具体的なパターンを見ていきましょう。

型に合わせた指定子への変更

変数の型を維持したまま、出力を正しく行う方法です。

C言語

#include <stdio.h>

int main(void) {
    long num = 1000000L;
    // %d を %ld に修正
    printf("Correct value: %ld\n", num);
    
    size_t length = 10;
    // %d を %zu に修正
    printf("Length: %zu\n", length);
    
    return 0;
}

「型を変えるのではなく、指定子を型に合わせる」というのが最も基本的な解決策となります。

明示的な型キャストの利用

特定の理由により、あえて小さな型として出力したい場合や、型を統一して扱いたい場合にはキャスト（型変換）を利用します。

ただし、大きな型から小さな型へキャストすると、値が溢れてデータが欠損する（オーバーフロー）リスクがあることを忘れてはいけません。

C言語

#include <stdio.h>

int main(void) {
    long long huge_num = 12345LL;
    // int型に収まることが確実な場合のみキャストを利用
    printf("Cast value: %d\n", (int)huge_num);
    
    return 0;
}

scanf関数における同様の注意点

この警告はprintfだけでなく、入力を受け取るscanf関数でも同様の理由で発生します。

むしろ、scanfの場合は出力を間違えるよりも深刻な「メモリ破壊」を引き起こす可能性が高いため、より注意が必要です。

scanfで%dを使用しながらlong型の変数のアドレスを渡すと、intのサイズ分しかメモリが書き込まれず、残りのバイトが未定義の状態になります。

C言語

long val;
// 非常に危険なコード：警告を無視するとクラッシュの原因になる
scanf("%d", &val);

必ず、scanf("%ld", &val);のように、型と指定子を厳密に一致させてください。

コンパイラ機能を活用した未然防止策

開発効率を上げるためには、警告を単なる「うっとうしいメッセージ」として捉えるのではなく、品質向上のためのツールとして活用することが大切です。

GCCやClangを使用している場合、コンパイルオプションに-Wallや-Wextraを追加することをお勧めします。

これらのオプションを有効にすることで、書式指定子の不一致だけでなく、初期化されていない変数の使用や論理的な誤りについても警告を出してくれるようになります。

また、C11規格以降で導入された_Genericキーワードを活用して、自作の出力マクロを作成することで、型に応じた柔軟な処理を実現することも可能です。

しかし、まずは基本に忠実に、「自分が定義した変数の型が何であるか」を常に意識してコードを書くことが、最も確実な上達への近道です。

まとめ

「warning: format ‘%d’ expects argument of type ‘int’」は、C言語の厳格な型システムがプログラマのミスを教えてくれる親切な通知です。

主な原因は以下の3点に集約されます。

int型以外の整数（longやshortなど）を%dで表示しようとしている。
変数の値ではなく、ポインタ（アドレス）を渡している。
size_t型などの環境依存の型に対して不適切な指定子を使っている。

修正の際は、変数の型を確認し、%ld、%u、%zu、%pといった適切な書式指定子を選択するようにしてください。

型に無頓着なコードは、移植性（ポータビリティ）を低下させ、将来的に原因不明のバグを生む温床となります。

警告を一つひとつ丁寧に解消していく習慣を身につけ、堅牢で信頼性の高いC言語プログラミングを実践していきましょう。