如何閱讀Python中的典型函數文檔？

Question

為什么

class multiprocessing.Pool([processes[,initializer[,initargs[,maxtasksperchild]]]]) 

包括所有這些]]]] ？

我不明白如何閱讀這個結構？

Answer 1

通常，在文檔中，[ something ]被讀作“ something是可選的”。 在這種特殊情況下，它也意味着依賴，應該像這樣讀：

• processes是可選的，但如果您使用它，您還可以使用：
• initializer ，這是可選的，但如果你使用它，你也可以使用：
• initargs ，這是可選的，但......等等

Answer 2

“括在方括號（[]）中的短語表示零次或一次出現（換句話說，所附短語是可選的）”

請參見http://docs.python.org/2/reference/introduction.html#notation

[processes[,initializer[,initargs[,maxtasksperchild]]]]表示initializer是可選的，但如果使用initializer還必須使用processes等。 這就是嵌入式括號的含義。

如果您沒有命名參數，可以在以下任何示例中使用（但沒有其他組合！）：

Pool() 
Pool(processes) 
Pool(processes, initializer) 
Pool(processes, initializer, initargs) 
Pool(processes, initializer, initargs, maxtasksperchild) 

否則，如果您為參數名稱命名，則可以選擇使用其中的任何參數。 構造函數具有以下默認值：

Pool(processes=None, initializer=None, initargs=(), maxtasksperchild=None)

請參閱構造函數的源代碼（ https://bitbucket.org/pypy/pypy/src/9d88b4875d6e/lib-python/2.7/multiprocessing/pool.py ）

有關關鍵字參數的更多信息，請閱讀以下內容： http ： //docs.python.org/3/tutorial/controlflow.html#keyword-arguments

Answer 3

[]的使用表示所附參數是可選的，可以省略。