Difference between revisions of "Comments"
m |
|||
Line 1: | Line 1: | ||
− | {{1010Topic|Introduction=We can add comments to our source code to improve organization and to help someone else understand what our code does.|Overview=Here you will learn the syntax needed to document your code through comments.|Chapter_TOC=[[ | + | {{1010Topic|Introduction=We can add comments to our source code to improve organization and to help someone else understand what our code does.|Overview=Here you will learn the syntax needed to document your code through comments.|Chapter_TOC=[[Java Fundamentals]]}} |
=Example of a Java Program with Comments= | =Example of a Java Program with Comments= |
Revision as of 15:32, 20 November 2007
COMP 1010 Home > Java Fundamentals
IntroductionWe can add comments to our source code to improve organization and to help someone else understand what our code does.
|
---|
{{{Body}}}
Example of a Java Program with Comments
Take a look at the example below. Notice the lines that are contained inside /*
and */
. Also notice the lines that start with //
. These lines are called comments.
/** * PrintTemp * * This program shows you how to print the contents of a variable * * COMP 1010 * Instructor: Compsci Wiki * Assignment: Assignment 0, question 0 * @author Compsci Wiki * @version */ public class PrintTemp { public static void main(String args[]) { int temp; //declare an variable of type integer temp = 25; //store 25 in a variable System.out.println("The temperature is currently " + temp + " degrees Celsius."); //print the temperature to the screen } }
We can use // to indicate that the text that follows is a comment. If we want to include a comment that is longer than one line, we can put /* at the beginning of the comment and */ at the end.
When a program is compiled, the compiler ignores the comments. This means that comments do not affect the program. So, why do we use comments? Comments are only for you and any one else that reads your source code. To see the value of comments, imagine someone gives you the source code to a long, complex program which does not contain any comments. If you wanted to understand the code you would have to spend a lot of time going through each line and figuring out what everything does. However, if this program had comments that explained the purpose of each class, method, and block of code, it would make understanding the code a lot easier.