python学习笔记之函数和函数文档

zh_

函数

    >>> def MyFirstFunction():
        print('First Function')
        print('Exciting')
        print('...............')

def定义函数，后面接函数名，冒号不可少

    >>> MyFirstFunction()
    First Function
    Exciting
    ...............

带有参数的函数

    >>> def MySecondFunction(name):
        print(name+'you')
    >>> MySecondFunction('Adventor')
    Adventoryou

带有返回值的函数

    >>> def add(num1,num2):
       return (num1 + num2)
    >>> add(5,6)
    11

函数文档

>>> def Function(name):
   '函数文档'
   #函数文档只是一个形式，占据一个参数位置
   print('输入的字符是:'+name)


>>> Function('函数文档')
输入的字符是:函数文档
>>> Function.__doc__
'函数文档'

• 如上，函数文档是以字符串的形式写在函数中的，查看函数文档以函数名和双下横线查看
• 也可以使用help命令查看，help命令查看结果更加易读，如下

    >>> help(Function)
    Help on function Function in module __main__:
  
    Function(name)
        函数文档
  
    >>> print.__doc__
    "print(value, ..., sep=' ', end='\\n', file=sys.stdout, flush=False)\n\nPrints the values to a stream, or to sys.stdout by default.\nOptional keyword arguments:\nfile:  a file-like object (stream); defaults to the current sys.stdout.\nsep:   string inserted between values, default a space.\nend:   string appended after the last value, default a newline.\nflush: whether to forcibly flush the stream."
    >>> help(print)
    Help on built-in function print in module builtins:
  
    print(...)
     print(value, ..., sep=' ', end='\n', file=sys.stdout, flush=False)
  
        Prints the values to a stream, or to sys.stdout by default.
        Optional keyword arguments:
        file:  a file-like object (stream); defaults to the current sys.stdout.
        sep:   string inserted between values, default a space.
        end:   string appended after the last value, default a newline.
        flush: whether to forcibly flush the stream.