西门子SCL基础教学---注释/多语言注释/组织源代码

今天写一下关于注释和组织源代码的一些东西

注释，有很多种，“//”的行注释，还有“(*...*)”的段注释，还有一个“(/*...*/)”多语言注释。

行注释

比如：

IF #in              //如果“in”为真

THEN           

   #out := 1;    //“out”输出

END_IF;

行注释不光可以放在语句后面，也可以注释掉语句。

比如：

IF #in

THEN

    #out := 1;

   // #out2 := 1;

END_IF;

此时，“out2:=1”就是一个行注释。假设你不需要，又不想删除这行，那么就把这行注释掉，如果发现后期这行又需要用到，那么删除“//”即可生效。

段注释

比如：

(*

2023.9.9

版本创建

版本号：V1.0

*)

IF #in

THEN

    #out := 1;

END_IF;

可以写一些对于这个库版本开发，或者这个库功能的一些定义。方便后期维护人员进行维护。

多语言注释
假设你在开发一个库版本或者写一个注释，可能后期程序会给与国外人员，那么多语言注释就可以用上。因为他会自动根据语言来显示文本。比如：(/*简单的启动命令。*/)IF #startTHEN    #out := 1;END_IF;然后当你将项目语言切换到英语的时候，就会变成：
(/*start command*/)IF #startTHEN    #out := 1;END_IF;所以这个多语言注释具备自动翻译的功能。说一下如何实现：

博途项目树上找到语言和资源，打开之后点击项目语言，然后添加一个英语（美国）


点击你正在编辑的块，此块内必须要有多语言注释。


找到这个块的属性，点击文本。这时候你能在中文下看到中文，但是英文下显示的是没有的。



在英语（美国）处写入翻译



然后这时候，点击右边，任务，将语言切换到英语，就可以看到注释已经从中文改成英文了。

组织源代码

这个语句，其实就是代码的折叠和展开。假设，你这个FB有很多东西，你写了很多的功能，那么你的代码将会从上到下，洋洋洒洒一大片。极度不方便阅读。

这时候，就需要用这个语句：

REGION _NAME_

.......

END_REGION

你可以在这个语句中间写程序，然后给这个语句写一个简单明了的意思。

比如：

REGION 这就是个简单的启动，还停不了的那种

    IF #start

    THEN

        #out := 1;

    END_IF;

END_REGION

这时候在你的程序书写区左边就会出现一个“这就是个简单的启动，还停不了的那种”，这时候你就可以将代码折叠，方便别的代码的阅读。如下图


多用这个语句，可以极大的提升你的程序阅读性。也非常方便程序的调试等等。
自动格式化所选文本

首先，在这说明一下，没有冒犯强迫症患者和非强迫症患者。
有时候，你程序写的多了，修修改改，导致程序参差不齐，看上去的观感会不舒服。如下图



可能会引起强迫症患者的不舒服。一个个调整，又非常麻烦，还得扣间距。那么这时候就需要用到这个“自动格式化所选文本”，它将一步到位，把你的程序语句全部对的整整齐齐。

首先，全选你的程序段，然后点击红框内的按钮。



点击之后如下图：



是不是舒服多了。

其实我也喜欢这么舒服的看，谁不想舒服呢。是吧。