Ruby 2.1.0 的 NEWS¶ ↑

本文档列出了版本之间用户可见的功能变更，不包括错误修复。

请注意，每个条目都保持简短，不提供背后的原因或参考信息。有关包含所有足够信息的完整更改列表，请参阅 ChangeLog 文件。

自 2.0.0 版本以来的变更¶ ↑

语言变更¶ ↑

• 现在可以省略关键字参数的默认值。这些“必需的关键字参数”需要在调用时显式给出。

• 为整数和浮点数字面量添加了后缀：‘r’、‘i’ 和 ‘ri’。

  • “42r” 和 “3.14r” 分别被评估为 Rational(42, 1) 和 3.14.rationalize。但是，带有 ‘r’ 后缀的指数形式（如 “6.022e+23r”）不被接受，因为它会产生误导。

  • “42i” 和 “3.14i” 分别被评估为 Complex(0, 42) 和 Complex(0, 3.14)。

  • “42ri” 和 “3.14ri” 分别被评估为 Complex(0, 42r) 和 Complex(0, 3.14r)。

• def-expr 现在返回其名称的符号，而不是 nil。

核心类更新（仅列出重要更新）¶ ↑

• Array

  • 新方法

    • Array#to_h 将键值对的数组转换为 Hash。

• Binding

  • 新方法

    • Binding#local_variable_get(symbol)

    • Binding#local_variable_set(symbol, obj)

    • Binding#local_variable_defined?(symbol)

• Enumerable

  • 新方法

    • Enumerable#to_h 将键值对列表转换为 Hash。

• Exception

  • 新方法

    • Exception#cause 提供在引发新异常的位置捕获的先前异常。

• GC

  • 改进

    • 引入了分代 GC，也称为 RGenGC。

  • 添加了环境变量

    • RUBY_GC_HEAP_INIT_SLOTS

    • RUBY_GC_HEAP_FREE_SLOTS

    • RUBY_GC_HEAP_GROWTH_FACTOR

    • RUBY_GC_HEAP_GROWTH_MAX_SLOTS

    • RUBY_GC_MALLOC_LIMIT_MAX

    • RUBY_GC_MALLOC_LIMIT_GROWTH_FACTOR

    • RUBY_GC_OLDMALLOC_LIMIT

    • RUBY_GC_OLDMALLOC_LIMIT_MAX

    • RUBY_GC_OLDMALLOC_LIMIT_GROWTH_FACTOR

  • 已弃用的环境变量

    • RUBY_FREE_MIN（请改用 RUBY_GC_HEAP_FREE_SLOTS）

    • RUBY_HEAP_MIN_SLOTS（请改用 RUBY_GC_HEAP_INIT_SLOTS）

• Integer

  • 新方法

    • Fixnum#bit_length

    • Bignum#bit_length

  • Bignum 性能改进

    • 如果可用，则使用 GMP。GMP 仅用于几个操作：乘法、除法、基数转换、GCD

• IO

  • 扩展方法

    • IO#seek 支持将 SEEK_DATA 和 SEEK_HOLE 作为 whence。

    • IO#seek 接受符号（:CUR、:END、:SET、:DATA、:HOLE）作为第二个参数。

    • IO#read_nonblock 接受可选的 ‘exception: false’ 返回符号

    • IO#write_nonblock 接受可选的 ‘exception: false’ 返回符号

• Kernel

  • 新方法

    • Kernel#singleton_method

• Module

  • 新方法

    • Module#using，仅在当前类或模块定义中激活指定模块的精化。

    • Module#singleton_class? 如果接收者是单例类则返回 true，如果它是普通类或模块则返回 false。

  • 扩展方法

    • Module#refine 不再是实验性的。

    • Module#include 和 Module#prepend 现在是公共方法。

• Mutex

  • 其他

    • Mutex#owned? 不再是实验性的。

• Numeric

  • 扩展方法

    • Numeric#step 允许省略 limit 参数，在这种情况下，会生成无限的数字序列。引入了关键字参数 ‘to’ 和 ‘by’ 以方便使用。‘by’ 可以为 0，在这种情况下，会无限期地生成相同的值。

• Process

  • 新方法

    • $0/$0= 的替代方法

      • Process.argv0() 返回 $0 的原始值。

      • Process.setproctitle() 设置进程标题，而不会影响 $0。

    • Process.clock_gettime

    • Process.clock_getres

• String

  • “literal”.freeze 现在经过优化，返回相同的对象

  • 新方法

    • String#scrub 和 String#scrub! 验证并修复无效的字节序列。如果想在较旧的 Ruby 版本中使用此功能，请考虑使用 string-scrub.gem。

• Symbol

  • 所有符号现在都是冻结的。

• pack/unpack (Array/String)

  • 如果平台具有该类型，则为 long long 类型提供 Q! 和 q! 指令。

• toplevel

  • 扩展方法

    • main.using 不再是实验性的。该方法激活参数模块祖先中的精化，以支持通过 Module#include 进行精化继承。

核心类兼容性问题（不包括特性错误修复）¶ ↑

• Hash

  • 不兼容的更改

    • Hash#reject 将在未来版本中返回普通的 Hash 对象，即不再复制原始对象的子类、实例变量、默认值和污点，因此现在在使用此类 Hash 调用时会发出警告。

• IO

  • 不兼容的更改

    • 如果外部编码为 ASCII-8BIT，则打开时忽略内部编码。

• Kernel#eval、Kernel#instance_eval 和 Module#module_eval。

  • 复制原始环境的作用域信息，这意味着没有参数的 private、protected、public 和 module_function 不会影响 eval 字符串之外的环境。例如，“class Foo; eval "private"; def foo; end; end” 不会将 Foo#foo 设置为 private。

• Kernel#untrusted?、untrust 和 trust

  • 这些方法已弃用，它们的行为分别与 tainted?、taint 和 untaint 相同。如果 $VERBOSE 为 true，则它们会显示警告。

• Module#ancestors

  • 单例类的祖先现在包括单例类，特别是它自己。

• Module#define_method 和 Object#define_singleton_method

  • 现在它们返回已定义方法的符号，而不是方法/proc 本身。

• Numeric#quo

  • 如果接收者没有 to_r 方法，则引发 TypeError 而不是 ArgumentError。

• Proc

  • 从 lambda proc 返回现在总是从 Proc 中退出，而不是从创建 lambda 的方法中退出。从非 lambda proc 返回则从方法中退出，与之前的行为相同。

String

* If invalid: :replace is specified for String#encode, replace
  invalid byte sequence even if the destination encoding equals to
  the source encoding.

标准库更新（仅列出重要更新）¶ ↑

• CGI::Util

  • 所有类方法都模块化了。

• Digest

  • 扩展方法

    • Digest::Class.file 为其构造函数采用可选参数

• Matrix

  • 添加了 Vector#cross_product。

• Net::SMTP

  • 添加了 Net::SMTP#rset 以实现 RSET 命令

• objspace

  • 新方法

    • ObjectSpace.trace_object_allocations

    • ObjectSpace.trace_object_allocations_start

    • ObjectSpace.trace_object_allocations_stop

    • ObjectSpace.trace_object_allocations_clear

    • ObjectSpace.allocation_sourcefile

    • ObjectSpace.allocation_sourceline

    • ObjectSpace.allocation_class_path

    • ObjectSpace.allocation_method_id

    • ObjectSpace.allocation_generation

    • ObjectSpace.reachable_objects_from_root

    • ObjectSpace.dump

    • ObjectSpace.dump_all

• OpenSSL::BN

  • 扩展方法

    • OpenSSL::BN.new 允许 Fixnum/Bignum 参数。

• open-uri

  • 支持具有相同字段名称的多个字段（如 Set-Cookie）。

• Pathname

  • 新方法

    • Pathname#write

    • Pathname#binwrite

• rake

  • 已更新到 10.1.0。主要更改包括删除类命名空间、用于保存 rake DSL 方法的 Rake::DSL 以及删除对旧版 rake 功能的支持。

    有关自 rake 0.9.6 以来的完整更改列表，请参阅

    rake.rubyforge.org/doc/release_notes/rake-10_1_0_rdoc.html

    rake.rubyforge.org/doc/release_notes/rake-10_0_3_rdoc.html

• RbConfig

  • 新常量

    • 添加了 RbConfig::SIZEOF 以提供 C 类型的大小。

• RDoc

  • 已更新到 4.1.0。主要增强功能包括修改后的默认模板

  • 和可访问性增强功能。

    有关次要增强功能和错误修复的列表，请参阅：github.com/rdoc/rdoc/blob/v4.1.0.preview.1/History.rdoc

• Resolv

  • 新方法

    • Resolv::DNS.fetch_resource

  • 一次性多播 DNS 支持

  • 支持 LOC 资源

• REXML::Parsers::SAX2Parser

  • 修复了实体声明事件的错误参数数量。事件的文档说“实体声明数组”，但实现传递两个或更多参数。这是一个实现错误，但它破坏了向后兼容性。

• REXML::Parsers::StreamParser

  • 支持 “entity” 事件。

• REXML::Text

  • REXML::Text#<< 支持方法链，如 'text << "XXX" << "YYY"'。

  • REXML::Text#<< 支持非 “raw” 模式。

• Rinda::RingServer、Rinda::RingFinger

  • Rinda 现在支持多播套接字。有关详细信息，请参阅 Rinda::RingServer 和 Rinda::RingFinger。

• RubyGems

  • 已更新至 2.2.0 版本。主要新功能包括：

    • 支持 Gemfile 或 gem.deps.rb，包括 Gem.file.lock (实验性)

    • 改进的迭代解析器（与 RubyGems 2.1 及更早版本相比）

    • 支持跨 Ruby 平台和版本共享 GEM_HOME

    有关增强功能和错误修复的完整列表，请参阅：github.com/rubygems/rubygems/tree/master/History.txt

• Set

  • 新方法

    • Set#intersect?

    • Set#disjoint?

• Socket

  • 新方法

    • Socket.getifaddrs

• StringScanner

  • 扩展方法

    • StringScanner#[] 支持命名捕获。

• Syslog::Logger

  • 添加了 facility。

• Tempfile

  • 新方法

    • Tempfile.create

• Timeout

  • 默认情况下，除非显式给出异常类，否则在给定代码块内部不能再捕获终止该代码块的异常。

• TSort

  • 新方法

    • TSort.tsort

    • TSort.tsort_each

    • TSort.strongly_connected_components

    • TSort.each_strongly_connected_component

    • TSort.each_strongly_connected_component_from

• WEBrick

  • 响应的主体现在可以是 StringIO 或其他类似于 IO 且响应 readpartial 和 read 的对象。

• XMLRPC::Client

  • 新方法

    • XMLRPC::Client#http。它返回客户端的 Net::HTTP。通常情况下，不需要它。当您想要更改 HTTP 客户端的次要选项时，它非常有用。您可以通过 XMLRPC::Client 方法更改 HTTP 客户端的主要选项。您应该使用 XMLRPC::Client 方法更改 HTTP 客户端的主要选项，而不是 XMLRPC::Client#http。

Stdlib 兼容性问题（不包括功能性错误修复）¶ ↑

• Set

  • 不兼容的更改

    • Set#to_set 现在返回 self 而不是生成副本。

• URI

  • 不兼容的更改

    • URI.decode_www_form 遵循当前的 WHATWG URL 标准。它会获取编码参数以指定字符编码。它现在允许宽松的百分比编码字符串，但拒绝 ;-分隔符。

    • URI.encode_www_form 遵循当前的 WHATWG URL 标准。它会获取编码参数以在百分比编码之前进行转换。默认情况下，UTF-16 字符串不会在百分比编码之前转换为 UTF-8。

• curses

  • 已删除。curses 现在可以作为 gem 使用。有关详细信息，请参阅 rubygems.org/gems/curses。

内置全局变量兼容性问题¶ ↑

• $SAFE

  • $SAFE=4 已过时。如果 $SAFE 设置为 4 或更大，则会引发 ArgumentError。

C API 更新¶ ↑

• rb_gc_set_params() 已弃用。这仅在 Ruby 内部使用。

• 添加了 rb_gc_count()。它返回 GC 发生的次数。

• 添加了 rb_gc_stat()。这允许从 C 访问特定的 GC.stat() 值，而无需任何分配开销。

• 添加了 rb_gc_latest_gc_info()。这允许访问 GC.latest_gc_info()。

• 添加了 rb_postponed_job_register()。它接受一个函数回调，该函数在 VM 处于一致状态时调用，即从 C 信号处理程序执行工作。

• 添加了 rb_profile_frames()。它为调用堆栈分析提供对当前 Ruby 堆栈的低成本访问。

• rb_tracepoint_new() 支持只能从 C 访问的新内部事件

  • RUBY_INTERNAL_EVENT_NEWOBJ

  • RUBY_INTERNAL_EVENT_FREEOBJ

  • RUBY_INTERNAL_EVENT_GC_START

  • RUBY_INTERNAL_EVENT_GC_END_MARK

  • RUBY_INTERNAL_EVENT_GC_END_SWEEP

  • 请注意，您*不能*同时使用普通事件（例如 RUBY_EVENT_CALL、RUBY_EVENT_RETURN）指定“内部事件”。