C言語のコメントアウトは奥が深い

ARMマイコンによる組込みプログラミング入門 改訂2版: ロボットで学ぶC言語

posted with amachazl at 2020.04.11

ヴイストン, ロボット実習教材研究会
オーム社 (2018-05-09)
売り上げランキング: 164,583

Amazon.co.jpで詳細を見る

　プログラム中に処理の内容をメモする場合は、コメントアウトという機能を使用します。「/*」と「*/」で囲まれた文字列はコンパイル時に無視されるため、ここに任意の文字列を記述することができます。この中には日本語や全角文字、予約語などを記述 しても問題ありません。見やすいソースを作成するためにも、積極的にコメントを残すことが望ましいです。
　また、 「//」もコメントアウトとして利用できます。これはC++言語で採用されているコメントアウトですので、C言語では使用できない場合があります。が、本書で利用しているLPCXpressoでは利用可能です。

古い規格(C90)で//を使ったコメントアウトが使えないか実験

#include stdio .h
void main(){
	//このコメントがあることでコンパイルエラーが起きるか確認
	printf("test\n");
}

gcc .\test.c -std=c90

.\test.c: In function 'main':
.\test.c:3:5: error: C++ style comments are not allowed in ISO C90
    3 |     //
      |     ^
.\test.c:3:5: note: (this will be reported only once per input file)

gcc .\test.c -std=c99

//を使うと"ダメ文字"の影響を受けてしまう場合がある。

末尾にバックスラッシュが入ったコメントの次の行もコメントアウトされているため、変数iが宣言されてないというエラーとfor分の}がmain文の}となっており、}が一つ余っているというエラーが出ています。

#include <stdio.h>
void main(){
	//このコメントがあると下の文字を表示することが不可能
	printf("test\n");
	printf("abc\n");
}

abc

#include <stdio.h>
void main(){
	/*このコメントがあっても下の文字を表示することが可能*/
	printf("test\n");
	printf("abc\n");
}

test
abc

#include <stdio.h>
void main(){
	//この処理があることで1から10まで数えることが可能
	for(int i=1;i<=10;i++){
		printf("%d \n",i);
		
	}
}

"message": "expected identifier or '(' before '}' token",

(補足)pythonの場合はどうなるか。

# このコメントがあると下の文字を表示することが不可能
print("abc")
print("test")

SyntaxError: Non-UTF-8 code starting with '\x89' in file .\test.py on line 1, 
 
but no encoding declared; see http://python.org/dev/peps/pep-0263/ for details

# coding: shift_jis
# このコメントがあると下の文字を表示することが不可能
print("abc")
print("test")
 

abc
test

(参考)ダメ文字が影響していると思われる不具合例  

まとめ