精华内容
下载资源
问答
  • python怎么加注释

    2019-10-18 01:06:56
    python怎么注释?... 任何编程语言都少不了注释,Python也不例外,以下是Python注释的具体用法: 1. 单行注释 Python编程语言的单行注释常以#开头,单行注释可以作为单独的一行放在被注...

    v2-4811dc31ba1285f92207ffe5f2ddbdbd_b.jpg

    python怎么加注释?

    任何编程语言都少不了注释,Python也不例外,以下是Python注释的具体用法:


    1. 单行注释

    Python编程语言的单行注释常以#开头,单行注释可以作为单独的一行放在被注释代码行之上,也可以放在语句或者表达式之后。

    实例:

    1

    2

    # -*- coding: UTF-8 -*-
    print ("hello world!"); #您好,世界

    2. 多行注释

    Python中多行注释使用三个单引号(’’’)或者三个双引号(”””)来标记,而实际上这是多行字符串的书写方式,并不是Python本身提倡的多行注释方法。

    实例:

    1

    2

    3

    4

    5

    '''
    这是多行注释,使用单引号。
    这是多行注释,使用单引号。
    '''
    """这是多行注释,使用双引号。这是多行注释,使用双引号。"""

    3. 编码注释

    在进行Python开发时,需进行编码声明,如采用UTF-8编码,需在源码上方进行 # -*- coding: UTF-8 -*- 声明,从Python3开始,Python默认使用UTF-8编码,所以Python3.x的源文件不需要特殊声明UTF-8编码。

    4. 平台注释

    如果需要使Python程序运行在Windows平台上,需在Python文件的上方加上 #!/usr/bin/python 注释说明。

    Python注释除了可以起到说明文档的作用外,还可以进行代码的调试,将一部分代码注释掉,对剩余的代码进行排查,从而找出问题所在,进行代码的完善!

    以上就是python怎么加注释的详细内容。

    如果大家如果在学习中遇到困难,想找一个Python学习交流环境,可以加入我们的Python学习圈,点击我加入吧,会节约很多时间,减少很多遇到的难题。

    展开全文
  • Python注释

    千次阅读 2016-07-11 13:24:21
    Python注释单行注释 Python单行注释以“#”开头,后连接注释内容。规范的注释其实应该在“#”符之后接一个空格符,再接注释内容。# 这是注释文本:打印Hello, python! print("Hello, python!")多行注释 Python的...

    Python注释

    单行注释

     Python单行注释以“#”开头,后连接注释内容。规范的注释其实应该在“#”符之后接一个空格符,再接注释内容。

    # 这是注释文本:打印Hello, python!
    print("Hello, python!")

    多行注释

     Python的多行注释借助字符串的表示方式。用三个单引号或者三个双引号标记。关于以下展示的自定义函数会在Python函数一节中讲到。

    """
    多行注释方式一:定义一个嵌套列表
    """
    items = [
        "studentNo",
        ["20101060074", "20101060224"]
    ]
    
    '''
    多行注释方式二:这是自定义函数print_list的简单说明:用于打印列表嵌套的列表元素
                    其中自定义函数中使用了BIF:str(num)将数字转换成字符串,用于拼接
    '''
    
    
    def print_list(list_arg, lev):
        # 使用str(num)将数字转换成字符串,用于拼接
        print("第" + str(lev) + "层")
        for ele_2list in list_arg:
            if isinstance(ele_2list, list):
                print_list(ele_2list, lev+1)
            else:
                print(ele_2list)
    # 调用自定义函数
    print_list(items, 1)

     自定义函数打印嵌套列表结果如下:

    第1层
    studentNo
    第2层
    20101060074
    20101060224

    展开全文
  • ISTE-Python-注意事项 Python注释
  • python注释也有自己的规范,在文章中会介绍到。注释可以起到一个备注的作用,团队合作的时候,个人编写的代码经常会被多人调用,为了让别人能更容易理解代码的通途,使用注释是非常有效的。一、python单行注释符号(#...

    Python 中的注释有多种,有单行注释,多行注释,批量注释,中文注释也是常用的。python注释也有自己的规范,在文章中会介绍到。注释可以起到一个备注的作用,团队合作的时候,个人编写的代码经常会被多人调用,为了让别人能更容易理解代码的通途,使用注释是非常有效的。

    一、python单行注释符号(#)

    井号(#)常被用作单行注释符号,在代码中使用#时,它右边的任何数据都会被忽略,当做是注释。
    print 1 #输出1

    #号右边的内容在执行的时候是不会被输出的。

    二、批量、多行注释符号

    在python中也会有注释有很多行的时候,这种情况下就需要批量多行注释符了。多行注释是用三引号包含的,例如:
    这里写图片描述

    可能有的人会说这不是和多行字符串混淆了吗,但是我看到的许多程序员也是这么用的,使用时候注意区分下就好。

    三、python中文注释方法

    在python编写代码的时候,避免不了会出现或是用到中文,这时候你需要在文件开头加上中文注释。如果开头不声明保存编码的格式是什么,那么它会默认使用ASKII码保存文件,这时如果你的代码中有中文就会出错了,即使你的中文是包含在注释里面的。所以加上中文注释很重要。

    #coding=utf-8
    或者:
    #coding=gbk

    提示:以上两种都可以代表中文注释,我看过的更多人使用urf-8这种的比较多。

    展开全文
  • Python 函数注释

    万次阅读 多人点赞 2017-07-03 19:30:18
    Python 3.x 中,增加了一个新特性 - 函数注释(Function Annotations),顾名思义,可做为函数额外的注释来用。 函数注释是一个可选功能,它允许在函数参数和返回值中添加任意的元数据。无论是 Python 本身还是...

    简述

    在 Python 3.x 中,增加了一个新特性 - 函数注释(Function Annotations),顾名思义,可做为函数额外的注释来用。

    函数注释是一个可选功能,它允许在函数参数和返回值中添加任意的元数据。无论是 Python 本身还是标准库,都使用了函数注释,第三方项目可以很方便的使用函数注释来进行文档编写、类型检查、或者是其他用途。

    | 版权声明:一去、二三里,未经博主允许不得转载。

    为何要引入函数注释?

    在 Python 2.x 中,由于缺少对函数参数和返回值进行注释的标准方法,所以很多工具和库为了填补这一空白,使用了不同的方式:

    • 自定义 decorator
    • 自定义 docstring 格式
    • 向函数对象添加自定义属性

    显然,由于机制和语法的广泛差异,这会在一定程度上引起混乱。

    为了解决这个问题,Python 3.x 引入了函数注释(详见:PEP-3107),旨在提供了一种单一的、标准的方法,来将元数据与函数参数和返回值相关联。

    注意: 注释是完全可选的。

    函数注释语法

    函数注释包括:

    • 参数注释:以冒号(:)标记
    • 返回值注释:以 -> 标记

    语法结构大体如下:

    def foo(a: expression, b: expression = 5) -> expression:
        ...

    在伪语法中,参数看起来像:identifier [: expression] [= expression]。也就是说,参数注释总在其默认值之前。当函数定义被执行时,所有的注释表达式都被求值,就像默认值一样。

    参数列表后面可以跟一个 -> 和一个 Python 表达式。与参数的注释一样,在执行函数定义时,将对该表达式求值。

    单个注释

    函数注释可以包含类型、帮助字符串,以及其他更多信息。

    来看一个例子,有一个函数 sum(),接受三个参数 a、b、c,并返回它们的和。

    >>> def sum(a, b: int, c: 'The default value is 5' = 5) -> float:
    ...     return a + b + c
    ... 
    >>> 

    其中,第一个参数 a 没有注释,第二个参数 b 带有类型为 int 的注释,第三个参数 c 带有一个帮助字符串注释并且拥有默认值,返回值用类型 float 来注释。

    调用 sum() 两次,一次使用 int,一次使用字符串:

    >>> sum(1, 2)
    8
    >>> 
    >>> sum('Hello', ', ', 'Python!')
    'Hello, Python!'

    显然,注释对函数的执行没有任何影响。在这两种情况下,sum() 都做了正确的事情,只不过注释被忽略了而已。

    访问函数注释

    函数对象有一个名为 __annotations__ 的属性,它是一个映射(dict),用于将每个参数名(key)映射到其相关的注释(value)。

    注意: 映射中有一个特殊的 key,叫做“return”,仅当为函数的返回值提供注释时,才会显示该 key。

    回到上述示例,并检查它的注释:

    >>> type(sum.__annotations__)
    <class 'dict'>
    >>>
    >>> sum.__annotations__
    {'c': 'The default value is 5', 'return': <class 'float'>, 'b': <class 'int'>}

    之所以选择 “return”,是因为它不会与任何参数名冲突。“return”是 Python 中的一个关键字,任何使用“return”作为参数名的尝试都会引发 SyntaxError。

    多个注释

    倘若,函数注释中要同时包含类型和帮助字符串,怎么办?很容易,可以使用具有两个 key(例如:type 和 help)的 dict:

    >>> def div(a: dict(type=float, help='the dividend'),
    ...         b: dict(type=float, help='the divisor (must be different than 0)')
    ...     ) -> dict(type=float, help='the result of dividing a by b'):
    ...     """Divide a by b"""
    ...     return a / b
    ... 
    >>> 

    调用 div():

    >>> div.__annotations__
    {'a': {'type': <class 'float'>, 'help': 'the dividend'}, 'return': {'type': <class 'float'>, 'help': 'the result of dividing a by b'}, 'b': {'type': <class 'float'>, 'help': 'the divisor (must be different than 0)'}}
    >>>
    >>> div(5, 2)
    2.5

    注意: 如果要包含更多的注释(示例中是 2 个),可以在 dict 中包含更多的 key:value 对。

    动态注释

    __annotations__ 是函数的一个属性,类型为 dict。由于 dict 是可变的,这意味着,可以在程序运行时动态地修改注释。

    假设,想知道是否使用了参数的默认值,或者想把所有的返回值都加起来。

    >>> def sum(a, b) -> 0:
    ...     result = a + b
    ...     sum.__annotations__['return'] += result
    ...     return result
    ... 
    >>> sum.__annotations__['return']
    0
    >>> 
    >>> sum(1, 2)
    3
    >>> sum.__annotations__['return']
    3
    >>> 
    >>> sum(3, 4)
    7
    >>> sum.__annotations__['return']
    10

    PS: 动态注释可以在函数内部完成,也可以由装饰器完成。

    展开全文
  • python 注释注释When writing code in Python, it’s important to make sure that your code can be easily understood by others. Giving variables obvious names, defining explicit functions, and ...
  • python中文注释

    2020-05-22 21:43:55
    python中文注释 如题。 在python中添加中文注释,需要在文件开头加上code:utf-8 #!/usr/bin/python # -*- coding: utf-8 -*- 否则报错。
  • 主要给大家介绍了关于Python注释(多行注释和单行注释)用法的相关资料,文中通过示例代码介绍的非常详细,对大家学习或者使用Python具有一定的参考学习价值,需要的朋友们下面来一起学习学习吧
  • My_Python python注释和代码
  • python 中文注释

    万次阅读 2017-12-21 10:18:42
    python 默认中文注释会报错,解决方案如下 python 中文注释# encoding=utf-8print('hello python') # 这是第一个程序
  • python-注释和取消注释多行程序

    万次阅读 多人点赞 2018-09-13 15:56:21
    在程序中,有时候想把多行程序注释掉,一行一行的注释比较麻烦,那么可以多行注释吗,可以,有如下几种方法: 1.选中要注释的段落,按下ctrl+/,效果如下: 再按一下ctrl+/,取消注释 2.将一整段用三个双引号...
  • python开头注释

    千次阅读 2019-04-24 00:22:25
    转自 是紫伦呀:... #!/usr/bin/env python # -*- coding:utf-8 -*- # Author:XXX .../usr/bin/env python 与 .../usr/bin/python 的区别 ...这些注释并不仅仅是写给读者看的注释...
  • Python多行注释/取消注释快捷键

    万次阅读 2019-07-22 10:48:25
    step1:选中需要注释/取消注释的所有代码 step2:按快捷键 系统 快捷键 Mac command + / Windows Ctrl + /
  • Python多行注释

    万次阅读 2011-03-29 17:30:00
    Python多行注释
  • PythonPython多行注释方法

    千次阅读 2013-10-05 09:41:08
    print 'Python多行注释' ''' Python注释行1 Python注释行2 Python注释行3 ''' 相比VB没有多行注释,我喜欢Python这点~~
  • Python注释

    千次阅读 2017-05-06 14:59:46
    Python注释
  • 详解Python3注释知识点

    2021-01-01 09:08:26
    Python3 注释 确保对模块, 函数, 方法和行内注释使用正确的风格 Python中的注释有单行注释和多行注释Python中单行注释以 # 开头,例如:: # 这是一个注释 print(Hello, World!) 多行注释用三个单引号 ”’ ...
  • python注释

    千次阅读 2016-06-11 19:27:55
    任何一门编程语言都有其...python注释有好几种,包括:单行注释、多行注释、以及批量注释。 一、 python的单行注释 #常被用作单行注释符号,在代码中使用#时,它右边的任何数据都会被忽略,当做是注释。 print "he
  • Python注释 关于Python和/或一般编程概念的个人笔记。
  • Python3 注释

    2018-02-21 12:49:41
    确保对模块, 函数, 方法和行内注释使用正确的风格Python中的注释有单行注释和多行注释Python中单行注释以 # 开头,例如:# 这是一个注释 print("Hello, World!") 多行注释用三个单引号'''或者三个双引号"""将注释...
  • python 多行注释

    2013-12-18 12:11:22
    最近看了点Python资料,挺有意思的,写代码的时候突然发现Python注释只有针对于单行的注释(用#),上网找了一下相关资料,发现好多人也都在讨论Python多行注释的问题,里面介绍的也都是关于单行的注释,要想多行...
  • 主要介绍了Python代码注释规范代码实例解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
  • Python多行注释快捷键

    万次阅读 2019-04-09 11:35:34
    在编写Python程代码时,有时需要将部分代码注释掉,而如果我们一行一行的进行注释,显然是非常麻烦,不够方便。那么我们想要把多行代码程序快速注释掉,有没有什么快捷键可以实现多行注释吗? 《Python快乐编程》...
  • Python多行注释技巧

    千次阅读 2016-04-16 09:22:04
    Python多行注释技巧
  • python 中文注释报错

    千次阅读 2018-02-24 14:09:06
    python 中文注释报错中文注释报错解决# -*- coding: utf-8 -*-#coding=utf-8在代码开始的地方添加,必须在前两行,加载其他地方无效
  • Python注释(多行注释和单行注释)的用法实例发布时间:2020-09-30 23:18:32来源:脚本之家阅读:97前言学会向程序中添加必要的注释,也是很重要的。注释不仅可以用来解释程序某些部分的作用和功能(用自然语言...
  • python代码注释文档

    千次阅读 2017-10-20 14:34:23
    python的文档注释有以下几点要注意: - 类||属性||方法的文档注释的位置均在下方,即和java正相反; - 注释符号用 """xxx """ 比如:def candlestick2_ohlc(ax, opens, highs, lows, closes, width=4,
  • python注释

    千次阅读 多人点赞 2021-01-18 23:12:59
    python注释 1.注释一行 在该行前#,代码变灰 #print(m) 2.注释多行。用引号(三个单引号)括起来 '''for dimension in dimensions: print(dimension) dimensions = (10,30,60) for dimension in dimensions: ...
  • python多行注释

    千次阅读 2021-04-20 14:15:21
    代码选中的条件下,同时按住 Ctrl+/,被选中行被注释,再次按下Ctrl+/,注释被取消 注:Rstudio中多行注释是Ctrl+Shift+c

空空如也

空空如也

1 2 3 4 5 ... 20
收藏数 267,963
精华内容 107,185
关键字:

python加注释

python 订阅