Comments are very important in your programs. They are used to tell you
what something does in English, and they also are used to disable parts
of your program if you need to remove them temporarily. Here's how you
use comments in Python:
# A comment, this is so you can read your program later.
# Anything after the # is ignored by python.
print "I could have code like this." # and the comment after is ignored
# You can also use a comment to "disable" or comment out a piece of code:
# print "This won't run."
print "This will run."
From now on, I'm going to write code like this. It is important for you to understand
that everything does not have to be literal. Your screen and program may visually look
different, but what's important is the text you type into the file you're writing in your
text editor. In fact, I could work with any text editor and the results would be the same.
What You Should See
$ python ex2.py
I could have code like this.
This will run.
Again, I'm not going to show you screenshots of all the terminals possible. You should understand
that the above is not a literal translation of what your output should look like visually, but that
the text between the first $ python ... and last $ lines will be what you focus on.
Study Drills
- Find out if you were right about what the # character does and make sure you know what it's called (octothorpe or pound character).
- Take your ex2.py file and review each line going backwards. Start at the last line, and check each word in reverse against what you should have typed.
- Did you find more mistakes? Fix them.
- Read what you typed above out loud, including saying each character by its name. Did you find more mistakes? Fix them.
Common Student Questions
- Are you sure # is called the pound character?
- I call it the octothorpe and that is the only name that no country uses and
that works in every country. Every country thinks their way to call this one
character is both the most important way to do it, and also the only way
it's done. To me this is simply arrogance and really, y'all should just
chill out and focus on more important things like learning to code.
- If # is for comments, then how come # -*- coding: utf-8 -*- works?
- Python still ignores that as code, but it's used as a kind of "hack" or
workaround for problems with setting and detecting the format of a file.
You also find a similar kind of comment for editor settings.
- Why does the # in print "Hi # there." not get ignored?
- The # in that code is inside a string, so it will be put into the string
until the ending " character is hit. These pound characters are just
considered characters and aren't considered comments.
- How do I comment out multiple lines?
- Put a # in front of each one.
- I can't figure out how to type a # character on my country's keyboard?
- Some countries use the Alt key and combinations of those to print
characters foreign to their language. You'll have to look online in
a search engine to see how to type it.
- Why do I have to read code backwards?
- It's a trick to make your brain not attach meaning to each part
of the code, and doing that makes you process each piece exactly.
This catches errors and is a handy error checking technique.