字面量 ↑

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

布尔值和 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。您还可以在浮点数中使用下划线。

有理数字面量 ↑

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

字符串 ↑

字符串文字 ↑

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

"This is a string."

字符串可以有多行长。

任何内部"都必须转义

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

双引号字符串允许转义字符，例如换行符\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)

反斜杠后面的任何其他字符都解释为字符本身。

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

"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} #=> 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 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 表示 ruby 解释器中的一个名称。有关符号是什么以及 ruby 在内部何时创建符号的更多详细信息，请参见 Symbol。

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

你也可以通过插值创建符号

:"my_symbol1"
:"my_symbol#{1 + 1}"

与字符串一样，可以使用单引号禁用插值

:'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 编写不可插值的字符串。创建的字符串与使用单引号创建的字符串相同

%[foo bar baz]        # => "foo bar baz" # Using [].
%(foo bar baz)        # => "foo bar baz" # Using ().
%{foo bar baz}        # => "foo bar baz" # Using {}.
%<foo bar baz>        # => "foo bar baz" # Using <>.
%|foo bar baz|        # => "foo bar baz" # Using two |.
%:foo bar baz:        # => "foo bar baz" # Using two :.
%q(1 + 1 is #{1 + 1}) # => "1 + 1 is \#{1 + 1}" # No interpolation.

% 和 %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(#{1 + 1})          # => ["\#{1", "+", "1}"]
%W(#{1 + 1})          # => ["2"]

%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(#{1 + 1})          # => [:"\#{1", :+, :"1}"]
%I(#{1 + 1})          # => [:"2"]

%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/

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

%x：反引号字面量 ↑

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

%x(echo 1) # => "1\n"