Webプログラミング研究所〜初心者・中級者Webプログラマ(CGI・Perl・PHP・Javaプログラム言語)のための支援サイト〜 「Webプログラミング研究所」TOPへ 「Webプログラミング研究所」TOPへ
 
「プログラミングサンプル集」TOPへ 「プログラミングサンプル集」TOPへ
 
目次をフレームで表示 目次をフレームで表示
 

コメント文

 
概要
コメント文とは、プログラムの処理に対して、説明文を付加したい場合などに使用します。
コメント文はできるかぎり多用しましょう。そうすることにより、可読性が向上したり、他人がプログラムを読んで理解しやすくなります。
他人にも読みやすいプログラムを書けるのは、良いプログラマであり、信頼されるプログラマです。
 
Perl Perlはシェル系のコメント記号"#"を使用します。
"#"以下(右側)の文字列はすべてコメントとみなし、プログラムとして処理されません。

サンプルソース
$param = 2 + 3;   # 2と3を足して$paramに代入
print $param;       # $paramを出力する


Perlでは、PHPやJavaのように複数行をまとめてコメントアウトする記号はありません。
しかし、perldoc用の記法「=pod」と「=cut」を使用すれば、その間の文章は処理されず、
複数コメントアウトしたような状態になります。
注意点として、「=pod」や「=cut」は、行頭に記述しなければなりません。

$param = 2 + 3;
=pod
コメントです。
何行書いても「=pod」と「=cut」の間は処理されません。
=cut
print $param;
 
PHP PHPはPerlのような"#"を使用したコメントの書き方とJavaのような"//"や"/* */"や"/** */"を使用したコメントの書き方の両方が可能です。
"#"と"//"は、同じ行でこの記号以下(右側)に記述した内容をすべてコメントとみなし、処理を行わないための記号です。
一般的には"#"よりも"//"の方がよく使用されます。

サンプルソース
$param = 2 + 3;   # 2と3を足して$paramに代入
print $param;       # $paramを出力する

サンプルソース
$param = 2 + 3;   // 2と3を足して$paramに代入
print $param;       // $paramを出力する。

複数行をコメントアウトするときは、"/* */"や"/** */"を使用します。
"/** *"を使用するとphpDocumentatorなどのツールをし、JavaのJavadocのように、PHPドキュメントを作成することができます。
PHPについての説明はここでは割愛します。

サンプルソース
/*
 * 2と3を足して$paramに代入し、
 * $paramの値を出力する。
 */

$param = 2 + 3;
print $param;
 
Java Javaでのコメント文は、"//"や"/* */"や"/** */"を使用します。

サンプルソース
int param = 2 + 3;   // 2と3を足して$paramに代入
System.out.println(param);       // paramを出力する

複数行をコメントアウトするときは、"/* */"や"/** */"を使用します。
"/** *"を使用すると、この内容を読み取り、JavadocというHTMLで生成されたドキュメントを生成することができます。
Javadocについての説明はここでは割愛します。

/*
 * 2と3を足してparamに代入し、
 * paramの値を出力する。
 */

int param = 2 + 3;
System.out.print("" + param);

TIPS
System.out.print()メソッドの引数は、String型となります。
上記では、paramを引数とすると、int型であるためエラーとなります。
""(空文字)とint型変数を「+」記号で文字列結合すると、paramの値がString型として取得できます。
 
NOTE
 
ご意見箱コーナー (管理者宛てメール)
このページは、あなたの参考になりましたか?

参考になった  どちらともいえない  あまり参考にならなかった

ご意見・ご感想・ご要望がありましたら、ご記入いただければ幸いです。
今後のコンテンツ作成、ページ改善等の参考にさせていただきます。

 


Webプログラマになりたい人のためのスクール・講座情報

クリエイターの皆さん!お仕事ありますよ!フェローズに!

パソコンスクールガイド
積極的な情報収集が目標実現の近道です。

就職・起業・SOHO・それとも副業? デジハリがノウハウを伝授!

就転職に強い、資格取得スキルアップ専門校ヒューマンアカデミー

CsideNet レンタルサーバー サブドメイン型 780円/月
CGI/SSI/PHP、データベース(MySQL)が利用できます。1週間の試用期間があるのがGood!!

転職・派遣・就職・アルバイトの求人情報検索支援サイト 〜 14ALL JOB SEARCH 〜
 
 
  「Webプログラミング研究所」TOPへ 「Webプログラミング研究所」TOPへ
 
「プログラミングサンプル集」TOPへ 「プログラミングサンプル集」TOPへ
 
目次をフレームフレームで表示 目次をフレームで表示

Copyright (C) 2004 - 2005 IWAMODE Project All Rights Reserved.