sponsored links

注释 (计算机语言)

计算机语言中,注释是计算机语言的一个重要组成部分,用于解释代码的功用,可以增强程序的可读性,可维护性。

使用

代码描述

算法描述

比如,下面程序将增加一个注释来解释为什么插入排序没有被快速排序所替代,即使理论上前者比后者更慢。这将写为如下:

 list = [f (b), f (b), f (c), f (d), f (a), ...]; // Need a stable sort. Besides, the performance really does not matter. insertion_sort (list); 

资源包含

调试

调试过程中增加注释。

自动文档生成

一些开发工具通过注释来生成文档。
java程序通过javadoc, c/c++等通过doxygen生成文档。

种类与格式

注释可分类为:

  • 风格(行/块)
  • 解释规则(忽略/插入/内存存储)
  • 递归(支持/不支持)

行注释

行注释通过使用换行'\n'字符来指示注释结束,以及使用标记来开始一条注释。例:

符号 语言
C Fortran 77; 'C'必须在一行的第一个字符。
REM BASIC, COMMAND.COM
# bash, Cobra、PerlPythonRuby、Windows PowerShell、PHPMaple
% TeX, Prolog, MATLAB, Erlang, S-Lang、Visual Prolog</references/>
{} Pascal
// ActionScriptC99、C++、C#、Go, Object Pascal (Delphi),JavaJavaScriptPHP
' Visual Basic、VBScript、RealBasic
! Fortran, Basic Plus
; AutoHotkeyAutoitLispScheme, many assemblers
-- EuphoriaHaskellSQLAda、Applescript、EiffelLuaVHDL
* COBOL, many assemblers
|| Curl
" Vim脚本
\ Forth
:: 批处理

块注释

块注释通过定义一个注释开始和一个注释结束标记来使用。在上下文中,空格换行字符不作为区分标志。例:

符号 语言
¢ ~ ¢, # ~ #, co ~ co, comment ~ comment ALGOL 68
/* */ ActionScript, AutoHotkey, C, C++, C#, Go, Java, JavaScript, PHP, PL/I, SQL, Visual Prolog, CSS
/# #/ Cobra
""" """ Python, Ruby
''' ''' Python
=begin =cut Perl
=begin =end Ruby
#<tag> #</tag> S-Lang
{- -} Haskell
(* *) Object Pascal (Delphi),ML, Mathematica, Pascal, Applescript, OCaml, Maple
{ } Object Pascal (Delphi),Pascal
<!-- --> HTMLXML
|# #| Curl
%{ %} MATLAB
#| |# Lisp
--[[ ]] Lua

标签: 计算机语言

计算机语言

计算机语言(computer language)指用于人与计算机之间通讯的语言,是人与计算机之间传递信息的媒介。其概念比通用的编程语言要更广泛。例如,HTML是置标语言,也是计算机语言,但并不是编程语言。

条件注释

... 受支持,无论于标准模式或者兼容性模式之中,但在 Windows 应用商店应用程序中不受支持。 示例 这里是一个演示条件注释如何工作的简单示例。 You are not using Internet Explorer. 句法 ... 版本的更多信息,参见GetProductInfo 函数的 pdwReturnedProductType 参数。 true [if true] 永远等价于 true. false [if false] 永远等价于 false. 可用于创造条件注释 ...

莱比锡注释

... 裁判见解》(德语:Reichs-Strafgesetzbuch: mit besonderer Berücksichtigung der Rechtsprechung des Reichsgerichts),但由于帝国法院位于莱比锡之故,学界惯称为《莱比锡注释书》。 二战结束后,因为「帝国」不复存在,所以《帝国刑法典》去掉「帝国」一词(Reich)改名为《刑法典 ... 写道:出版社 Walter de Gruyter 于1916年5月找上四位编者们(Ludwig Ebermayer ...

明史佛郎机吕宋和兰意大里亚四传注释

... 《明史佛郎机吕宋和兰意大里亚四传注释》,作者张维华,哈佛燕京学社于民国二十三年六月出版。 该书分为四卷:为明史佛朗机、吕宋、和 ... 时确立。作者写作的动机是因为觉得明史对这些史事的记载太过简略及与西方人记载不符,而且我们可以发现这本书的注释部份远较明史本文为多。 作者认为该书能较前人的研究详细正确,有三个原因: 溯源,考据四传所 ...

注释本福尔摩斯探案

... 福尔摩斯探案》(英语:The New Annotated Sherlock Holmes)是一部《福尔摩斯探案》(阿瑟·柯南·道尔原著)的注释书,由Leslie S. Klinger注释编辑,共三卷。该书最初由W. W. Norton出版大开本书套精装版。 卷一与卷二出版于2004年11 ... )于2007年11月5日出版。 这一版的《福尔摩斯探案》被称为是“权威性的”。 相关条目 中文译本 《新注释本福尔摩斯探案全集》(全三卷).刘臻、吴思绮译.同心出 ...

层叠样式表

... ,一种用来为结构化文档(如HTML文档或XML应用)添加样式(字体、间距和颜色等)的计算机语言,由W3C定义和维护。目前最新版本是CSS2.1,为W3C的推荐标准。CSS3现在已被大部分现代浏览器支援,而 ... 同父层的元素B A + B 选择与A相邻的元素B(不能被任何元素相隔) A B 包含选择符 注释 CSS档内也可以包含注释注释放在 /* 和 */ 之间。 例子 例子: p{ font-size: 110%; font-famil ...

PHP

... 开源的通用计算机脚本语言,尤其适用于网络开发并可嵌入HTML中使用。PHP的语法借鉴吸收C语言、Java和Perl等流行计算机语言的特点,易于一般程序员学习。PHP的主要目标是允许网络开发人员快速编写动态页面,但PHP也被用于其他很多 ... 的字符串会出现PHP的标志。PHP版本的不同,标志也会不一样。不过该特性已经在5.5中被移除 注释 ?=PHPE9568F36-D428-11d2-A769-00AA001ACF42 例如维基百科中的PHP彩蛋

对数

... 级数于 得到 并因此 在这里我们在第一行的总和中提出了因数1/10。 对于任何其他底数β,我们使用 。 计算机 多数计算机语言把log(x)用做自然对数,而常用对数典型的指示为log10(x)。参数和返回值典型的是浮点数据类型。 因为参数是浮点数 ... 。 对数表 20世纪的常用对数表的一个实例。 在计算机和计算器被发明之前,使用对数意味着使用对数表,它必须手工建立。 注释 一些数学家反对这种表示法。在他的1985年的自传中,保罗·哈尔莫斯批评了这种表示法,称之为“幼 ...

柯氏复杂性

... 定义 柯氏复杂度可以适用于任何数学概念,但是本文只针对字符串。首先需要确定我们用以描述字符串的语言,它可以基于任何计算机语言,例如LISP、Pascal或Java字节码。如果 P 是一个可以输出字符串 x的程序,则 P 是 x的描述。描述长度 ... s 也可以被长度为 U + log2(n0) + C 的程序描述,所以它的复杂度小于 n0。以上矛盾证明了 假设 (X) 不能成立。 注释 。但是, s 的复杂度 K(s) = n 的情况不一定对于所有 n 存在。例如 ...