RF字符转义

Robot Framework的测试数据使用反斜杠(\\)作为转义字符, 此外还增加了 built-in variables_${EMPTY} 和 ${SPACE} 经常用来作为转义. 不同的转义策略在下面的小节中详细讨论.

转义特殊字符

反斜杠可以用来转义特殊字符, 这样我们就能使用它们的字面值了.

转义特殊字符

Character	Meaning	Examples
\$	转义美元符号，永远不会启动[标量变量]	\${notvar}
\@	转义@符号，永远不会启动[列表变量]	\@{notvar}
\%	转义百分号，永远不会启动[环境变量]	\%{notvar}
\#	转义#，不会被认为是注释	\# not comment
\=	转义成等号，不会认为是命名参数	not\=named
|	转义‘|’，不会被认为是管道符号	| Run| ps \| grep xxx|
\\	转义反斜杠	c:\\temp, \\${var}

提示

官方文档

译注: 上表第2列, 原文是 Dollar sign, never starts a scalar variable., 感觉直译有些奇怪, 所以这里直接给出这些字符的原来作用是什么, 而后面的例子表示 经过转义后, 这些字符就失去了原来的作用.

转义序列

反斜杠还可以用来创建特殊的转义序列(escape sequence), 这些转义序列所代表的意义很难(甚至不可能) 在测试数据中通过普通字符表示.

转义序列

Sequence	Meaning	Examples
\n	Newline character.	first line\n2nd line
\r	Carriage return character	text\rmore text
\t	Tab character.	text\tmore text
\xhh	Character with hex value hh.	null byte: \x00, ä:\xE4
\uhhhh	Character with hex value hhhh.	snowman: \u2603
\Uhhhhhhhh	Character with hex value hhhhhhhh.	love hotel: \U0001f3e9

注解

在测试数据中的所有字符串, 包括 \x02 这种字符, 都是Unicode. 如果有需要的话, 必须明确地转换. 转换的方法可以使用 BuiltIn_关键字 Convert To Bytes 或 String_库中的 Encode String To Bytes. 或者在Python代码中使用类似于 str(value) 和 value.encode('UTF-8') 的方法.

注解

如果在 \x \u 或 \U 转义符后面跟了非法的十六进制数, 则解析的结果是保留原始的字符, 反斜杠除外. 例如, \xAX (X不是十六进制), \U00110000 (值太大了) 解析的结果分别是 xAX 和 U00110000. 不过, 这种情况可能会在将来有所改变.

注解

如果需要用与操作系统无关的换行符(Windows中是 \r\n, 其它系统是n), 可以使用 Built-in variable_${\n}`.

注解

跟在 \n 后面的未经转义的空格会被忽略. 也就是说, two lines\nhere 和 twolines\n here 是等价的. 这样做的动机是在使用HTML格式时, 能包裹包含换行符的长行, 不过同样的逻辑对其它格式也一样. 该规则的一个特殊情况是在 extended variable syntax_ 中的空白符不会忽略.

注解

\x, \u 和 \U 等转义序列在Robot Framework 2.8.2版本新引入.

避免忽略空单元格

如果需要使用空值, 例如作为关键字的参数, 必须明确地转义以避免被框架 忽略. 不管使用哪种数据格式, 空的收尾单元格必须被转义. 当使用 空格分隔的格式时, 所有的空值都必须被转义.

空的单元格既可以使用反斜杠转义, 也可以使用 内置变量 ${EMPTY}. 特别推荐使用后者, 因为更清楚易懂. 一个特殊情况是在 空格分隔的格式中使用 FOR循环时, 缩进的单元格中应使用反斜杠. 所有这些情况都在下面的例子中进行了说明, 先是HTML格式, 然后是空格分隔的纯文本格式:

Test Case	Action	Argument	Argument	Argument
Using backslash	Do Something	first arg	\
Using ${EMPTY}	Do Something	first arg	${EMPTY}
Non-trailing empty	Do Something		second arg	# No escaping needed in HTML
For loop	:FOR	${var}	IN	@{VALUES}
		Log	${var}	# No escaping needed here either

*** Test Cases ***
Using backslash
  Do Something  first arg  \
Using ${EMPTY}
  Do Something  first arg ${EMPTY}
Non-trailing empty
  Do Something ${EMPTY} second arg  # Escaping needed in space separated format
For loop
 :FOR    ${var}    IN    @{VALUES}
 \ Log ${var} # Escaping needed here too

避免忽略空格

因为领头的, 收尾的, 以及连续的空格在单元格中都将被忽略, 如果这些空格有需要保留的话, 例如作为关键字的参数, 则必须经过转义. 和避免忽略空单元格类似, 既可以使用反斜杠, 也可以使用 内置变量${SPACE}.

Escaping with backslash	Escaping with ${SPACE}	Notes
\ leading space	${SPACE}leading space
trailing space \	trailing space${SPACE}	反斜杠必须跟在空格后面.
\ \	${SPACE}	两边都需要反斜杠.
consecutive \ \ spaces	consecutive${SPACE *3}spaces	使用 扩展变量语法

如上例所示, 使用 ${SPACE} 变量是测试数据更容易理解. 当需要不止一个空格时, 结合 扩展变量语法使用时, 显得尤其方便.