首页
学习
活动
专区
工具
TVP
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往

在Python文档中,在函数/方法名后面加上括号是一种惯例吗?

在Python文档中,在函数/方法名后面加上括号是一种惯例。这是因为在Python中,函数和方法都可以被调用执行,而加上括号表示调用该函数或方法。括号内可以传入参数,用于函数或方法的执行。这种惯例的好处是可以清晰地区分函数或方法的定义和调用,使代码更易读和易懂。

在Python文档中,函数/方法名后面加上括号的例子非常常见。例如,在Python内置函数的文档中,函数名后面都会加上括号,如print()len()等。同样,在标准库和第三方库的文档中,函数和方法的调用也会遵循这种惯例。

对于这个问题,腾讯云没有特定的产品或链接地址与之相关。

页面内容是否对你有帮助?
有帮助
没帮助

相关·内容

开源图书《Python完全自学教程》8.2简单的类

类的名称后面紧跟着英文半角状态下的冒号 “ : ”。注意,与定义函数不同,这里没有圆括号8.5节会介绍什么时候用到圆括号。...从注释(2)的逻辑行开始类的代码块,依然用四个空格的缩进表示代码块。 注释(2)的三引号以及后面的配对三引号,这之间关于当前类的帮助文档,不是必须的。...所生成的实例一个对象,或称为“实例对象”,并用变量 zhangsan 引用此对象。 第7章7.3.1节曾借函数说明了对象后面紧跟圆括号的作用,可概括为“名称引用对象,圆括号才是执行”。...注意,后面的圆括号要有参数。...但是要注意参数,类 SuperMan ,每个方法的第一参数 self ,通过实例调用方法的时候,不需要在圆括号为 self 提供对象引用,这是因为 Python 解释器以“隐式传递”的方式向 self

23020

Python下划线的详解

例如,Django文档“转换”章节,你将能看到如下代码: Python 1 2 3 4 5 from django.utils.translation import ugettext as _...正如Python文档中所述: 以下划线“_”为前缀的名称(如_spam)应该被视为API中非公开的部分(不管函数、方法还是数据成员)。...此时,应该将它们看作一种实现细节,修改它们时无需对外部通知。...名称前的双下划线(如:__shahriar) 名称(具体为一个方法名)前双下划线(__)的用法并不是一种惯例,对解释器来说它有特定的意义。Python的这种用法是为了避免与子类定义的名称冲突。...名称前后的双下划线(如:__init__) 这种用法表示Python特殊的方法名。其实,这只是一种惯例,对Python系统来说,这将确保不会与用户自定义的名称冲突。

54940
  • python】59个Python使用技巧,从此你的Python与众不同(二)

    比我文章开始处承诺的5%还多! 12. 包管理 Python世界最棒的地方之一,就是大量的第三程序包。同样,管理这些包也非常容易。...正如Python文档中所述: 以下划线 __ 为前缀的名称(如_pam)应该被视为API中非公开的部分(不管函数、方法还是数据成员)。...此时,应该将它们看作一种实现细节,修改它们时无需对外部通知。...名称前的双下划线(如:__shahriar) 名称(具体为一个方法名)前双下划线 _ 的用法并不是一种惯例,对解释器来说它有特定的意义。Python的这种用法是为了避免与子类定义的名称冲突。...其实,这只是一种惯例,对Python系统来说,这将确保不会与用户自定义的名称冲突。通常,你将会覆写这些方法,并在里面实现你所需要的功能,以便Python调用它们。

    42120

    59个Python使用技巧,从此你的Python与众不同(二)

    比我文章开始处承诺的5%还多! 12. 包管理 Python世界最棒的地方之一,就是大量的第三程序包。同样,管理这些包也非常容易。...正如Python文档中所述: 以下划线 __ 为前缀的名称(如_pam)应该被视为API中非公开的部分(不管函数、方法还是数据成员)。...此时,应该将它们看作一种实现细节,修改它们时无需对外部通知。...名称前的双下划线(如:__shahriar) 名称(具体为一个方法名)前双下划线 _ 的用法并不是一种惯例,对解释器来说它有特定的意义。Python的这种用法是为了避免与子类定义的名称冲突。...其实,这只是一种惯例,对Python系统来说,这将确保不会与用户自定义的名称冲突。通常,你将会覆写这些方法,并在里面实现你所需要的功能,以便Python调用它们。

    47210

    python技巧之下划线

    更多相关信息见““Importing * in Python”。 双下划线前缀的名称(例如__shahriar) 以双下划线做前缀的名称(特别是方法名)并不是一种惯例;它对解释器有特定含义。...前后都带有双下划线的名称(例如__init__) 这些Python的特殊方法名,这仅仅是一种惯例一种确保Python系统的名称不会跟用户自定义的名称发生冲突的方式。...还是不要这样写方法名,只让Python定义的特殊方法名使用这种惯例吧。 5、这些命名有什么不同?... Python 的官方推荐的代码样式,还有一种单下划线结尾的样式,这在解析时并没有特别的含义,但通常用于和 Python 关键词区分开来,比如如果我们需要一个变量叫做 class,但 class ...Python 官方推荐永远不要将这样的命名方式应用于自己的变量或函数,而是按照文档说明来使用。

    14910

    Google实践总结的Python规范,get了吗?

    Python会将圆括号括号和花括号的行隐式的连接起来,可以利用这个特点。如果需要,可以表达式外围增加一堆额外的圆括号。 3 括号 宁缺毋滥得使用括号。...除非用于实现行连接,否则不要在返回语句或条件语句中使用括号。不过元组两遍使用括号可以的。 4 缩进 用四个空格来缩进代码。绝对不要用tab,也不要tab和空格混用。.../usr/bin/python2或者 #!/usr/bin/python3开始。计算机科学,Shebang(也称为 Hashbang )一个由井号和叹号构成的字符序列 #!...8 注释 确保对模块, 函数, 方法和行内注释使用正确的风格。 文档字符串 Python一种独一无二的的注释方式:使用文档字符串。文档字符串包, 模块, 类或函数里的第一个语句。...我们对文档字符串的惯例使用三重双引号。

    68810

    PEP8-Python代码规范样式编写指南摘录

    注释块注释内镶注释文档字符串命名约定首要原则描述性:命名样式说明性:命名约定避免使用的名称ASCII兼容性软件包和模块名称类名类型变量名异常名称全局变量名函数和变量名函数和方法参数方法名称和实例变量常量继承设计...Python标准库保守的,需要将行数限制为79个字符(文档字符串/注释数限制为72个)。 包装长行的首选方法括号,方括号和花括号内使用Python的隐含行连续性。...Donald Knuth在他的 “ *计算机和排版 ” *系列解释了这种惯例规则:“尽管段落的公式总是二元运算和关系之后中断,显示的公式却总是二元运算之前中断” 。...标准库,非默认编码仅应用于测试目的,或者注释或文档字符串需要提及包含非ASCII字符的作者姓名时;否则,使用 \ x, \ u,\ U 或 \ N 转义字符串文字包含非ASCII数据的首选方法...Python,这种样式通常被认为不必要的,因为属性和方法名称以对象为前缀,函数名称以模块名作为前缀。

    1.6K10

    Python 的 “私有”(实现)类

    Python ,尽管没有严格意义上的私有类(private class),但可以通过命名约定和语言特性来模拟实现类似的访问控制。...起初,我决定通过使用它的函数定义实现类来“隐藏”它,但这阻碍了可读性,并且如果多个函数重用同一个类,则无法使用。因此,除了注释和文档字符串之外,是否有一种机制可以将类标记为“私有”或“内部”?...我知道下划线机制,但据我了解,它只适用于变量、函数和方法名称。...Python 没有私有类/方法/函数。至少不是像 Java 等其他语言中的严格隐私。您只能指示/建议隐私。这遵循惯例。将类/函数/方法标记为私有的 Python 约定是在其前面加下划线 ()。...答案 5:惯例在内部类、函数和变量前加上“_”。答案 6:为了解决设计约定问题,正如 chroder 所说,Python 实际上没有“私有”的概念。

    9910

    Google Python风格规范(上)

    Python会将圆括号括号和花括号的行隐式的连接起来,可以利用这个特点。如果需要,可以表达式外围增加一堆额外的圆括号。...3 括号 宁缺毋滥得使用括号。 除非用于实现行连接,否则不要在返回语句或条件语句中使用括号。不过元组两遍使用括号可以的。.../usr/bin/python2或者 #!/usr/bin/python3开始。 注:计算机科学,Shebang(也称为 Hashbang )一个由井号和叹号构成的字符序列 #!...文档字符串 Python一种独一无二的的注释方式:使用文档字符串。 文档字符串包, 模块, 类或函数里的第一个语句。 这些字符串可以通过对象的doc成员被自动提取,并且被pydoc所用。...我们对文档字符串的惯例使用三重双引号‘’‘ ’‘’( PEP-257 )。

    69420

    《简明 Python 教程》学习笔记-函数

    简介 1.函数通过def关键字定义。def关键字后跟一个函数的 标识符 名称,然后跟一对圆括号。圆括号之中可以包括一些变量名,该行以冒号结尾。接下来一块语句,它们函数体。...2.函数不使用任何参数,因此括号没有声明任何变量。参数对于函数而言,只是给函数的输入,以便于我们可以传递不同的值给函数,然后得到相应的结果。...更加准确的说,默认参数值应该是不可变的——这会在后面的章节做详细解释。从现在开始,请记住这一点。 2。...函数的第一个逻辑行的字符串这个函数的 文档字符串 。 注意,DocStrings也适用于模块和类 文档字符串的惯例 文档字符串的惯例一个多行字符串,它的首行以大写字母开始,句号结尾。...第二行空行,从第三行开始详细的描述。  强烈建议 你在你的函数中使用文档字符串时遵循这个惯例

    38110

    基础知识|初入Python语法和注释(三)

    1 Python语法 Python的扩展名.py就像Java语言的扩展名.java一个道理。Python,我们可以直接使用python命令执行.py文件。...例如:python hello.py 。pthon文件,通常来讲,按照国际惯例,要使用编码格式为utf-8。...(除非在行尾) 函数的参数列表,逗号之后要有空格 函数的参数列表,默认值等号两边不要添加空格 左括号之后,右括号之前不要加添加空格 参数列表, 索引或切片的左括号前不应加空格 当'='用于指示关键字参数或默认参数值时...接口被文档化并且主要被用于调用的情况下,可以使用函数的命名风格代替。...2 Python注释 Python中有三种形式的注释:行注释、块注释、文档注释 Java,我们也有行注释、块注释和文档注释,但是Python中使用的符号不一样。

    16010

    Scala基础入门(九)Scala 方法中缀表示法、后缀表示法

    Scala 编程规范,有一些很有意思的规则。合理地使用这些规则,可以帮助我们编写更简洁更有效的代码。 Scala 方法调用 一般来说,Scala的方法调用遵循Java惯例。...换句话说目标方法和点符(.)之间没有任何间隙的,并且最好遵循参数之间用逗号隔开,后面的参数与前面参数后面的逗号应该存在一个空格。...调用target的foo方法示例如下: foo(42, bar) target.foo(42, bar) target.foo() Scala 2.8 版本,开始支持命名参数。...方法调用命名的参数应该作为常规参数处理(相应的间距,以逗号为间隔),等号的两边各有一个空格。...* 中缀表示法 调用只含一个参数的方法 * 语法: 调用法名 方法参数 */ InfixDemo hello "Lily"; } def reply()

    45320

    【简明 Python 教程】学习笔记【函数】 原

    定义函数函数通过def关键字定义。 def关键字后跟一个函数的 标识符 名称,然后跟一对圆括号。圆括号之中可以包括一些变量名,该行以冒号结尾。...接下来一块语句,它们函数体。 函数形参: 函数的参数名称为 形参 而你提供给函数调用的值称为实参 。...DocStrings: 文档字符串的惯例一个多行字符串,它的首行以大写字母开始,句号结尾。第二行空行,从第三行开始详细的描述。 ...强烈建议 你在你的函数中使用文档字符串时遵循这个惯例。 你可以使用__doc__(注意双下划线)调用函数文档字符串属性(属于函数的名称)。...请记住Python把 每一样东西 都作为对象,包括这个函数。我们会在后面的类一章学习更多关于对象的知识。 如果你已经Python中使用过help(),那么你已经看到过DocStings的使用了!

    38310

    Python入门到放弃 | 超简单 跟我学(七)

    这些参数就像变量一样,只不过参数的值调用函数时定义的,函数运行时参数已经被赋值了。 参数函数定义时括号内指定,并用逗号分割,def func_name(para1, para2)。...当调用函数时,用同样的方式提供值。函数定义时括号的参数叫做形参,而调用函数时提供的参数叫实参。...函数定义时给某些形参名后加上赋值操作符 = 与对应形参的默认值,这样就为形参指定了默认值。 注意: 形参的默认值必须常数。更准确的说,默认值不可改变的 —— 这会在后面的章节详细解释。...None Python 一种代表「没有任何东西」特殊的类型。例如:如果一个变量的值 None,则说明这个变量尚未被赋值或值已被清空。...DocStrings 的书写惯例:首行首字母大写,结尾有句号;第二行为空行;第三行以后为详细的描述。我强烈建议在编写任何非平凡函数时都遵守这种惯例,那些只有几行的平凡函数可以不遵守这个惯例

    42140

    Python|Google Python样式指南(3)

    函数或方法,根据需要使用单个空白行,你觉得合适, 就空一行。 3.6 空格 括号,方括号或大括号内不要使用空格....二元操作符两边都加上一个空格, 比如赋值(=)(例外:当存在类型注释时,默认参数值的周围使用空格。), 比较(==, , !...只有被直接执行的文件才有必要加入#!. 3.8 注释和文档字符串 3.8.1文档字符串 对文档字符串的惯例使用三重双引号"""....,则应使用公共变量而不是访问器函数,以避免Python函数调用的额外开销。...3.17 Main Python, pydoc以及单元测试要求模块必须可导入的.代码应该在执行主程序前总是检查 if __name__ == '__main__' , 这样当模块被导入时主程序就不会被执行

    83532

    Python】模块导入 ① ( Python 模块简介 | 模块概念 | 模块作用 | 模块特点 | 常见的 Python 模块 | Python 模块导入 | Python 模块导入语法 )

    一、Python 模块简介 1、模块概念 模块 , 英文名称为 " Module " ; Python 模块 就是一个以 .py 为后缀的 Python 代码文件 , 模块定义有 : 函数 类 变量...模块 Python 自带的 标准库 模块 , 包含了Python中常用的函数和类等代码片段 ; 除了标准库之外,还有大量的第三模块库 模块 ; 常见的 Python 模块 : time 模块 : 提供了与时间有关的函数..., 括号 [] 表示可选内容 ; from 模块名称 可以不写 ,as 别名 也可以不写 ; import [模块 | 类 | 变量 | 函数 | *] 必须写的 ; 2、常用的模块导入组合 常用的模块导入组合...: import 模块名称 : 导入模块的所有内容,包括函数、变量和类等 , 可以直接使用模块的名称来访问它们 ; from 模块名称 import 类/变量/方法名称 : 导入指定模块的指定名称对应的...类 / 变量 / 方法 , 而不是整个模块 , 使用该方法后 , 可以直接使用指定的名称来访问它们 , 而不需要在名称前加上模块名 ; from 模块名称 import 指定类/变量/方法名称 as

    22820

    python3_00.入门

    一种方法,最好只有一种方法来做一件事。 Although that way way not be obvious at first unless you’re Dutch.             .../ python学习资料: https://www.zhihu.com/question/34907211 python文档: http://python.usyiyi.cn/ 深度开源python...不建议使用Tab,因为不同的环境下展现不一样。 5、空行:     顶级定义之间空两行, 比如函数或者类定义. 方法定义, 类定义与第一个方法之间, 都应该空一行....函数或方法, 某些地方要是你觉得合适, 就空一行. 6、空格 : 括号内不要有空格. 不要在逗号, 分号, 冒号前面加空格, 但应该在它们后面加(除了在行尾)....参数列表, 索引或切片的左括号前不应加空格. 二元操作符两边都加上一个空格, 比如赋值(=), 比较(==, , !

    41520

    PEP 8 —Python代码风格指南(一)

    编程的一些惯例,包含Python发布版的一些基础库。...多行条件语句中,左括号加空格再加上两个字符关键字的组合的形式会为多行条件的后续行创建一个自然的4空格缩进。...Python的List数据结构,右面的(closing brace/opening brace)花括号/方括号/圆括号可以列表的最后一行的第一个非空格字符之下排列,如下: my_list = [...换行长行的首选方法使用括号括号和大括号内的Python隐含行延续。通过将表达式包含在括号,可以多行上分割长行。这些应优先于使用反斜杠进行行连续使用。 有时,反斜杠可能仍然适用。...使用ASCII(Python 2)或UTF-8(Python 3)的文件不应该具有编码声明。 标准库,非默认编码应仅用于测试,注释或者评论和文档中用以提及作者的名字。

    1.1K90

    Python精讲 | 超好用的f-string和Python3.12的新增特性

    视频版: 什么f-string? 它是python3.6版本中新增的一种字符串格式化方法。语法字符串的引号前加上字母f,然后字符串通过大括号嵌入其他数值。...f'字字字{嵌入数值}字字字' 它相比于之前的%格式化和字符串format方法写起来更简洁,比如嵌入一个变量: 或者一个计算式: 甚至引用模块和调用函数: 基本上来说,就是你可以字符串里面写python...并且这里不仅可以是一个变量,也可以是一个计算式 以上 f-string 的一些常用功能,关于更多的格式化参数可以查阅Python官方文档,有中文版,里面都写得很清楚,并且还给出了例子。...虽然我也不知道这样有什么用: 过去f-string大括号的代码里不支持反斜杠转义字符,新版本也可以了: 说到转义,你知道f-string里要怎么表示大括号字符?...就是用两个大括号: 在过去的版本,如果你定义的f-string单行字符串,那么大括号里面得表达式也必须写在一行内。

    40210

    Google 出品 Python 编码规范,强烈推荐!

    Python会将 圆括号, 括号和花括号的行隐式的连接起来 , 你可以利用这个特点..../usr/bin/python2或者 #!/usr/bin/python3开始. (译者注: 计算机科学, Shebang (也称为Hashbang)一个由井号和叹号构成的字符串行(#!)...因此只有被直接执行的文件才有必要加入 注释 确保对模块, 函数, 方法和行内注释使用正确的风格 文档字符串 Python一种独一无二的的注释方式: 使用文档字符串....我们对文档字符串的惯例使用三重双引号”“”( PEP-257 ). 一个文档字符串应该这样组织: 首先是一行以句号, 问号或惊叹号结尾的概述(或者该文档字符串单纯只有一行). 接着一个空行....Python, pydoc以及单元测试要求模块必须可导入的.

    34810
    领券