美文网首页我的Python自学之路程序员
查看python的模块和函数帮助文档方法

查看python的模块和函数帮助文档方法

作者: cheng3100 | 来源:发表于2017-02-17 13:51 被阅读6936次

python的一个优势是有着大量自带和在线的模块(module)资源,可以提供丰富的功能,在使用这些模块的时候,如果每次都去网站找在线文档会过于耗费时间,结果也不一定准确。因此这里介绍下python自带的查看帮助功能,可以在编程时不中断地迅速找到所需模块和函数的使用方法

通用帮助函数help()

在python命令行中键入help(),可以看到:

>>> help()

Welcome to Python 3.5's help utility!

If this is your first time using Python, you should definitely check out
the tutorial on the Internet at http://docs.python.org/3.5/tutorial/.

Enter the name of any module, keyword, or topic to get help on writing
Python programs and using Python modules.  To quit this help utility and
return to the interpreter, just type "quit".

To get a list of available modules, keywords, symbols, or topics, type
"modules", "keywords", "symbols", or "topics".  Each module also comes
with a one-line summary of what it does; to list the modules whose name
or summary contain a given string such as "spam", type "modules spam".

help> 

进入help帮助文档界面,根据屏幕提示可以继续键入相应关键词进行查询,继续键入modules可以列出当前所有安装的模块:

help> modules

Please wait a moment while I gather a list of all available modules...

AutoComplete        _pyio               filecmp             pyscreeze
AutoCompleteWindow  _random             fileinput           pytweening
......        

Enter any module name to get more help.  Or, type "modules spam" to search
for modules whose name or summary contain the string "spam".

可以继续键入相应的模块名称得到该模块的帮助信息。
这是python的通用的查询帮助,可以查到几乎所有的帮助文档,但我们很多时候不需要这样层级式地向下查询,接下来会介绍如何直接查询特定的模块和函数帮助信息。

模块帮助查询

查看.py结尾的普通模块help(module_name)

例如要查询math模块的使用方法,可以如下操作:

>>> import math
>>> help(math)
Help on built-in module math:

NAME
    math

DESCRIPTION
    This module is always available.  It provides access to the
    mathematical functions defined by the C standard.

FUNCTIONS
    acos(...)
        acos(x)
        
        Return the arc cosine (measured in radians) of x.
...

>>> 

使用help(module_name)时首先需要import该模块,有些教程中不进行导入而在模块名中加入引号help('module_name'),这种方法可能会带来问题,大家可以用math模块测试,建议使用先导入再使用help()函数查询

查看内建模块sys.bultin_modulenames

>>> import sys
>>> sys.builtin_module_names
('_ast', '_bisect', '_codecs', '_codecs_cn', '_codecs_hk', ... 'zlib')
>>> 

需要导入sys模块。这里列举的一般是自带的使用C/C++编译链接的模块

查询函数信息

查看模块下所有函数dir(module_name)

如我们需要列举出math模块下所有的函数名称

>>> dir(math)
['__doc__', '__loader__', '__name__',...]
>>> 

同样需要首先导入该模块

查看模块下特定函数信息help(module_name.func_name)

如查看math下的sin()函数

>>> help(math.sin)
Help on built-in function sin in module math:

sin(...)
    sin(x)
    
    Return the sine of x (measured in radians).

>>> 

查看函数信息的另一种方法print(func_name.__doc__)

如查看内建函数print用法

>>> print(print.__doc__)
print(value, ..., sep=' ', end='\n', file=sys.stdout, flush=False)

Prints the values to a stream, or to sys.stdout by default.
...
>>> 

__doc__前后是两个短下划线,在python中会合并为长下划线

python中的help()类似unix中的man指令,熟悉后会对我们的编程带来很大帮助

相关文章

  • 查看python的模块和函数帮助文档方法

    python的一个优势是有着大量自带和在线的模块(module)资源,可以提供丰富的功能,在使用这些模块的时候,如...

  • 自学Python:os模块使用大全

    OS模块提供了查找目录中所有文件的方法,查看OS模块的帮助文档可以了解详细模块相关函数和使用方法。 import ...

  • 第十五章、文档

    Python文档资源 Python预置的功能数量惊人:内置函数和异常、预先定义的对象属性和方法、标准库模块等。 1...

  • <dir,help,__doc__>查看Python

    dir 函数查看对象的属性 __doc__ 查看对象的某个属性的帮助文档 help 函数查看对象的某个属性的帮助文档

  • python增加模块查找路径

    为Python添加模块加载路径的方法: 方法一:函数添加 1 import sys 2 查看sys.path 3 ...

  • 函数和函数调用

    函数和函数调用: help(函数对象):查看函数帮助文档 abs:函数对象 abs():函数调用 abs():绝对...

  • python的sys.path模块

    见到这种用法 查看文档后知道python只有sys.path方法,它是一个列表,里面记录的是python搜索模块的...

  • Pydoc

    pydoc是python自带的一个文档生成工具,使用pydoc可以很方便的查看类和方法结构,pydoc模块可以从p...

  • python 如何查看模块函数

    适用问题:python 中如何查看模块中的函数。以math模块为例

  • python查看帮助文档几种方法

    help()help函数时Python的一个内置函数函数原型: help([object])可以帮助我们了解该对象...

网友评论

    本文标题:查看python的模块和函数帮助文档方法

    本文链接:https://www.haomeiwen.com/subject/cazkwttx.html