Python中[,some_par]含义咨询：解析文档可选参数标记及str.center示例

嘿，这个标记我刚接触Python的时候也琢磨了好久！其实它是文档里用来表示可选参数的标准写法：

• 方括号[]包裹的部分是可选的，也就是说这个参数你可以不传，函数/方法会自动使用它的默认值来运行
• 不在方括号里的参数是必填项，调用的时候必须传入对应的值

拿你提到的str.center(width[, fillchar])举例子：

• width是必填参数，你必须指定要把字符串居中到多少宽度
• fillchar是可选参数，如果不传，默认会用空格来填充；如果需要其他字符（比如*），你再传这个参数就行，比如"hello".center(10, "*")就会返回"**hello***"

再举个常见的例子，print()函数的文档写法是print(*objects, sep=' ', end='\n', file=sys.stdout, flush=False)，这里sep、end这些参数都属于可选的，平时我们直接用print("hi")就是用了它们的默认值，要是需要自定义分隔符或者结尾字符，才会特意传这些参数。

这种写法其实是很多编程语言文档的通用惯例，不止Python用，目的就是用简洁的方式区分必填和可选参数~

内容的提问来源于stack exchange，提问作者Shay Lempert