弱类型语言的 API 文档，这种情况怎么写？

This topic created in 3688 days ago, the information mentioned may be changed or developed.

因为通常用中括号表示某个参数是可选的：

```
bus.error([eventname],callback)
```

但是又想用用括号表示参数应该是数组的。

```
bus.line([e1,e2,[e3,...]])

```

于是导致混淆，这种情况通常是怎么区分的？

4 replies • 2016-04-29 10:17:58 +08:00

tabris17

Apr 28, 2016

InkStone

Apr 28, 2016

参数是数组你就在下面的参数详解当中注明呀

或者你想表达的意思是可变参数列表? 那就是 foobar(arg1, arg2, arg3...) 或者干脆 foobar(*args)

msg7086

Apr 28, 2016

别用中括号表示可选呗。
别的语言里一般是用默认值来表示可选项的，比如
bus.error(eventname = 'Nothing', callback)
这种。

heliumhgy

Apr 29, 2016 via Android

这叫动态类型吧