知识卡片

操作参考卡 · 6333.d

注释与字符串内容要区分

理解等级:中级

代码语法上下文中的#可开始行注释,供人解释意图,不作为执行语句;但字符串里的同一字符仍可属于数据。保存源码时需保留真实语句和必要说明,不能把所有带#的文本一律删除。

三引号内容仍是字符串表达式;在模块/类/函数等规定位置可作文档字符串,不因包住代码就变成真正注释。用它临时屏蔽代码还可能遇到内部三引号或转义问题,应区分注释语法与文本数据。

docstring在模块/类/函数等规定位置可作为文档元数据保存,不等同#注释;普通三引号文本不在任何位置都会自动成为文档字符串。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 3 处

    • · 查看原书依据

      #符号之后的文本。注释可以自成一行,也可以放置在代码行的右边。#符号后的文本直接作为供人阅读的注释而忽略,并且不会看做是语句的语法的一部分。如果你要复制这些代码,也可以忽略掉注释。在本书中,我们通常使用一种不同的格式体例来让注释更加容易识别,但是,在代码中,它们是作为正常文本显示的。 此外,现在不要关注这个文件中的代码的语法;我们随后将学习其所有的语法。要注

    • · 查看原书依据

      当作注释一样的字符串常量(在本书的后面会介绍更多细节)。这并非只能使用三重引号的文本块,但是它们往往是可以用作多行注释的。 最后,三重引号字符串经常在开发过程中作为一种恐怖的黑客风格的方法去废除一些代码(好吧,这并不恐怖,并且它实际上是一种常规的惯例)。如果希望让一些行的代码不工作,之后再次运行代码,可以简单地在这几行前、后加入三重引号,就像这样。 有些黑客

    • · 查看原书依据

      运行时保留下来以便查看。文档字符串只是出现在程序文件和一些语句顶端的字符串中。Python会忽略这些内容,但是,在运行时会自动将其附加在对象上,而且能由文档工具显示。文档字符串是Python更大型的文件策略的一部分,本书这一部分最后一章会讨论它。 就像你所见到的,Python没有变量类型声明。单就这一点而言,就让你拥有比以前用过的更为简单的语言语法。但是,对

    参考来源

    - 位置:《Python学习手册(原书第4版)》第3章《第一段脚本》(spine475;extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part0446.html;u069-ch03-007)。 - 结论依据:原文在“#符号之后的文本”附近的定义、例子或代码支撑本卡核心说明:代码语法上下文中的#可开始行注释,供人解释意图,不作为执行语句;但字符串里的同一字符仍可属于数据。边界按已读前提解释;示例未执行。 - 原始内容:#符号之后的文本。注释可以自成一行,也可以放置在代码行的右边。#符号后的文本直接作为供人阅读的注释而忽略,并且不会看做是语句的语法的一部分。如果你要复制这些代码,也可以忽略掉注释。在本书中,我们通常使用一种不同的格式体例来让注释更加容易识别,但是,在代码中,它们是作为正常文本显示的。 此外,现在不要关注这个文件中的代码的语法;我们随后将学习其所有的语法。要注 - 位置:《Python学习手册(原书第4版)》第7章《三重引号编写多行字符串块》(spine557;extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part0528.html;u173-ch03-007)。 - 结论依据:三引号内容仍是字符串表达式;在模块/类/函数等规定位置可作文档字符串,不因包住代码就变成真正注释。用它临时屏蔽代码还可能遇到内部三引号或转义问题,应区分注释语法与文本数据。 - 原始内容:当作注释一样的字符串常量(在本书的后面会介绍更多细节)。这并非只能使用三重引号的文本块,但是它们往往是可以用作多行注释的。 最后,三重引号字符串经常在开发过程中作为一种恐怖的黑客风格的方法去废除一些代码(好吧,这并不恐怖,并且它实际上是一种常规的惯例)。如果希望让一些行的代码不工作,之后再次运行代码,可以简单地在这几行前、后加入三重引号,就像这样。 有些黑客 - 位置:《Python学习手册(原书第4版)》第12章《Python语法规则》(spine646;extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part0617.html;u286-ch03-007)。 - 结论依据:docstring在模块/类/函数等规定位置可作为文档元数据保存,不等同#注释;普通三引号文本不在任何位置都会自动成为文档字符串。 - 原始内容:运行时保留下来以便查看。文档字符串只是出现在程序文件和一些语句顶端的字符串中。Python会忽略这些内容,但是,在运行时会自动将其附加在对象上,而且能由文档工具显示。文档字符串是Python更大型的文件策略的一部分,本书这一部分最后一章会讨论它。 就像你所见到的,Python没有变量类型声明。单就这一点而言,就让你拥有比以前用过的更为简单的语言语法。但是,对