Python Tutorial 14 --- “Functions and Docstrings”

 

Python Tutorial 14 ---

“Functions and Docstrings”

This PROGRAM or TUTORIAL is about Python’s “Functions and Docstrings”

DOC

“Functions in Python can be defined as lines of codes that are built to create a specific task and can be used again and again in a program when called.”

There are two types of functions in the Python language:

  • Built-in functions
  • User-defined functions

We have used a lot of built-in functions in our code till now, these functions include print(), or sum(), etc. So, we have a good idea about how to call a function. Built-in functions are already present in our python program, and we just have to call them whenever we need them to execute. Being familiar with built-in functions we will now look into User-defined function mostly in this tutorial.

We must know how to define a function in Python in order to create one ourselves. We have to use the def keyword in order to define a function accompanied by the function's name with a pair of parentheses. The function of parenthesis is to send arguments or parameters to a function. In simple words, parameters can be defined as values that are sent in the parenthesis. For example, if a function is used to add two numbers then both the numbers will be passed as parameters in the parenthesis. After parenthesis, a colon is used to get in the body of the function. Some functions may return a value to the caller, so in order to get the value, a return statement is put at the end of the body of the function that gives the value that has been calculated by the function.

Calling a function is very simple, we just have to write the name of the function along with the closing parenthesis. If the function requires some arguments then we write those in the parenthesis, but if it does not return anything, then we leave them empty.

We have discussed a lot about what functions are and how to use them, now let us move to the advantages of using a function:

  • If we are working on a big project then we will prefer to make as many functions as possible, so every other member of our team could use that.
  • By using functions, we can avoid the repetition of code to an extent. As we have discussed in the previous tutorial i.e. Tutorial #22, more lines of code mean less efficiency. Also repeating the same code at different places will just make the code more crowded than required.
  • The reusability of code is ensured by using functions. We can even use a function inside another function or in any part of our code.
  • By making a function of code that we are going to use again and again, we can save a lot of time.

Docstrings:

Docstring is a short form of documentation string. Its purpose is to give the programmer a brief knowledge about the functionality of the function. It must be the first string in a function, and it is also an optional string but always good to have it while working on programs having multiple functions. The syntax for writing a docstring is very simple as it is just a string written in between three double quotes placed three times (""" """) on either side of the string. But it has to be the first line of code in the function’s body. To call a docstring we write the name of the function followed by ._doc_.

CODE

#Functions And Docstrings

"""a = 10
b = 5
c = sum((a, b)) # built-in function
print(c)
def function1 ():
    print("Now you are in function 1")

print(function1()) #Output=None; if we do not use print 'None' would not be print
#to have a same output multiple times we use function
function1() #Now you are in function 1
function1() #Now you are in function 1
function1() #Now you are in function 1"""
def function2(a,b):
    """ This is a doc string which defines that this function is only use to
calculate average of two numbers"""
    average = (a+b)/2
    #print(average) #Output = 25.0; To store function in a variable---
    return average  #If we do not use return it will give us 'None' in output
v = function2(20,30) #Output = 25.0
print(function2.__doc__)
print(v) #Output = 25.0

Comments

Post a Comment

Popular posts from this blog

Python Tutorial 38 --- "Self & __init__() (Constructors)(OOPS 3)"

 Python Tutorial 38 --- "Self & __init__() (Constructors)(OOPS 3)" Doc --- In this tutorial, we will be discussing methods and constructors in detail. If you are familiar with any other object-oriented programming language, then the concept will be easy for you to grasp. So, let us begin with the Method. Method: A method is just like a function, with a  def  keyword and a single parameter in which the name of the object has to be passed. The purpose of the method is to show all the details related to the object in a single go. We choose variables that we want the method to take but do not have to pass all of them as parameters. Instead, we have to set the parameters we want to include in the method during its creation. Using methods make the process simpler and a lot faster.  Self keyword: The self keyword is used in the method to refer to the instance of the current class we are using. The self keyword is passed as a parameter explicitly every time we define a m...
Read more

Python Exercise 4 --- "Number Guessing Game"

  Python Exercise 4: "Number Guessing Game" Q: You have to build a  "Number Guessing Game,"  in which a winning number is set to some integer value. The Program should take input from the user, and if the entered number is less than the winning number, a message should display that the number is smaller and vice versa. Instructions: 1. You are free to use anything we've studied till now. 2. The number of guesses should be limited, i.e (5 or 9). 3. Print the number of guesses left. 4. Print the number of guesses he took to win the game. 5. “Game Over” message should display if the number of guesses becomes equal to 0. You are advised to participate in solving this problem. This task helps you become a good problem solver and helps you accept the challenge and acquire new skills. Solution: print ( "Hii! Welcome, \n " , "This a number guessing game, " "made by Saswata \n " , "Let's Start \n " ) n...
Read more

Python Tutorial 13 --- "Short Hand If Else Notation In Python"

 Python Tutorial 13 --- "Short Hand If Else Notation In Python" This PROGRAM or TUTORIAL about Python's  "Short Hand If Else Notation In Python" DOC Before going through the if-else short-hand statement, we must be familiar with the basic definition, so we know what the short-hand statement actually is. In basic English, shorthand can be said as “a basic way of writing using abbreviations or symbols”. For example, we do not use the full name, Kentucky Fried Chicken, instead we use its abbreviation that is KFC. Writing in such a compact manner is known as shorthand. Now let us move towards the definition of shorthand with respect to the Python language. “An executable statement, written in so compact manner that it comprises of only a single line of code is known as shorthand statement.” Python supports many sorts of shorthand statements and with the help of these statements, we can write our code in a more compact sort or form using less space. We learned the or...
Read more