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

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

注释块注释内镶注释文档字符串命名约定首要原则描述性:命名样式说明性:命名约定避免使用名称ASCII兼容性软件包和模块名称类名类型变量名异常名称全局变量名函数和变量名函数和方法参数方法名称和实例变量常量继承设计...几十年来,推荐样式是在二元运算符之后使用这会以两种方式损害可读性:运算符趋向于分散在屏幕不同列上,并且,每个运算符都将运算对象移至前一行。...也要避免折叠这么行!...为避免名称与子类冲突,请使用两个前导下划线来调用Python名称处理规则。 Python用类名来修饰这些名称:如果类Foo具有名为 __a 属性,则 Foo .__a 不能访问它。...这将调用Python名称修改算法,其中将类名称修改为属性名称。如果子类无意中包含相同名称属性,这有助于避免属性名称冲突。

1.5K10

python快速入门【四】-----各类函数创建

用于描述函数功能可选文档字符串(docstring)。 构成函数一个或多个有效python语句语句必须具有相同缩进级别(通常为4个空格)。 用于从函数返回值可选return语句。...函数内定义参数和变量在外部不可见。因此,它们具有局部范围。 变量生命周期是变量在存储器中退出时间段。函数内部变量生命周期与函数执行时间一样。 一旦我们从函数返回它们就会被销毁。...即使函数my_func()将x值更改为10,它也不会影响函数外部值。 这是因为函数内部变量x与外部变量x不同函数本地)。尽管它们具有相同名称,但它们是两个具有不同范围不同变量。...时,值“Bruce”被赋值给参数名称,类似地how do you do消息 Python允许使用关键字参数调用函数。当我们以这种方式调用函数时,可以更改参数顺序(位置)。...*Python任意参数 有时,我们事先并不知道将传递给函数参数数量.Python允许我们通过具有任意数量参数函数调用来处理这种情况。 在函数定义中,我们在参数名称使用星号(*)来表示这种参数

49831
您找到你想要的搜索结果了吗?
是的
没有找到

Python|Google Python样式指南(3)

(例如:#pylint:disable=无效名称) 3.3 括号 谨慎使用括号。 在元组周围可以使用括号。千万不要在返回语句条件语句使用它们,除非将括号用于隐含行继续或表示元组。...Raises: 列出与接口有关所有异常. 3.8.4类 类应在描述该类类定义下具有一个文档字符串。如果类具有公共属性,采用与函数Args小节相同格式 。...,则应使用公共变量而不是访问器函数,以避免Python中函数调用额外开销。...如果访问更为复杂,或者访问变量成本很高,则应使用函数调用(遵循命名准则),例如get_foo()和set_foo()。 3.16 命名 函数名称,变量名称和文件名应具有描述性;避开缩写。...如果函数名称,最后一个参数和返回类型组合太长,请在新行中缩进。

81332

一文弄懂Python代码规范

语句条件部分足够,需要跨多行编写时,值得注意是,两个字符关键字(即 if),加上一个空格,再加上一个开括号,会为多行条件后续行创建一个自然4个空格缩进。...如果使用具有不同优先级运算符,请考虑在具有最低优先级运算符周围添加空格。...还要避免折叠这样行!...仅在非公共方法和实例变量中使用一个前导下划线。 为了避免与子类冲突,使用两个前导下划线来调用Python名称混淆规则。...这有助于避免在子类中意外包含具有相同名称属性时发生属性名称冲突。 请注意: 并非所有人都喜欢名称混淆。请努力平衡避免意外名称冲突需求和高级调用潜在使用

22510

代码整洁之道【笔记】

N.添加有意义语境 1.你需要用有良好命名类、函数名称空间来放置名称,给读者提供语境 2.如果没这么做,给名称添加前缀就是最后一招了 O.不要添加没用语境 1.只要短名称足够清楚,就要比名称好...,就还能容忍 E.使用描述性名称 1.沃德原则:“如果每个例程都让你感到深合已意,那就是整洁代码” 2.函数越短小,功能越集中,就越便于取个好名字 3.别害怕名称具有描述性名称,要比短而令人费解名称好...6.变量声明应尽可能靠近其使用位置,在函数顶部出现,循环控制变量总是在循环语句中声明 7.实体变量在类顶部声明 8.相关函数,若某个函数调用了另外一个,就应该把它们放到一起,而且调用者应该尽可能放在被调用者上面...,在不同编程配置、系统配置和负载条件下频繁运行。...,布尔逻辑就难以理解,应该把解释了条件意图函数抽离出来 29.避免否定性条件,尽可能将条件表示为肯定形式 30.函数只该做一件事 31.掩蔽时序耦合,排列函数参数,好让它们被调用次序显而易见 32.

96130

PHP基本规则

这个功能只对特殊安装脚本开放。 A.1.2  缩进 使用4个空格缩进,而不使用制表符TAB。 A.1.3  行最大长度 一行在80个字符以内比较合适,些也可以,最多为120个字符。...函数定义中左小括号与函数名之间无空格。 开始左大括号另起一行。 具有默认值参数应该位于参数列表后面。 函数定义与调用参数之间加入一个空格。 尽量避免函数起始缩进位置与结束缩进位置不同。...下面例子中函数带有3个参数: threeArguments(1, 2, 3); 传值方式在调用时是禁止。...elseif是允许强烈不鼓励使用,最好使用else if组合。 2.switch 在switch结构控制语句中,条件语句圆括号前后都必须有一个单独空格。...若有多个短注释出现于大段代码中,它们应该具有相同缩进。

5.1K50

JavaScript 权威指南第七版(GPT 重译)(二)

接下来,按顺序将参数值分配给函数定义时指定参数名,然后执行函数体。如果函数使用return语句返回一个值,则该值成为调用表达式值。否则,调用表达式值为undefined。...如果两个不同对象具有相同数量属性,具有相同名称和值,则它们仍然不相等。同样,具有相同顺序相同元素两个数组也不相等。...如果字符串在长度或内容上有所不同,则它们不相等。两个字符串可能具有相同含义和相同视觉外观,但仍然使用不同 16 位值序列进行编码。...标签命名空间与变量和函数命名空间不同,因此您可以将相同标识符用作语句标签和变量或函数名称语句标签仅在其适用语句内部定义(当然也包括其子语句)。...在严格模式下,函数声明具有两个或更多具有相同名称参数是语法错误。(在非严格模式下,不会发生错误。) 在严格模式下,不允许使用八进制整数字面量(以 0 开头且后面不跟 x)。

43510

35分钟教你学dart(第二节)

该类型是dynamic,这意味着您可以为它分配具有其他类型其他值。因此,您可以int在打印语句下方分配一个值。...用除法更容易看到。 除法显示 392 除以 50,余数为 42 逻辑运算符 DART使用相同逻辑运算符为其他语言,包括&&了和和||OR。...Functions 函数使您可以将多行相关代码打包到一个主体中。然后调用函数避免在整个 Dart 应用程序中重复这些代码行。...,然后使用参数再次调用它: fruit = 'banana'; print(isBanana(fruit)); // true 调用函数结果完全取决于你传入参数。...使用命名参数,您可以通过提供带有冒号参数名称不同顺序传递参数: print(withinTolerance(min: 1, max: 5, value: 11)); // false 调用函数时,

13K30

实效go编程--1

虽说人们可以适应不同编码风格, 抛弃这种适应过程岂不更好?若所有人都遵循相同编码风格,在这类问题上浪费时间将会更少。 问题就在于如何实现这种设想,而无需冗长语言风格规范。...包导入者可通过包名来引用其内容,因此包中可导出名称可以此来避免冲突。 (请勿使用 import . 记法,它可以简化必须在被测试包外运行测试, 除此之外应尽量避免使用。)...为避免冲突,请不要用这些名称为你方法命名, 除非你明确知道它们签名和意义相同。反之,若你类型实现了方法, 与一个众所周知类型方法拥有相同含义,那就使用相同命名。...case 可通过逗号分隔来列举相同处理条件。...= len(b) 时返回一个非 nil error 错误值。 这是一种常见编码风格,更多示例见错误处理一节。 我们可以采用一种简单方法。来避免为模拟引用参数而传入指针。

1.1K90

数据库查询优化

另外在列上使用包括函数表达式、两边都使用相同表达式、或和一个列(不是常量)比较表达式,都是不可SARG。 并不是每一个不可SARGWHERE子句都注定要全表扫描。...第一个是不可SARG(因为使用函数)将运行得慢些,而第二个是可SARG,将运行得快些。...为了避免不必要延迟,不要用前缀为sp_命名你任何一个存储过程。 13.2 存储过程拥有者要相同: 为了最好性能,同一个存储过程里调用所有对象拥有者都应该相同,DBO更适宜。...如果不是那样,即对象名相同而拥有者不同,那么SQLServer必须执行名称判断。当发生这样情形时,SQLServer不能使用存储过程里在内存里执行计划,相反,它必须重新编译存储过程,从而影响性能。...当从应用程序里调用存储过程时,使用分隔符名称调用也是重要

4.3K20

如何避免自己写代码成为别人眼中一坨屎

二、命名 尽可能使用标准命名方法,比如设计模式,通用学术名词等; 命名要找更有表现力词: 使用更专业词,比如不用get而使用fetch或者download; 避免空泛名字,像tmp; 使用具体名字来细致描述事物...; 别害怕名称具有描述性名称比短而令人费解名称好; 函数名称应该说明副作用,名称应该表达函数,变量或类一切信息,请不要掩盖副作用,比如CreateAndReturnXXX; 三、方法 函数不应该有...100行那么,20行封顶最好: if else while等控制语句其中代码块应该只有一行,也就是一个函数调用语句函数锁进层次不应该多于两层; 一个函数只做一件事,一个函数不应该能抽象出另外一个函数...; 某个公共函数调用私有函数紧随其后; 最理想参数是零参数,最长不要超过三个入参,尽量不要输出参数: 如果函数传入三个及以上参数最好将其抽象为类; 标识参数十分丑陋,向函数传入布尔值用于区分不同业务做法很丑陋...,应该把他们放在一起,而且调用者应该放在被调用者上面; 自上向下展示函数调用依赖顺序; 应该把解释条件意图函数抽离出来,尽可能将条件表达为肯定形式; 不要继承常量,比如接口中定义常量,不要使用继承欺骗编程语言作用范围规则

7222118

Swift基础 基础知识

注意 如果您需要为常量或变量提供与保留Swift关键字相同名称,请在将关键字用作名称时用反勾(`)包围该关键字。但是,除非您完全别无选择,否则请避免使用关键字作为名称。...separator和terminator参数具有默认值,因此您可以在调用函数时省略它们。默认情况下,该函数通过添加换行符来终止其打印行。...通过返回具有两个不同元组,每个值都具有不同类型,该函数提供了有关其结果更有用信息,而不是只能返回单个类型单个值。有关更多信息,请参阅具有多个返回值函数。...每当条件可能为假时,请使用先决条件代码必须是真的才能继续执行。...例如,使用先决条件检查下标没有越界,或检查函数是否传递了有效值。 您可以通过调用precondition(_:_:file:line:)函数编写先决条件

12600

【重构】 代码坏味道总结 Bad Smell (一) (重复代码 | 过长函数 | 过大类 | 过长参数列 | 发散式变化 | 霰弹式修改)

: 使用 Extract Method(提炼函数) 方法提炼出重复代码, 两个函数同时调用这个方法, 代替使用相同表达式; 兄弟子类重复代码 : 一个父类有两个子类, 这两个子类中存在相同表达式..., 然后可以在 同一个对象中 将这个 大型函数 分解为许多 小函数; -- Decompose Conditional(分解条件表达式) : 将 if then else while 等语句条件表达式提炼出来..., 放到独立函数中去;  小函数优点 : 小函数具有更强 解释能力, 共享能力, 选择能力, 小函数维护性比较好, 拥有小函数类活比较长; -- 函数缺点 : 程序越长越难理解; -- 函数开销...现在面向对象语言中, 函数开销基本没有; -- 函数名称 : 小函数多, 看代码时候经常转换上下文查看, 这里我们就需要为函数起一个容易懂名称, 一看函数名就能明白函数作用, 不同在跳转过去理解函数含义..., 也要将其提炼到函数中; -- 条件表达式 : 当 if else 语句, 或者 while 语句条件表达式过长时候, 可以使用Decompose Conditional(分解条件表达式) 方法,

57910

【Python】笔记第六部分:生成器和函数式编程

# 创建: class 可迭代对象名称: def __iter__(self): return 迭代器 # 使用: for 变量名 in 可迭代对象: 语句 背后原理是: 迭代器 =...调用迭代器对象__next__()方法时才执行生成器函数。每次执行到yield语句时返回数据,暂时离开。待下次调用__next__()方法时继续从离开处继续执行。 适用性:优先使用生成器。...多个函数主体相同,核心算法(条件不同时候可以使用函数式编程,分离变化点。这里我们从面向对象角度思考函数式编程应用场景。...“封装”[分]:将变化点封装为多个函数,通过函数类型数据传入实现函数嵌套调用。 “继承”[隔]:使用函数类型参数将当前函数变化隔离。...) return wrapper @ 函数装饰器名称 def 原函数名称(参数): 函数体 原函数(参数) 使用“@函数装饰器名称”修饰原函数,等同于创建与原函数名称相同变量,关联内嵌函数

41420

Python和JavaScript在使用上有什么区别?

我们使用它来定义Python中条件函数、循环和所有的复合语句。 以下是示例: ?...Python和JavaScript中语法非常相似,让我们分析一下它们主要区别: 在 Python 中,我们在关键字 def 后面写上函数名称,并在括号中写上参数列表。...您可以使用函数定义中定义参数更少或更多参数调用函数。缺省参数被赋予未定义值,额外参数可以通过Arguments对象访问。 ?...该列表以self第一个参数开头。 在JavaScript中,构造函数方法被调用,constructor并且它还具有一个参数列表。 ?...Python和JavaScript中方法 在Python中,我们使用def关键字,其名称和括号内参数列表定义方法。此参数列表以参数开头,self以引用正在调用该方法实例。

4.8K20

《Python程序设计》判断题1-240题

(对) 13、在任何时刻相同值在内存中都只保留一份(错) 14、Python不允许使用关键字作为变量名,允许使用内置函数名作为变量名,这会改变函数含义。...(错) 78、使用print()函数无法将信息写入文件。(错) 79、Python集合不支持使用下标访问其中元素。(对) 80、相同内容字符串使用不同编码格式进行编码得到结果并不完全相同。...(对) 105、全局变量会增加不同函数之间隐式耦合度,从而降低代码可读性,因此应尽量避免过多使用全局变量。(对) 106、函数内部定义局部变量当函数调用结束后被自动删除。...(错) 113、调用带有默认值参数函数时,不能为默认值参数传递任何值,必须使用函数定义时设置默认值。(错) 114、创建只包含一个元素元组时,必须在元素后面加一个逗号,例如(3,)。...(对) 203、在调用函数时,可以通过关键参数形式进行传值,从而避免必须记住函数形参顺序麻烦。(对) 204、在调用函数时,必须牢记函数形参顺序才能正确传值。

33.1K1611

MySQL学习笔记-进阶部分

2、leave 语句用于退出循环。类比Javabreak。在SQL中还有return关键字,只用于函数,存储过程是不能使用。...(2)避免代码冗余。把相同功能代码编写到一个存储过程中,这样不仅可以减少冗余代码,还可以使有关应用程序变得更加容易维护。...(3)调用方式不同存储过程一般是作为一个独立部分来执行,自定义函数嵌入在sql中使用,可以在select中调用,就像内置函数一样,比如cos()、sin()。...(4)参数不同自定义函数参数类型类似于IN参数存储过程参数类型有三种:IN参数、OUT参数、INOUT参数in:数据只是从外部传入内部使用(值传递),可以是数值也可以是变量out:只允许过程内部使用...存储过程是用户定义一系列sql语句集合,设计特定表或其它对象任务,用户可以调用存储过程。而函数通常是数据库已定义方法,它接收参数并返回某种类型值并且不涉及特定用户表。

25710

盘点一下 Python 和 JavaScript 主要区别(详细)

向下取整除 尽管大多数算术运算符在Python和JavaScript中工作原理完全相同向下取整除运算符却略有不同。 在Python中,底数分割操作(也称为“整数除法”)用双斜杠(//)表示。...在Python中,我们编写关键字 for,后跟循环变量名称,关键字 in 以及对 range() 函数调用,以指定必要参数。然后,我们编写一个冒号(:),后跟缩进循环体。...语法在Python和JavaScript中非常相似,让我们分析它们主要区别: 在Python中,我们编写关键字 def,后跟函数名称,并在参数列表括号内。...你可以使用函数定义中定义参数更少或更多参数调用函数。默认情况下,为缺少参数分配 undefined 值,并且可以使用 arguments 对象访问其他参数。...这是JavaScript中示例: ? 注意如何使用三个参数调用函数,但是函数定义参数列表中仅包含两个参数。 ?

6.2K30

Python 函数:定义、调用参数、递归和 Lambda 函数详解

创建函数在Python中,使用def关键字定义函数:示例def my_function(): print("Hello from a function")调用函数调用函数,请使用函数名称后跟括号:示例...参数函数名称后面的括号内指定。您可以添加任意数量参数,只需用逗号分隔即可。以下示例具有一个参数(fname)函数。...参数参数?术语参数参数可以用于相同事物:传递给函数信息。从函数角度来看:参数函数定义中括号内列出变量。参数是在调用函数时发送到函数值。...参数数量默认情况下,必须使用正确数量参数调用函数。这意味着,如果函数需要2个参数,您必须使用2个参数调用函数,不能多,也不能少。...语句避免出错。

23620

Mysql 存储过程和存储函数初步认知

2.应用程序调用存储过程只需要通过 CALL 关键字并指定存储过程名称参数即可; 同样,应用程序调用存储函数只需要通过 SELECT 关键字并指定存储函数名称参数即可。...5.存储过程可以调用存储函数函数不能调用存储过程。 二、为什么要用存储过程和存储函数?...三、存储过程和存储函数优点 在实际项目开发过程中,使用存储过程和函数能够为项目开发和维护带来诸多好处,现就存储过程和函数典型优点总结如下: 1.具有良好封装性 存储过程和函数将一系列SQL语句进行封装...注意:名称应当尽量避免选取与 MySQL 内置函数相同名称,否则会发生错误。 2)过程参数 存储过程参数列表。...NOT DETERMINISTIC表示执行当前存储过程后,得出结果数据是不确定,即对于当前存储过程来说,每次输入相同数据时,得出输出结果可能不同

1.3K30
领券