批处理之家 - Powered by Discuz! Board

标题: [原创] [批处理命令一日一教学续]（45）注释语句：rem和:: [打印本页]

作者: Hello123World 时间: 2011-8-29 16:15 标题: [批处理命令一日一教学续]（45）注释语句：rem和::

【原】[一日一教学]批处理系列帖子索引 http://bbs.bathome.net/thread-2576-1-1.html
【续】[一日一教学]批处理系列帖子索引 http://bbs.bathome.net/thread-13798-1-1.html

帮助信息：

在批处理文件或 CONFIG.SYS 里加上注解或说明。

REM [comment]
复制代码

命令概括：
rem，全英文remark（不确定），意为：注释。
comment，全英文comment，意为：评论、意见；这里可引申为注释。

参数详解：
程序员代码编写规范的三点之一：
1.代码层次分明，善用tab加以缩进。
2.尽量做到让变量名、标签名、函数名“见名知意”！
3.适当的注释。

批处理虽然只是脚本，但脚本也是语言，也有作为脚本语言的尊严，所以rem可以有、::也可以有。

rem和::用处一样，也可以看成是一物两名，就像毛润之、石三伢子同指本朝太祖爷一样。

rem有什么用呢？
有道词典给出了rem的解释：指定由DOS忽略的命令行。
这解释算是贴切，其实所有的编程语言的注释语句都是这样，将注释后的语句忽略，使之无效化。

不加rem前。
例如：

@echo off
echo 你好，这套教程你觉得怎样呢？
pause>nul
复制代码

效果：

你好，这套教程你觉得怎样呢？
复制代码

加上rem后。
例如：

@echo off
rem echo 你好，这套教程你觉得怎样呢？
pause>nul
复制代码

@echo off
:: echo 你好，这套教程你觉得怎样呢？
pause>nul
复制代码

效果都是：
[attach]4367[/attach]

echo message 被忽略、无效化了。

扩展阅读：
1.为什么要注释？
注释不仅有利于别人读懂你的程序，也有利于日后的自己读懂你的程序。
这其中的道理你也可以反证，编程的规范化是所有程序员默默遵守的准则，若然没有其可取之处，那么他们为什么遵守呢？所有的程序设计语言为什么都有注释语句呢？

2.在什么地方注释？
在for之类的复合语句中对语句注释；
在for之类的复合语句之前对整个复合语句注释；
在源程序开始处，对整个程序注释——说明程序的功能；

总原则：如果不注释，理解起来就会很困难，或者虽无困难，但浪费时间；

3.批处理中的特殊“注释符”。
标签注释。
例如：

@echo off
: echo 你好，这套教程你觉得怎样呢？
pause>nul
复制代码

变量注释。
例如：

@echo off
%echo 你好，这套教程你觉得怎样呢？%
pause>nul
复制代码

3.多行注释。
例如：

@echo off
rem a^
b^
c
pause>nul
复制代码

作者: 601997526 时间: 2011-8-29 16:54

可惜P里没有多行注释的命令
现想到的多行注释只有

@echo off
rem a^
b^
c
pause>nul
复制代码

作者: guaiwu 时间: 2011-8-29 17:35

试了一下貌似

@echo off
rem a^
b^
c
pause>nul
复制代码

中的rem能注释一样，而第二行的b^又是起到注释的作用

作者: xudaweb 时间: 2011-8-30 07:13

回复 2# 601997526

这个多行注释命令，能否解释下，不太懂啊~

作者: Hello123World 时间: 2011-8-30 10:02

回复 4# xudaweb

^转义了回车换行符，命令一般以回车换行符作为结束符。
例如：

@echo off
echo a^
b^
c
pause>nul
复制代码

效果：
输出 abc

不过这个原理我就有点不明白了：

@echo off
echo a^

b^

c
pause>nul
复制代码

效果：
输出
a
b
c

猜测：莫非空行后的回车换行就不要转义了？但测试这个猜测也是有问题的。

例如：

@echo off
echo a^


b^


c
pause>nul
复制代码

效果：

a

'b' 不是内部或外部命令，也不是可运行的程序
或批处理文件。
'c' 不是内部或外部命令，也不是可运行的程序
或批处理文件。
复制代码

作者: dennis1314 时间: 2011-8-30 14:40

只能引申到最近的一个换行符，第二个换行就相当于另一语句了。是不是可以这样解释

作者: vsbat 时间: 2011-8-30 14:45

rem == REMARK

作者: CrLf 时间: 2011-8-30 16:14

还是有区别的，rem 就是表示当前行为注释的命令，而 :: 本质上是无效标签，而标签若存在于语块内极易致错，所以相比而言，rem 的兼容性更强。
不过我是比较喜欢用 :: 的，简单明了。

作者: Hello123World 时间: 2011-8-30 18:38

回复 8# CrLf

:: 本质上是无效标签?我一直以为是注释符，（跟@具备将后面的语句括起的功能一样）只是没有官方的帮助而已。

作者: xudaweb 时间: 2011-8-30 18:50

回复 5# Hello123World

多谢版主的细心回答，不管怎么样先记下这种语法了。
就是不知道什么时候能用上这样的语句，感觉不适用啊...

作者: JooKin 时间: 2011-9-18 14:38

本帖最后由 JooKin 于 2011-9-18 14:40 编辑

回复 5# Hello123World

这里有解释：

可能我没有说清楚....
原来没加^的话,hello后面有回车和换行两个字符(\r\n ...
abcdshenji 发表于 2011-8-15 22:51

[/quote]

@echo off
echo a^

^
b^

^
c
pause>nul
复制代码

结果：

a
b
c
复制代码

作者: Hello123World 时间: 2011-9-18 15:17

回复 11# JooKin

你研究的够透彻，但是我还是不明白其中的原理。
究竟这回车、换行符在这个代码中有多少个？
回车=n次？
换行=m次？

@echo off
echo a^/r/n
/n
^/r/n
b^/r/n
/n
^/r/n
c
pause>nul
复制代码

作者: JooKin 时间: 2011-9-18 20:30

本帖最后由 JooKin 于 2011-9-18 20:37 编辑

回复 12# Hello123World

可能是abcdshenji笔误，windows系统里正确的应该是换行符在前，回车符在后，即\n\r。unix系统里只有换行符\n。所以应该是：

@echo off\n\r
echo a^\n\r
\n\r
^\n\r
b^\n\r
\n\r
^\n\r
c\n\r
pause>nul
复制代码

当第一次^后，转义了换行符，只有回车符起作用，所以接上第3行的\n\r，此时是占据一行的，如果没有碰到第4行的^，结果将是：

a\n\r
\n\r               //这里是第4行的\n\r
复制代码

这个效果就是：

a
复制代码

也就是说，执行完第4行的\n\r的时候是打一个空行，等到执行到第5行b^\n\r的时候，因为前面有了第4行末尾的\n\r，所以cmd就会认为新的命令开始了，这跟cmd以换行回车为一条命令的结束标志是相符的。所以

'b' 不是内部或外部命令，也不是可运行的程序
或批处理文件。
复制代码

就解释的通了，因为b当然不是什么命令。如果第4行加了^，就跟前面的：

@echo off
echo a^

b^

c
pause>nul
复制代码

同一个道理了，因为加了^之后第4行就没有换行符了，所以就接上第5行的b^\n\r，此时还是占据一行，所以结果就是：

a^\n\r                        //这里是第3行的\n\r
b^\n\r                       //这里原来是第4行，现在第5行的b^\n\r接上去了
复制代码

所以效果就是：

a
b
复制代码

首先你要明白的就是换行符负责把字符串向下移一行，回车符负责把开始打印的位置放到字符串的开头

作者: Hello123World 时间: 2011-9-19 18:37

回复 13# JooKin

你说的其它的都对，比如以/n/r（换行回车）结尾，/n（换行）在前
例如：

@echo off
echo a^
b
pause>nul
复制代码

结果是

ab
复制代码

这点有力的证明^确实转义的是换行符。

受益很多，感谢你的回复。我还是不能理解，按你说的

cmd以换行回车为一条命令的结束标志是相符的

那么

@echo off\n\r
echo a^\n\r
\n\r
^\n\r
b^\n\r
\n\r
^\n\r
c\n\r
pause>nul
复制代码

这里为什么没有在第3行就结束，第3行不是有个换行回车吗？

作者: JooKin 时间: 2011-9-19 20:36

本帖最后由 JooKin 于 2011-9-19 20:43 编辑

回复 14# Hello123World

不是的，执行完第3行（严格来说应该是第2行，因为^的存在原来的第3行已经接上第2行的末尾成为一行了）已经结束了。看下面的两个例子就明白了：

::例1
@echo off
echo Hey,Hello123World!


pause
复制代码

结果：

Hey,Hello123World!
请按任意键继续. . .
复制代码

::例2
@echo off
echo Hey,Hello123World!^


pause
复制代码

结果：

Hey,Hello123World!

请按任意键继续. . .
复制代码

第2个例子只是在第2行末尾加了个^，为什么结果会多一个空行？因为加了^后，第3行的\n\r接上了第2行的末尾，跟第2行成为1行了，此时的第3行的位置已经是原来第4行的\n\r了。这个时候执行完第2行，因为末尾有原来的第三行的\n\r，所以到此就结束了。接下来就轮到执行第3行的内容了，并且是另起一行（这个应该不用解释了，因为上一行有\n存在），但是因为第3行只有\n\r（原来第4行的\n\r）了，没有任何命令，所以造成的结果就是执行第4行的pause的时候又另起一行了，很明显是因为第3行的\n的缘故，所有整个结果跟第1个例子相比就是中间多出了\n\r（原来第4行的\n\r）,即空行。

还有就是连续的多个\n\r只有一个起作用,再结合前面两个例子看：

@echo off
echo Hey,Hello123World!^


















pause
复制代码

作者: cjiabing 时间: 2011-9-20 18:10

转义符^在行末时，只有最近的一行起作用

echo;^
 &call :Colour 
复制代码

作者: smbee 时间: 2012-2-28 03:45

关于行末转义符的个人猜想
　　看了楼主的教程，对于多行注释又学到了一招，以前只知道利用goto来进行多行注释。呵呵，感谢楼主为知识传播所付出的辛劳！
　　此后看了各位朋友们对行末转义符的工作原理探讨，我也同楼主一样对行末转义符后连续空两行便不再工作感到困惑，另Jookin兄所说的行末是换行回车做为结束符号是不对的。因为我用16进制编辑器打开任一Windows中的文本类型文件（txt,cmd,vbs……）均看到行结束符号是0D 0A，即回车换行！
　　受此启发，我将以下代码的输出重定向到一文本文件中后用UE打开查看其16进制时发现了一个有趣的现象。

@echo off
echo 1st:
echo a^
b
echo.
echo.
echo.
echo 2nd:
echo a^

b
echo.
echo.
echo  3rd:
echo a^


b
echo.
echo.
echo.
echo 4th:
echo a^

^

b
复制代码

代码中之所以要增加若干空行是为了在16进制模式下各情况的输出结果能对齐，下面给出输出结果及在UE中打开查看其16进制的图片。

请大家注意看其16进制模式。
　　情况1：a与b首尾相接。从结果看第3行的转义符将其后的回车换行符“删除”了。b后面的第一对回车换行是输出时正常产生的，后面的三对则是三条echo.产生的。
　　情况2：a的后面是0A，所以输出结果表现为a,b各占一行。这就是说第9行的转义符将原来总共2对即4个（0D 0A 0D 0A）回车换行符“删除”了前三个。b后面的三对回车换行符解释同情况1。最后的空格（20）是我特意在“3rd”的前面加上的，以便三种情况对齐后分析。
　　情况3：a的后面同样是0A，至于后面的4对回车换行符则是正常输出及第19、20、21行产生的。第17为空不会产生任何输出，第18行执行出错，也不会在此文件中产生输出。是不是也同情况2一样第15行的转义符将其后的4个回车换行符“删除”了三个，只留下最后一个呢？

　　至此，我得出这样一个猜想：行末转义符将其后的回车换行符整体转义形成一个新的“转义”符，这个新的“转义”符对其后的回车符进行“转义”时将其“转义”为空（不是ASCII码为0的那个空，而是什么都没有的空。通俗地讲就是把回车符吃了，然后消失在人海。），或者说对其后的一对回车换行符“转义”为换行符（0A），而其它字符则原样输出。
　　情况4验证了我的猜想。a后面的两个换行符（0A）分别由23、25行的转义符产生。
　　以上猜想纯属个人见解，不对之处还请大家指正。

作者: CrLf 时间: 2012-2-28 04:04

回复 17# smbee

cmd 换行时只认 0A，碰到 0D 0A 时将剔除此处的 0D，其实整个脚本中即使只有 0A 换行符也是一样能执行的。因此在分析的时候，不妨把 0D 0A 的组合视为单独的一个 0A，或许会有新的解释？

作者: smbee 时间: 2012-2-28 09:30

回复 18# CrLf

我同意将回车换行当成一个字符看待，这和我们的实际操作也是相符的，即每行结束转入下一行只需按一次回车键。你说“整个脚本中即使只有0A换行符也一样能执行”，我的理解是脚本源代码中即使行末只有0A，脚本也能正常工作。不知是不是这个意思？为此，我在UE中写了两句代码：

@echo off
echo 只认0A
复制代码

然后将第一行后的0D删除，保存后运行提示出错：
'ho' 不是内部或外部命令，也不是可运行的程序
或批处理文件。
出错倒在我的意料之中，但命令怎么变成了'ho'，这却让人伤神了。
删除0D后的脚本在UE和记事本中效果如图：

删除0D后的脚本：

敬请验证。

作者: smbee 时间: 2012-2-28 11:07

对不起，CrLf，我错了！在将echo后的文字改为全ASCII字符后，脚本确实能正常运行。出现上面的错误大概是编码的问题吧。

作者: qzwqzw 时间: 2012-3-7 22:53

回复 CrLf
:: 本质上是无效标签?我一直以为是注释符，（跟@具备将后面的语句括起的功能一样）只 ...
Hello123World 发表于 2011-8-30 18:38

:: 本质上是无法被goto到的空标签
因为：作为标签的Delims
使标签的Token变成空值
而goto的语法检查是不允许有“空标签”的
因此它可以被用作注视用途

详细讨论见这里
http://www.cn-dos.net/forum/view ... ghlight=&page=2

作者: xxxx20 时间: 2012-12-25 00:22

嗯，不错，比较严格

作者: shelluserwlb 时间: 2014-11-6 14:07

本帖最后由 shelluserwlb 于 2014-11-6 14:21 编辑

多行注释示例1：
@echo off
goto start
释注内容
释注内容
释注内容
......
:start

多行注释示例2：
@echo off
rem ^
释注内容^
释注内容^
释注内容^
........^
释注内容

注：第2种方法注释内容最后一行最末尾没有转义字符^。
这里的转义字符可以简单地理解为将下一行和本行连接起来形成一个语句；
每行注释语句之间不能有超过一行的空行，否则就需要在空行中另加^才行。
例如：
@echo off
rem ^
释注内容^
释注内容^

释注内容^

^

释注内容
echo 这是一个测试
pause

作者: Cathon 时间: 2015-2-11 16:42

我今天刚发现注释不能放在ECHO后面，否则注释无效。
ECHO的下一行是‘）’时，括号的后面也不能加注释，否则闪退。
（我是新手）

作者: Cathon 时间: 2015-2-11 16:48

回复 24# Cathon

奥，在ECHO的本行后面加注释要用个&符。（新手）

作者: MCRGZN 时间: 2015-8-14 00:06

不错不错不错不错不错

欢迎光临批处理之家 (http://bbs.bathome.net/)