Python 3：文档中的 list.append()答案

【问题标题】：Python 3: list.append() in documentationPython 3：文档中的 list.append()
【发布时间】：2012-09-22 07:32:12
【问题描述】：

您能否建议我在文档中的哪里可以找到有关应用于列表的“附加”方法的任何信息。

我是说

L = [1, 2, 3]

L.append(3)         # The method modifies the list itself and L = L.append(4) is a             mistake.

我可以找到有关数组的内容，但由于未知原因，我未能找到有关列表的内容。

在我的教科书中，我可以读到“附加”会修改列表本身而不返回值。所以，我只是想在文档中找到这些信息，然后 - 学习如何使用手册。

提前谢谢你。

【问题讨论】：

【解决方案1】：

Python 中的所有函数都返回值。 list.append 方法是 None（强调它修改了它的参数 (self)inplace）。

所有列表方法都在the tutorial 中枚举。据我所知，没有更完整的参考资料。

list.append() 的文档字符串指定它返回 None。在 Python shell 中运行 help(list.append)。

【讨论】：

嗯，这正是我在教科书中读到的。但它在文档中的什么位置？我看了教程。但是教程是教程，不是我要找的。span>
那么，我该如何使用文档呢？我应该总是参考教程吗？我是新手，有点吃惊。我怎样才能看到该方法返回 None？我怎样才能看到该方法完全存在。当然，它在序列示例中的某处提到过。但就我所见而言，并没有更多。
@Kifsif，在库参考there 中讨论了序列，但list 的方法没有在此处列举，可能是因为教程已经涵盖了它们。
这是一个非常丑陋的做法，不是吗？
@Kifsif：我也很惊讶。 help(list.append) 表明它返回 None。本教程是 Python 官方文档的一部分。是的，我建议所有 Python 开发人员阅读它。列表在 Python 中无处不在。它可能解释了为什么它们会在教程中介绍

【解决方案2】：

我可以找到关于数组的内容，但由于未知原因我未能找到关于列表。

我也是新手，但据我了解，python 中的 list 与大多数其他语言中的数组等效（但不完全相同），例如 C 中的数组。所以如果你找到数组的答案，你必须把它当作一个列表。

【讨论】：

【解决方案3】：

内置类列表的官方文档有点难找，但确实存在：

如前所述，列表实现了所有常见和可变的序列操作。 “追加”属于可变序列操作。遗憾的是，可变序列操作的文档与教程中解释的内容或多或少相同。所以似乎没有官方文档更详细地解释该方法（尽管我同意无论如何不会有太多细节可以分享）。

【讨论】：