Python的docstring

参考文献:http://www.maixj.net/ict/python-docstring-16247

http://wiki.jikexueyuan.com/project/simple-python-course/example-seven-eight.html

docstring,编写代码,同时也能写出文档,保持代码和文档的一致。
docstring说白了就是一堆代码中的注释。
Python的docstring可以通过help函数直接输出一份有格式的文档。

编写test.py

def printMax(x, y):
    '''Prints the maximum of two numbers.

    The two values must be integers.'''
    x = int(x) # convert to integers, if possible
    y = int(y)

    if x > y:
         print (x, 'is maximum')
    else:
         print (y, 'is maximum')

printMax(3, 5)
print (printMax.__doc__)

命令行输入 help(test)

import test
5 is maximum
Prints the maximum of two numbers.

    The two values must be integers.

help(test)
Help on module test:

NAME
    test - Created on Sat Jun  2 19:05:08 2018

DESCRIPTION
    @author: linzhiwei02

FUNCTIONS
    printMax(x, y)
        Prints the maximum of two numbers.

        The two values must be integers.

FILE
    /Users/linzhiwei02/Desktop/test.py
  • 1
    点赞
  • 2
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值