1.2.3 帮助资源

关于Python的权威文档可在Python网站在线获得。然而,在许多情况下,你可以通过其他方式更快地找到所需的答案,例如询问朋友、搜索网页或访问Stack Overflow网站。

假设你想计算2的平方根。输入2**0.5并按<Return>。这可以完成任务,但Python会显示小数点后16位数字,而你只需要3位。你认为Python中可能有一个名为round的圆整函数,但你不确定如何使用它或它是如何工作的。在命令提示符下输入help(round),可以直接获得Python的帮助。你会看到这确实是你正在寻找的函数:

round(2**0.5, 3)

上述语句给出了期望的结果。

在Spyder中,获取帮助还有其他方法。在命令提示符下输入round,但不要按<Return>,而是按下<Cmd-I><Ctrl-I>I表示information一词)。原本使用help命令在IPython控制台中显示的信息,现在显示在了“帮助”选项卡中,并且格式更易于导航和阅读,特别是对于较长的信息。你也可以使用“帮助”选项卡,而不在命令提示符处输入任何内容:尝试在窗格顶部的“对象”字段中输入pow。“帮助”选项卡提供了**(求数的幂)的替代方法的信息。

在IPython中,你还可以在任何Python对象(包括函数和变量名)的名称后面或前面加一个问号以获得帮助:round??round提供的信息与help(round)几乎相同,但输入起来更容易。

当你输入help(...)时,如果Python识别出括号中的名称,它将打印出表达式的有关信息。遗憾的是,如果你不知道所需命令的名称,Python就不那么友好了。也许你认为应该有一种不使用幂求一个数的平方根的方法。毕竟,这是一个相当基本的操作。输入help(sqrt),看看当Python无法识别你请求的名称时会发生什么。

要了解当前可用的命令,可以使用Python的dir()命令。dir是directory一词的缩写,它会返回当前会话期间(或上次使用%reset命令以来)创建或导入的所有模块、函数和变量名的列表。可以使用Python的help(dir)了解更多的帮助信息。dir()的输出中貌似没有平方根方面的内容,但有一项是__builtins__。这是Python第一次启动时识别的所有函数和其他对象的集合。这是Python寻找函数或变量的“撒手锏”[13]。若要查看内置函数的列表,请输入:


[13] 附录F解释了Python如何搜索变量和其他对象。

dir(__builtins__)

然而并没有显示sqrt或类似的函数。事实上,sincosexp等标准的数学函数都没有出现!

此时此刻,Python也无法给你提供进一步的帮助。现在,你必须求助于外部资源。比较好的选择有Python书籍、搜索引擎、熟悉Python的朋友等。

在开始阶段,为了编码,你的大部分时间都将花在使用搜索引擎上。

我们要找的sqrt函数属于一个库。稍后,我们将讨论如何访问Python没有自动提供的实用函数库。

习题1A

在继续学习之前,请尝试在网上搜索“如何在Python中求平方根”。