低级程序员才喜欢写注释!
作者 | 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 ThreadPool
import sys
from threading import Lock
import time
from PyQt5 import QtCore, QtWidgets
class 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.real
im = self.imag + num.imag
return ComplexNumber(re, im)
help(ComplexNumber) # 访问类的 docstring
help(ComplexNumber.add) # 访问方法的 docstring
# 检查日期是否是过去的日期
def check_date(date):
if date < today:
return true
return false
def is_past_date(date):
if date < today:
return true
return false
/*
这段代码糟透了。我知道,你知道,每个人都知道。
我们假装什么都没发生,然后继续前进。以后你叫我白痴好了。
*/
有道无术,术可成;有术无道,止于术
欢迎大家关注Java之道公众号
好文章,我在看❤️
评论