理解 Python 文档:如何知道 returns 函数是什么?

Understanding Python documentation: how to know what a function returns?

我无法理解阅读 Python 文档的背景假设。

示例:importlib.import_module 函数的文档可在 https://docs.python.org/3/library/importlib.html#importlib.import_module 找到。函数文档没有为函数指定 return 值,但它(可能很明显)return 是它刚刚加载的模块。

感觉其实有很多函数没有指定return值。我正在尝试确定以下哪个选项最接近事实。

  1. 这个函数的文档恰好不完整。别那么偏执。
  2. 只要没有指定的 return 值,该函数就被认为是充分自动记录的,您可以计算出来。只需为 return 值指定一个名称:foo = f(bar) 然后 print(foo).
  3. 有一种常规方法可以知道 return 值是什么,我需要学习这种常规方法。

案例 3 显然是我真正担心的一个!

如有任何建议,我们将不胜感激。

documentation for import_lib.import_module() 说的是 returns。

The most important difference is that import_module() returns the specified package or module (e.g. pkg.mod), while _ _import__() returns the top-level package or module (e.g. pkg).

一般来说:文档可能有些地方不完整,如果是,请不要认为这是您一无所知的约定。