注释

  标注解释,目的是帮助读者理解的文本
  也就是说,注释首先是文本,其二是说明,其三是思路,其四是例子

注释有两种形式

1. # ... 单行注释

用于对某句语句或语句块进行解释
放在语句块的头行或一个语句的尾部

def see_seq(iterable):
 
  # 序列开始的下标为 0,也就是索引为 0
  # 序列第一个元素的下标是0,也就是第n个元素的下标为 len(iterable) - 1
 
  # for 循环自动处理索引、索引边界
  # 自动依次取出 0 到 len(iterable)-1 索引对应的值
  # 是不是很简洁?
  for item in iterable:
    print(item)
 
  # 打印分隔符
  print("等价for语句".center(20, "-"))
  # for 循环的原理是
  # 1. 把序列变成一个迭代器,然后保存在一个内部临时变量中 temp_var = iter(iterable)
  # 2. 通过内置函数next()调用迭代器中的 __next__方法获取下一个数据 item = next(temp_var)
  # 3. 到了边界,迭代器会触发一个迭代器耗尽异常,for循环会自动捕获,终止for循环<br>
  # 等价语句
  temp_var = iter(iterable) # 把序列变成一个迭代器
  while True:
    try:
      item = next(temp_var) # next()调用迭代器
    except StopIteration: # 迭代器耗尽异常,推出循环
      break
 
    # 以上是for循环自动完成,这一行才是循环体
    print(item)
 
 
if __name__ == "__main__":
  # 初始列表
  nums = [17, 71, 93, 69, 79, 14, 33, 7, 64, 58, 77, 75, 98, 61, 39, 50, 1, 69, 60, 20]
  names = ["北门吹雪", "小一", "王五", "李四", "张三", "王二"]
 
  # 调用函数,通过索引方式遍历序列
  see_seq(nums)
  see_seq(names)

2. """ ... """ 多行注释,官方名: 文档字符串 docstring

用于解释模块、类、函数的作用与方法
放在模块、类、函数体的第一行语句

"""
对循环本质的刨析
"""
 
 
class Person(object):
  """人的类"""
   
  def __init__(self, name, age):
    self._name = name
    self.__age = age
 
  @property
  def name(self):
    """获取人的名字"""
    return self._name
 
 
def see_seq(iterable):
  """对比for循环,利用while循环说明for循环的本质"""
 
  for item in iterable:
    print(item)
 
  print("等价for语句".center(20, "-"))
 
  temp_var = iter(iterable)
  while True:
    try:
      item = next(temp_var)
    except StopIteration:
      break
 
    print(item)
 
 
if __name__ == "__main__":
  """测试逻辑,以入口文件则 __name__ 改写为 __main__"""
 
  nums = [17, 71, 93, 69, 79, 14, 33, 7, 64, 58, 77, 75, 98, 61, 39, 50, 1, 69, 60, 20]
  names = ["北门吹雪", "小一", "王五", "李四", "张三", "王二"]
 
  see_seq(nums)
  see_seq(names)

注释,并不会被python解释器解释,会被静静的忽略,也就是说注释后不能有语句逻辑

以上就是python两种注释用法示例的详细内容,更多关于python 注释的资料请关注其它相关文章!

华山资源网 Design By www.eoogi.com
广告合作:本站广告合作请联系QQ:858582 申请时备注:广告合作(否则不回)
免责声明:本站资源来自互联网收集,仅供用于学习和交流,请遵循相关法律法规,本站一切资源不代表本站立场,如有侵权、后门、不妥请联系本站删除!
华山资源网 Design By www.eoogi.com