低级程序员才喜欢写注释!
作者 | Tameem Iftikhar
译者 | 平川
策划 | Tina

注释不同于《辛德勒的名单》。它们不是“纯善的”。事实上,注释充其量是一种必要的恶。——Robert C.Martin
// 匹配电子邮件地址的正则表达式var re = /^(([^<>()\[\]\\.,;:\s@"]+(\.[^<>()\[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/;return re.test(String(email).toLowerCase());// 注意:添加一个富于表现力的函数名,注释就变得没有必要了function validateEmail(email) {var re = /^(([^<>()\[\]\\.,;:\s@"]+(\.[^<>()\[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/;return re.test(String(email).toLowerCase());}for x in range(1, 500):# 这是运行多个并行测试时预防死锁的最好方法time.sleep(0.5)runTest(x)
"""许多 Qt 函数都不是线程安全的。如果你使用回调函数,即使你在所有绘制调用代码的周围都加上锁,你也会遇到段错误,因为 Qt 的主事件循环仍在运行,并且使用了没加锁的资源。"""from multiprocessing.pool import ThreadPoolimport sysfrom threading import Lockimport timefrom PyQt5 import QtCore, QtWidgetsclass Task(QtCore.QObject):updated = QtCore.pyqtSignal(int, int)..............................
/*** 与该容器相关的集群*/protected Cluster cluster = null;/*** 人类可读的容器名*/protected String name = null;/*** 该容器的父容器*/protected Container parent = null;/*** 创建一个 Loader 配置父类加载器*/protected ClassLoader parentClassLoader = null;
def load_config():try:do_useful_stuff()except Exception as ex:# 如有异常,退回到默认状态。
-----------------------------# Exhibit A# 默认构造函数def get_todays_date():return date.today()-----------------------------# Exhibit B# 返回月份的天# @return: 月份的天def get_day_of_month()return day_of_month
class ComplexNumber:"""这是一个用于复数的数学运算类。属性:real (int):复数的实部。imag (int):复数的虚部。"""def __init__(self, real, imag):"""ComplexNumber 类的构造函数。参数:real (int):复数的实部。imag (int):复数的虚部。"""def add(self, num):"""该函数用于复数求和。参数:num (ComplexNumber):要加的复数。返回值:ComplexNumber:包含和的复数。"""re = self.real + num.realim = self.imag + num.imagreturn ComplexNumber(re, im)help(ComplexNumber) # 访问类的 docstringhelp(ComplexNumber.add) # 访问方法的 docstring
# 检查日期是否是过去的日期def check_date(date):if date < today:return truereturn falsedef is_past_date(date):if date < today:return truereturn false
/*这段代码糟透了。我知道,你知道,每个人都知道。我们假装什么都没发生,然后继续前进。以后你叫我白痴好了。*/
有道无术,术可成;有术无道,止于术
欢迎大家关注Java之道公众号
好文章,我在看❤️
评论
