SCL : (*...*)：插入注释段
对程序代码添加注释
行注释：行注释以“//”开头，直到行尾。
注释段：注释段以“(*”开始，到“*)”结束。该注释可跨多个行。
多语言注释：多语言注释是指可翻译为其它项目语言的注释。多语言注释是一个以“(*”开始，以“*)”结束的单元。即，只能对整个注释进行标记或选择，而不能选择其中一部分。多语言注释不能相互嵌套，但在注释行和注释段中使用。所不同的是，在多语言注释中不能使用注释行或简单的注释段。这是因为，系统会将“(/*”与“*/)”之间的所有内容均解释为常规文本消息。
要插入注释段，请按以下步骤操作：
在要插入注释的位置输入“(*”。该位置可以不在行首。 输入注释文本。 输入“*)”结束注释。 |
此外，也可以后期再将现有程序代码转换为注释段：
<ol>
选择待转换为注释段的程序代码。
右键单击所选择的程序代码。
<li>
在快捷菜单中，在“包围方式”(Surround with) 中选择条目“(* *)”。或者，可在“简单指令 > 程序控制”(Simple instruction > Program control) 窗格的的“指令”(Instructions) 任务卡中，选择指令“(* *)”。
</li></ol>
要插入多语言注释，请按以下步骤操作：
在待插入多语言注释的位置处，输入“(/*”。该位置可以不在行首。 编辑器将自动插入注释末尾“*/)”。 输入注释文本。 |
要通过注释来禁用程序代码，请按以下步骤操作：
<ol>
选择要注释掉的代码行。
<li>
在编辑器中单击“将所选行处理为注释”(Comments out the selected lines) 按钮。
将“//”插入到所选行的开头。该符号后面的代码将解释为注释。如果要禁用包含有行注释的那些行，那么也只需插入“//”。如果要再次启用这些行，只需保留原有的注释即可。如果所选行仅包含多语言注释，则此行不会处理为注释，并且不会将“//”插入到所选行的开头。但是，如果多语言注释后存在代码，则该行从代码处开始作为注释。此时，“//”恰好插入代码前。
</li></ol>
要启用已被注释掉但仍可以再次启用为代码的行，请按以下步骤操作：
选择要启用的代码行。 在编辑器中单击“删除注释”(Remove comment) 按钮。 删除行首的行注释标记“//”。 |
示例
以下代码显示了各种不同注释类型的具体应用：
(************************************************************************************* 在此可以放置指令后面的描述信息 **************************************************************************************) IF "MyVal1" > 0 THEN //不能被 0 除 "MyReal" := "MyVal2" (* 输入值 *)/"MyVal1" (* 测得值 *); END_IF; (/*数据类型转换*/) //"MyInt" := REAL_TO_INT("MyReal2"); "MyInt" := REAL_TO_INT("MyReal"); |
可以使用块注释对全部代码块加以说明。例如，可以指出块的用途或提醒用户注意某些特性。可以为打开的块和已关闭的块输入块注释。
说明
块注释不能超过 32767 个 Unicode 字符。
下一主题
