Comments in Python

Introduction

Comments help explain what the code does. They make code easier to understand for you and others.

To explain why a piece of code is written a certain way.

To leave notes for yourself or others about what a section of code does.

To temporarily stop a line of code from running while testing.

To add reminders or TODOs inside your code.

To clarify complex or tricky parts of the code.

Syntax

Python

# This is a single-line comment
'''
This is a
multi-line comment
'''

Single-line comments start with # and go to the end of the line.

Multi-line comments use triple quotes ''' or """ but are actually multi-line strings not assigned to a variable.

Examples

This comment explains what the print statement does.

Python

# This is a comment explaining the next line
print('Hello')

This style is used for longer explanations or notes.

Python

'''
This is a multi-line comment.
It can span several lines.
'''

You can put comments after code on the same line to explain it.

Python

print('Start')  # This comment is after code on the same line

Sample Program

The comments explain what the program and the print line do.

Python

# This program prints a greeting message
print('Hello, friend!')  # Print greeting

Important Notes

Comments do not affect how the program runs.

Use comments to make your code easier to read and maintain.

Keep comments clear and concise.

Summary

Comments explain code and help others understand it.

Use # for single-line comments.

Use triple quotes for multi-line comments or notes.

Practice

1. What symbol is used to write a single-line comment in Python?

easy

A. /* */

B. //

C. #

D.

Solution

1. Step 1: Identify the comment symbol in Python

   Python uses the # symbol to start a single-line comment.

2. Step 2: Compare with other languages

   Other symbols like // or /* */ are used in languages like JavaScript or C, not Python.

3. Final Answer:

   # -> Option C

4. Quick Check:

   Single-line comment = # [OK]

Hint: Single-line comments start with # in Python [OK]

Common Mistakes:

• Using // instead of #
• Using /* */ for single-line comments
• Confusing HTML comments with Python

2. Which of the following is the correct way to write a multi-line comment in Python?

easy

A.

B. '''This is a multi-line comment'''

C. // This is a multi-line comment //

D. /* This is a multi-line comment */

Solution

1. Step 1: Recognize Python multi-line comment style

   Python uses triple single quotes ''' or triple double quotes """ for multi-line comments or docstrings.

2. Step 2: Eliminate other language comment styles

   Options A, B, and D are comment styles from other languages like HTML, JavaScript/C++, and C.

3. Final Answer:

   '''This is a multi-line comment''' -> Option B

4. Quick Check:

   Multi-line comment = triple quotes [OK]

Hint: Use triple quotes ''' or """ for multi-line comments [OK]

Common Mistakes:

• Using // or /* */ which are not Python syntax
• Using HTML style comments
• Trying to use # for multi-line comments without repeating

3. What will be the output of the following code?

print('Hello')  # This prints Hello
# print('World')

medium

A. Hello

B. SyntaxError

C. World

D. Hello\nWorld

Solution

1. Step 1: Understand the effect of comments on code execution

   The first line prints 'Hello' because the comment after it does not affect the print statement.

2. Step 2: Recognize that the second print is commented out

   The second print statement is fully commented out, so it does not run or print anything.

3. Final Answer:

   Hello -> Option A

4. Quick Check:

   Commented code does not run = Hello [OK]

Hint: Code after # is ignored; only uncommented lines run [OK]

Common Mistakes:

• Thinking commented print runs
• Expecting both Hello and World printed
• Confusing comment with string

4. Find the error in this code snippet:

# This is a comment
print('Start')
'''This is a comment without an end
print('End')

medium

A. Comments cannot be placed before print statements

B. No error, code runs fine

C. print('End') is outside comment and runs normally

D. Missing closing triple quotes causes SyntaxError

Solution

1. Step 1: Check triple quote usage

   The triple quotes start a multi-line comment but are not closed, causing a syntax error.

2. Step 2: Understand impact on code parsing

   Without closing quotes, Python treats the rest as part of the string, leading to a SyntaxError.

3. Final Answer:

   Missing closing triple quotes causes SyntaxError -> Option D

4. Quick Check:

   Unclosed triple quotes = SyntaxError [OK]

Hint: Always close triple quotes to avoid syntax errors [OK]

Common Mistakes:

• Ignoring missing triple quote closure
• Thinking comments can be unclosed
• Assuming code after triple quotes runs

5. You want to temporarily disable a block of code without deleting it. Which is the best way to do this in Python?

hard

A. Put # at the start of each line in the block

B. Surround the code block with triple quotes ''' ... '''

C. Use /* ... */ around the block

D. Wrap the block in

Solution

1. Step 1: Understand Python comment styles for disabling code

   Python does not officially support block comments; the common way is to put # at the start of each line.

2. Step 2: Evaluate triple quotes usage

   Triple quotes create a string literal, which may not disable code properly and can cause unexpected behavior if used improperly.

3. Step 3: Recognize other language comment styles

   Options C and D are not valid in Python.

4. Final Answer:

   Put # at the start of each line in the block -> Option A

5. Quick Check:

   Disable code block = # per line [OK]

Hint: Use # on each line to disable code safely [OK]

Common Mistakes:

• Using triple quotes which may not disable code
• Using /* */ which is invalid in Python
• Using HTML comments which do nothing in Python