字面量

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

布尔值和 Nil 字面量

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。您也可以在浮点数中使用下划线。

有理数 (Rational) 字面量

您可以使用特殊后缀 '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) 字面量

您可以通过如下方式编写 Complex 数（后缀 i）：

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

有理数也可以是虚数。

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

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

12.3ir      #=> Syntax error

字符串字面量

双引号字符串字面量

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

"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}"

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

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

另请参阅

字面量字符串连接

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

"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} #=> NoMethodError: undefined method 'q' for main

字符字面量

还有一个字符字面量表示法，用于表示单字符字符串，其语法是一个问号 (?)，后跟一个单个字符或转义序列（除了换行符），该字符或转义序列对应于脚本编码中的单个代码点。

?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 document 字面量（未加引号、双引号和反引号）、双引号符号、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> 表示一个空字符串而不是一个字符。它用于折叠字符串中的行。

Here Document 字面量

如果您要编写大块文本，您可以使用“here document”或“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，它使用“ ~ ”而不是“ - ”在 << 之后。

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) 字面量

Symbol 在 Ruby 解释器中代表一个名称。有关符号是什么以及 Ruby 何时在内部创建它们的更多详细信息，请参阅 Symbol。

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

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

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

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

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

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

另请参阅

数组 (Array) 字面量

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

[1, 2, 3]

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

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

另请参阅

有关数组可以使用的各种方法，请参阅 Array。

哈希 (Hash) 字面量

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

{ "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。

范围 (Range) 字面量

范围表示一个值的区间。范围可以包含或排除其结束值。

(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 文档。

正则表达式 (Regexp) 字面量

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

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

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

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

另请参阅

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

Lambda Proc 字面量

可以使用 -> 创建 lambda proc。

-> { 1 + 1 }

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

您可以如下方式为 proc 要求参数：

->(v) { 1 + v }

这个 proc 将为其参数加一。

百分号 (Percent) 字面量

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

定界符可以用反斜杠转义。但是，前四个对（方括号、圆括号、花括号和尖括号）在正确配对的情况下，无需反斜杠即可使用。

这些将在下一节中演示。

%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 编写符号。

%s[foo]     # => :foo
%s[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/

尾随定界符后可以跟一个或多个修饰符字符，这些字符设置正则表达式的模式。有关详细信息，请参阅 Regexp modes。

%x：反引号 (Backtick) 字面量

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

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

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