从PEP8样式指南中:
PEP 257描述了良好的文档字符串约定。请注意,最重要的是,结束多行文档字符串的“”应单独位于一行上,例如:
"""Return a foobang
Optional plotz says to frobnicate the bizbaz first.
“”“对于一个衬里文档字符串,可以将结束的“”“保持在同一行。
PEP 257建议即使在单行文档字符串中也使用三引号:
- 即使字符串适合一行,也使用三引号。这使得以后扩展它很容易。
请注意,甚至Python标准库本身也没有始终遵循这些建议。例如,
- abcoll.py
- ftplib.py
- functools.py
- inspect.py
欢迎分享,转载请注明来源:内存溢出
评论列表(0条)