29
loading...
Python Comment Block
ItsMyCode |
Comments are a piece of text in a computer program that provides more information on the source code written. Like every other programming language, Python has three different types of comments: single-line comments, multi-line comments, and documentation string.
Comments are used to explain the source code. Comments are mainly used for the following purposes.
For example, let’s say you have written complex business logic, formulas, algorithms, etc. Then we need to document it using the comments that explain what the code does, thus improving the readability of the code in Python.
Python interpreter ignores the comments while executing the code and only interprets the code.
There are three kinds of comments we can use in Python.
Let us look into details on how to use these comments in Python code with examples.
Single-line comments, also called block comments, start with a hash sign (#) followed by a single space and a text string.
The hash (#) works with only a single line of code and not on multi-line code.
Let’s take an example to demonstrate single-line comments in Python.
# This is a single line comment example
print("Hello World")If you place the comment in the same line as a statement, you will have an inline comment.
Like single-line comments, inline comments also begin with a hash (#) sign and are followed by a space and the comment text.
Let’s take an example to demonstrate inline comments in Python.
print("Hello World") # This is a example of inline commentUsually, in other languages like C, C#, Java, etc., we can writea multi-line comment as shown below.
/* This is a comment block
which supports
Multi-line code */But you cannot do this in Python.
Python does not have any built-in mechanism for commenting out multiple lines. However, there are different ways to achieve this in Python.
We can use multiple hashtags to write multi-line comments in Python. Each line that has a hash sign(#) is considered as a single line comment.
# This is how we can acheive
# Multi-line comments in Python
print("Hello World")Documentation strings, also called docstrings, are the string literal denoted with triple quotes that occur as the first statement in a module, function, class, or method definition.
Note: We can also use triple “”” quotations to create docstrings.
Let’s take an example to demonstrate single line docstring. ** **
def Add(a,b):
'''Takes two number as input and returns sum of 2 numbers'''
return a+bInside the triple quotation marks is the docstring of the function Add() as it appears right after its definition.
The multi-line docstring can span across multiple lines of code starts with triple quotes(“””) and ends with triple quotes (“””).
The following example shows you how to use multi-line docstrings:
def Add(a,b):
'''Takes two number as input
Adds a and b
Returns sum of a and b as output
'''
return a+b
print(Add(5,6))The post Python Comment Block appeared first on ItsMyCode.
29