读入Julia文档中的参数描述

Question

与Python文档相比，我发现Julia文档更难阅读。

例如，rand函数：

rand([rng=GLOBAL_RNG], [S], [dims...])

我该怎么解释呢？括号是什么意思？哪些参数是可选的，哪些不是？

另外，在Flux的Dense文档中

Dense(in, out, σ=identity; bias=true, init=glorot_uniform)

为什么有些参数用逗号分隔，另一些参数用分号分隔？

Answer 1

参数是方括号，[]是可选的--这是跨许多编程语言的文档惯例--但这不是语言语法的一部分。因此，rand的所有参数都是可选的，您可以只执行rand。

实际上，尝试在控制台中键入methods(rand)以查看覆盖所有这些用例所需的大量方法是一个好主意：

julia> methods(rand)
# 80 methods for generic function "rand":
[1] rand() in Random at c:\Julia-1.7.2\share\julia\stdlib\v1.7\Random\src\Random.jl:257
.....

分号是用于从Julia函数中的命名参数中分离位置参数的语法的一部分。举个例子，考虑一个函数：

function foo(a, b=4; c, d=8)
   return a+b+c+d
end

比你能做的还要多：

julia> foo(1,c=100)
113