字面量 ↑

字面量创建可以在程序中使用的对象。字面量包括

布尔值和空值字面量 ↑

nil 和 false 都是假值。nil 有时用来表示“没有值”或“未知”，但在条件表达式中求值为 false。

true 是一个真值。除了 nil 和 false 之外的所有对象在条件表达式中都求值为真值。

数值字面量 ↑

整数字面量 ↑

您可以按如下方式编写任意大小的整数

1234
1_234

这些数字的值相同，即 1,234。下划线可以用来增强人类的可读性。您可以将下划线放置在数字中的任何位置。

您可以使用特殊前缀以十进制、十六进制、八进制或二进制格式编写数字。对于十进制数字，使用 0d 前缀，对于十六进制数字，使用 0x 前缀，对于八进制数字，使用 0 或 0o 前缀，对于二进制数字，使用 0b 前缀。数字的字母部分不区分大小写。

示例

0d170
0D170

0xaa
0xAa
0xAA
0Xaa
0XAa
0XaA

0252
0o252
0O252

0b10101010
0B10101010

所有这些数字都具有相同的十进制值，即 170。与整数和浮点数一样，您可以使用下划线来提高可读性。

浮点数字面量 ↑

浮点数可以按如下方式编写

12.34
1234e-2
1.234E1

这些数字的值相同，即 12.34。您也可以在浮点数中使用下划线。

有理数字面量 ↑

您可以使用特殊后缀 'r' 编写一个 Rational 字面量。

示例

1r       # => (1/1)
2/3r     # => (2/3)   # With denominator.
-1r      # => (-1/1)  # With signs.
-2/3r    # => (-2/3)
2/-3r    # => (-2/3)
-2/-3r   # => (2/3)
+1/+3r   # => (1/3)
1.2r     # => (6/5)   # With fractional part.
1_1/2_1r # => (11/21) # With embedded underscores.
2/4r     # => (1/2)   # Automatically reduced.

语法

<rational-literal> = <numerator> [ '/' <denominator> ] 'r'
<numerator> = [ <sign> ] <digits> [ <fractional-part> ]
<fractional-part> = '.' <digits>
<denominator> = [ sign ] <digits>
<sign> = '-' | '+'
<digits> = <digit> { <digit> | '_' <digit> }
<digit> = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9'

请注意，这被解析为浮点数分子 1.2 除以有理数分母 3r，结果为浮点数

1.2/3r  # => 0.39999999999999997

复数字面量 ↑

您可以按如下方式编写一个 Complex 数字（后缀为 i）

1i          #=> (0+1i)
1i * 1i     #=> (-1+0i)

有理数也可以是虚数。

12.3ri      #=> (0+(123/10)*i)

i 必须放在 r 之后；不允许反过来。

12.3ir      #=> Syntax error

字符串 ↑

转义序列 ↑

某些字符可以在双引号字符串、字符字面量、here 文档字面量（非引号、双引号和带反引号）、双引号符号、Hash 字面量中的双引号符号键、Regexp 字面量和几个百分比字面量（%、%Q、%W、%I、%r、%x）中表示为转义序列。

它们允许诸如 \n 表示换行符、\t 表示制表符等的转义序列。支持的转义序列的完整列表如下

\a             bell, ASCII 07h (BEL)
\b             backspace, ASCII 08h (BS)
\t             horizontal tab, ASCII 09h (TAB)
\n             newline (line feed), ASCII 0Ah (LF)
\v             vertical tab, ASCII 0Bh (VT)
\f             form feed, ASCII 0Ch (FF)
\r             carriage return, ASCII 0Dh (CR)
\e             escape, ASCII 1Bh (ESC)
\s             space, ASCII 20h (SPC)
\\             backslash, \
\nnn           octal bit pattern, where nnn is 1-3 octal digits ([0-7])
\xnn           hexadecimal bit pattern, where nn is 1-2 hexadecimal digits ([0-9a-fA-F])
\unnnn         Unicode character, where nnnn is exactly 4 hexadecimal digits ([0-9a-fA-F])
\u{nnnn ...}   Unicode character(s), where each nnnn is 1-6 hexadecimal digits ([0-9a-fA-F])
\cx or \C-x    control character, where x is an ASCII printable character
\M-x           meta character, where x is an ASCII printable character
\M-\C-x        meta control character, where x is an ASCII printable character
\M-\cx         same as above
\c\M-x         same as above
\c? or \C-?    delete, ASCII 7Fh (DEL)
\<newline>     continuation line (empty string)

最后一个 <newline> 表示一个空字符串而不是一个字符。它用于折叠字符串中的一行。

双引号字符串字面量 ↑

编写字符串的最常见方法是使用 "

"This is a string."

该字符串可以有多行。

任何内部 " 都必须转义

"This string has a quote: \".  As you can see, it is escaped"

双引号字符串允许转义序列中描述的转义序列。

在双引号字符串中，反斜杠后的任何其他字符都被解释为字符本身。

双引号字符串允许使用 #{...} 插值其他值

"One plus one is two: #{1 + 1}"

任何表达式都可以放在插值部分内，但最好保持表达式较小以提高可读性。

您也可以使用 #@foo、#@@foo 和 #$foo 分别作为 #{ @foo }、#{ @@foo } 和 #{ $foo } 的简写。

另请参阅

单引号字符串字面量 ↑

可以通过转义“#”字符或使用单引号字符串来禁用插值

'#{1 + 1}' #=> "\#{1 + 1}"

除了禁用插值外，单引号字符串还禁用除单引号（\'）和反斜杠（\\）之外的所有转义序列。

在单引号字符串中，反斜杠后的任何其他字符都被解释为原样：反斜杠和字符本身。

另请参阅

字面 String 连接 ↑

相邻的字符串字面量由解释器自动连接

"con" "cat" "en" "at" "ion" #=> "concatenation"
"This string contains "\
"no newlines."              #=> "This string contains no newlines."

只要百分比字符串不是最后一个，任何相邻的单引号、双引号、百分比字符串的组合都将被连接。

%q{a} 'b' "c" #=> "abc"
"a" 'b' %q{c} #=> NameError: uninitialized constant q

字符字面量 ↑

还有一种字符字面量表示法来表示单字符字符串，其语法是一个问号 (?) 后跟一个单字符或转义序列（不包括连续行），该转义序列对应于脚本编码中的单个代码点

?a       #=> "a"
?abc     #=> SyntaxError
?\n      #=> "\n"
?\s      #=> " "
?\\      #=> "\\"
?\u{41}  #=> "A"
?\C-a    #=> "\x01"
?\M-a    #=> "\xE1"
?\M-\C-a #=> "\x81"
?\C-\M-a #=> "\x81", same as above
?あ      #=> "あ"

Here 文档字面量 ↑

如果要编写大块文本，可以使用“here 文档”或“heredoc”

expected_result = <<HEREDOC
This would contain specially formatted text.

That might span many lines
HEREDOC

heredoc 从 <<HEREDOC 之后的行开始，并以以下一行开头为 HEREDOC 的行结束。结果包括结尾的换行符。

您可以将任何标识符与 heredoc 一起使用，但通常使用全大写标识符。

如果在 << 之后放置一个“ - ”，则可以缩进结尾标识符

  expected_result = <<-INDENTED_HEREDOC
This would contain specially formatted text.

That might span many lines
  INDENTED_HEREDOC

请注意，虽然可以缩进结尾标识符，但始终将内容视为左对齐。如果缩进内容，则这些空格将出现在输出中。

为了同时具有缩进内容和缩进的结尾标识符，可以使用“波浪线”heredoc，该 heredoc 在 << 之后使用“~”而不是“-”

expected_result = <<~SQUIGGLY_HEREDOC
  This would contain specially formatted text.

  That might span many lines
SQUIGGLY_HEREDOC

缩进最少的行的缩进将从内容的每一行中删除。请注意，为了确定缩进的目的，空行和仅由字面制表符和空格组成的行将被忽略，但转义的制表符和空格被视为非缩进字符。

为了测量缩进，水平制表符被视为一到八个空格的序列，以便与其末尾对应的列位置是八的倍数。要删除的数量以空格数计算。如果边界出现在制表符的中间，则不会删除该制表符。

heredoc 允许插值和转义序列中描述的转义序列。您可以通过用单引号括住开头标识符来禁用插值和转义

expected_result = <<-'EXPECTED'
One plus one is #{1 + 1}
EXPECTED

p expected_result # prints: "One plus one is \#{1 + 1}\n"

标识符也可以用双引号（与不使用引号相同）或反引号括起来。当用反引号括起来时，HEREDOC 的行为类似于 Kernel#`。

puts <<-`HEREDOC`
cat #{__FILE__}
HEREDOC

当用引号括起来时，除了该引号和换行符（CR 和/或 LF）之外的任何字符都可以用作标识符。

要在 heredoc 上调用方法，请将其放置在开头标识符之后

expected_result = <<-EXPECTED.chomp
One plus one is #{1 + 1}
EXPECTED

您可以在同一行上打开多个 heredoc，但这可能难以阅读

puts(<<-ONE, <<-TWO)
content for heredoc one
ONE
content for heredoc two
TWO

符号字面量 ↑

Symbol 表示 ruby 解释器内部的名称。有关符号是什么以及 ruby 在内部何时创建符号的更多详细信息，请参阅Symbol。

您可以使用冒号引用符号：:my_symbol。

您还可以通过插值和转义序列中描述的转义序列使用双引号创建符号

:"my_symbol1"
:"my_symbol#{1 + 1}"
:"foo\sbar"

与字符串一样，可以使用单引号来禁用插值和转义序列

:'my_symbol#{1 + 1}' #=> :"my_symbol\#{1 + 1}"

创建 Hash 时，还有一种特殊的语法用于引用 Symbol。

另请参阅

数组字面量 ↑

数组使用 [ 和 ] 之间的对象创建。

[1, 2, 3]

您可以在数组中放置表达式。

[1, 1 + 1, 1 + 2]
[1, [1 + 1, [1 + 2]]]

另请参阅

请参阅 Array 以了解可用于数组的方法。

哈希字面量 ↑

哈希使用 { 和 } 之间的键值对创建。

{ "a" => 1, "b" => 2 }

键和值都可以是任何对象。

您可以使用以下语法创建使用符号键的哈希。

{ a: 1, b: 2 }

此相同的语法用于方法的关键字参数。

与 Symbol 字面量一样，您可以引用符号键。

{ "a 1": 1, "b #{1 + 1}": 2 }

等于

{ :"a 1" => 1, :"b 2" => 2 }

Hash 值可以省略，这意味着将从上下文中按键的名称获取值。

x = 100
y = 200
h = { x:, y: }
#=> {:x=>100, :y=>200}

请参阅 Hash 以了解可用于哈希的方法。

范围字面量 ↑

范围表示值的间隔。该范围可能包含或排除其结束值。

(1..2)  # includes its ending value
(1...2) # excludes its ending value
(1..)   # endless range, representing infinite sequence from 1 to Infinity
(..1)   # beginless range, representing infinite sequence from -Infinity to 1

您可以创建任何对象的范围。 有关您需要实现的方法的详细信息，请参阅 Range 文档。

正则表达式字面量 ↑

可以使用前导和尾随斜杠 ('/') 字符创建正则表达式。

re = /foo/ # => /foo/
re.class   # => Regexp

尾随斜杠后可以跟一个或多个修改器字符，这些字符设置正则表达式的模式。 有关详细信息，请参阅正则表达式模式。

插值可以与转义字符一起在正则表达式内部使用。 请注意，正则表达式可能需要比字符串更多的转义字符。

另请参阅

有关正则表达式语法的描述，请参阅 Regexp。

Lambda Proc 字面量 ↑

可以使用 -> 创建 lambda proc。

-> { 1 + 1 }

调用上面的 proc 将得到 2 的结果。

您可以为 proc 要求参数，如下所示：

->(v) { 1 + v }

此 proc 将在其参数上加一。

百分号字面量 ↑

本节中描述的每个字面量都可以使用这些配对的分隔符

分隔符可以使用反斜杠转义。 但是，前四对（方括号、圆括号、大括号和尖括号）在正确配对的情况下允许不使用反斜杠。

这些将在下一节中演示。

%q：不可插值的 String 字面量 ↑

您可以使用 %q 编写不可插值的字符串。 创建的字符串与您使用单引号创建的字符串相同。

%q[foo bar baz]       # => "foo bar baz" # Using [].
%q(foo bar baz)       # => "foo bar baz" # Using ().
%q{foo bar baz}       # => "foo bar baz" # Using {}.
%q<foo bar baz>       # => "foo bar baz" # Using <>.
%q|foo bar baz|       # => "foo bar baz" # Using two |.
%q:foo bar baz:       # => "foo bar baz" # Using two :.
%q(1 + 1 is #{1 + 1}) # => "1 + 1 is \#{1 + 1}" # No interpolation.
%q[foo[bar]baz]       # => "foo[bar]baz" # brackets can be nested.
%q(foo(bar)baz)       # => "foo(bar)baz" # parenthesis can be nested.
%q{foo{bar}baz}       # => "foo{bar}baz" # braces can be nested.
%q<foo<bar>baz>       # => "foo<bar>baz" # angle brackets can be nested.

这类似于单引号字符串，但只有反斜杠和指定的分隔符可以使用反斜杠转义。

% 和 %Q：可插值的 String 字面量 ↑

您可以使用 %Q 或其别名 % 编写可插值的字符串。

%[foo bar baz]       # => "foo bar baz"
%(1 + 1 is #{1 + 1}) # => "1 + 1 is 2" # Interpolation.

这类似于双引号字符串。 它允许转义序列中描述的转义序列。 其他转义字符（反斜杠后跟一个字符）被解释为该字符。

%w 和 %W：字符串数组字面量 ↑

您可以使用 %w （不可插值）或 %W （可插值）将字符串数组编写为以空格分隔的单词。

%w[foo bar baz]       # => ["foo", "bar", "baz"]
%w[1 % *]             # => ["1", "%", "*"]
# Use backslash to embed spaces in the strings.
%w[foo\ bar baz\ bat] # => ["foo bar", "baz bat"]
%W[foo\ bar baz\ bat] # => ["foo bar", "baz bat"]
%w(#{1 + 1})          # => ["\#{1", "+", "1}"]
%W(#{1 + 1})          # => ["2"]

# The nested delimiters evaluated to a flat array of strings
# (not nested array).
%w[foo[bar baz]qux]   # => ["foo[bar", "baz]qux"]

以下字符被认为是分隔单词的空格

空格字符可以使用反斜杠转义，使其成为单词的一部分。

%W 允许转义序列中描述的转义序列。 但是，连续行 <newline> 不可用，因为它被解释为上面描述的转义换行符。

%i 和 %I：符号数组字面量 ↑

您可以使用 %i（不可插值）或 %I（可插值）将符号数组编写为以空格分隔的单词。

%i[foo bar baz]       # => [:foo, :bar, :baz]
%i[1 % *]             # => [:"1", :%, :*]
# Use backslash to embed spaces in the symbols.
%i[foo\ bar baz\ bat] # => [:"foo bar", :"baz bat"]
%I[foo\ bar baz\ bat] # => [:"foo bar", :"baz bat"]
%i(#{1 + 1})          # => [:"\#{1", :+, :"1}"]
%I(#{1 + 1})          # => [:"2"]

空格字符及其转义符的解释与 %w 和 %W：字符串数组字面量中描述的字符串数组字面量相同。

%s: Symbol 字面量 ↑

您可以使用 %s 编写符号

:foo     # => :foo
:foo bar # => :"foo bar"

这是不可插值的。 不允许插值。 只有反斜杠和指定的分隔符可以使用反斜杠转义。

%r: Regexp 字面量 ↑

您可以使用 %r 编写正则表达式； 用作前导和尾随分隔符的字符可以是（几乎）任何字符。

%r/foo/             # => /foo/
%r:name/value pair: # => /name\/value pair/

一些“对称”的字符对可以用作分隔符

%r[foo] # => /foo/
%r{foo} # => /foo/
%r(foo) # => /foo/
%r<foo> # => /foo/

尾随分隔符后可以跟一个或多个修改器字符，这些字符设置正则表达式的模式。 有关详细信息，请参阅正则表达式模式。

%x：反引号字面量 ↑

您可以使用 %x 编写并执行 shell 命令。

%x(echo 1)      # => "1\n"
%x[echo #{1 + 2}] # => "3\n"
%x[echo \u0030] # => "0\n"

这是可插值的。 %x 允许转义序列中描述的转义序列。