Ruby 1.8.7 的 NEWS¶ ↑

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

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

自 1.8.6 版本以来的更改¶ ↑

配置更改¶ ↑

• 默认 C 标志

  根据您的环境，默认情况下可能会添加一些 C 编译器标志。根据需要指定 optflags=.. 和 warnflags=.. 以覆盖它们。

• vendor_ruby 目录

  除了 'site_ruby' 之外，还引入了一个名为 'vendor_ruby' 的新库目录。这样做的目的是将软件包系统安装的库（'vendor'）与手动安装的库（'site'）分开，防止前者被后者覆盖，同时保留用户使用 site 库覆盖 vendor 库的选项。（'site_ruby' 的优先级高于 'vendor_ruby'）

  如果您是软件包维护人员，请让每个库软件包配置库，并将 '–vendor' 选项传递给 'extconf.rb'，以便库文件将安装在 'vendor_ruby' 下。

  您可以使用 configure 选项（如 '--with-sitedir=DIR' 和 '--with-vendordir=DIR'）更改目录位置。

全局常量¶ ↑

• 新常量

  • RUBY_COPYRIGHT

  • RUBY_DESCRIPTION

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

• 新库

  • securerandom

• 内置类

  • Array#flatten

  • Array#flatten!

    接受一个可选参数，该参数确定要展平的递归级别。

  • Array#eql?

  • Array#hash

  • Array#==

  • Array#<=>

    正确处理递归数据。

  • Array#index

  • Array#rindex

    如果没有给定参数，则使用给定的块。

  • Array#collect!

  • Array#map!

  • Array#each

  • Array#each_index

  • Array#reverse_each

  • Array#reject

  • Array#reject!

  • Array#delete_if

  • Array#select

    如果没有给出块，则返回一个枚举器。

    请注意，与 Ruby 1.9 不同，map 和 collect 仍然返回一个数组，以保持兼容性。

  • Array#pop

  • Array#shift

    接受一个可选参数，指定要删除的元素数量。

  • Array#choice

  • Array#combination

  • Array#cycle

  • Array#drop

  • Array#drop_while

  • Array#permutation

  • Array#product

  • Array#shuffle

  • Array#shuffle!

  • Array#take,

  • Array#take_while

    新方法。

  • Binding#eval

    新方法。

  • Dir#each

  • Dir#foreach

    如果没有给出块，则返回一个枚举器。

  • Enumerable::Enumerator

    由枚举器库定义的各种枚举的新类。

  • Enumerable#each_slice

  • Enumerable#each_cons

  • Object#to_enum

  • Object#enum_for

    由枚举器库定义的各种枚举的新方法。

  • Enumerable#count

  • Enumerable#cycle

  • Enumerable#drop

  • Enumerable#drop_while

  • Enumerable#find_index

  • Enumerable#first

  • Enumerable#group_by

  • Enumerable#max_by

  • Enumerable#min_by

  • Enumerable#minmax

  • Enumerable#minmax_by

  • Enumerable#none?

  • Enumerable#one?

  • Enumerable#take

  • Enumerable#take_while

    新方法。

  • Enumerable#find

  • Enumerable#find_all

  • Enumerable#partition

  • Enumerable#reject

  • Enumerable#select

  • Enumerable#sort_by

    如果没有给出块，则返回一个枚举器。

    请注意，与 Ruby 1.9 不同，map 和 collect 仍然返回一个数组，以保持兼容性。

  • Enumerable#inject

    接受二进制运算符而不是块。

  • Enumerable#reduce

    inject 的新别名。

  • Enumerable#to_a

    可以接受可选参数并将其传递给 each。

  • Hash#eql?

  • Hash#hash

  • Hash#==

    正确处理递归数据。

  • Hash#delete_if

  • Hash#each

  • Hash#each_key

  • Hash#each_pair

  • Hash#each_value

  • Hash#reject!

  • Hash#select

  • ENV.delete_if

  • ENV.each

  • ENV.each_key

  • ENV.each_pair

  • ENV.each_value

  • ENV.reject!

  • ENV.select

    如果没有给出块，则返回一个枚举器。

  • GC.stress

  • GC.stress=

    新方法。

  • Integer#ord

  • Integer#odd?

  • Integer#even?

  • Integer#pred

    新方法。

  • Integer#downto

  • Integer#times

  • Integer#upto

    如果没有给出块，则返回一个枚举器。

  • IO#each

  • IO#each_line

  • IO#each_byte

  • IO.foreach

  • ARGF.each

  • ARGF.each_line

  • ARGF.each_byte

    如果没有给出块，则返回一个枚举器。

  • IO#bytes

  • IO#chars

  • IO#each_char

  • IO#getbyte

  • IO#lines

  • IO#readbyte

  • ARGF.bytes

  • ARGF.chars

  • ARGF.each_char

  • ARGF.getbyte

  • ARGF.lines

  • ARGF.readbyte

    新方法。

  • Method#name

  • Method#owner

  • Method#receiver

  • UnboundMethod#name

  • UnboundMethod#owner

    新方法。

  • Module#class_exec

  • Module#module_exec

    新方法。

  • Numeric#step

    如果没有给出块，则返回一个枚举器。

  • Object#instance_exec

  • Object#tap

    新方法。

  • ObjectSpace.each_object

    如果没有给出块，则返回一个枚举器。

  • Process.exec 已实现。

  • Range#each

  • Range#step

    如果没有给出块，则返回一个枚举器。

  • Regexp.union 接受模式数组。

  • String#bytes

    新方法

  • String#bytesize

    新方法，返回字节大小。（别名 length 和 size）

  • String#chars

  • String#each_char

  • String#lines

  • String#partition

  • String#rpartition

  • String#start_with?

  • String#end_with?

    新方法。这些方法与 index、rindex 和 include? 不同，它们是 $KCODE 感知的。

  • String#each_byte

  • String#each

  • String#each_line

  • String#gsub(pattern)

    如果没有给出块，则返回一个枚举器。

  • String#upto

    添加了可选的第二个参数，以指定是否应包含最后一个值。

  • StopIteration

    当引发时导致 Kernel#loop 停止迭代的新异常类。

  • Struct#each

  • Struct#each_pair

    如果没有给出块，则返回一个枚举器。

  • Symbol#to_proc

    新方法。

  • __method__

    返回当前方法的名称作为 Symbol 的新全局函数。

• enumerator

  • Enumerator 现在是一个内置模块。使用“generator”库实现 next 和 rewind 方法。请谨慎使用，并注意性能损失。

• ipaddr

  • 新方法

    • IPAddr#<=>

    • IPAddr#succ

      IPAddr 对象现在是可比较和可枚举的，具有这些方法。这也意味着可以在两个 IPAddr 对象之间有一个 Range 对象。

    • IPAddr#to_range

      为（网络）地址创建一个 Range 对象的新方法。

  • 类型强制支持

    • IPAddr#&

    • IPAddr#|

    • IPAddr#==

    • IPAddr#include?

      这些方法现在接受字符串或整数，而不是 IPAddr 对象作为参数。

• net/smtp

  • 支持 SSL/TLS。

• openssl

  • 新类

    • OpenSSL::PKey::EC

    • OpenSSL::PKey::EC::Group

    • OpenSSL::PKey::EC::Point

    • OpenSSL::PKey::PKCS5

    • OpenSSL::SSL::Session

  • 文档！

  • 各种新方法（请参阅文档）。

  • 删除 Cipher、Digest、PKCS7、PKCS12 中多余的模块命名空间。提供了将在 Ruby 1.9 中删除的兼容性类。

• shellwords

  • 添加用于转义 shell 不安全字符的方法

    • Shellwords.join

    • Shellwords.escape

    • Array#shelljoin

    • String#shellescape

  • 添加简写方法

    • Shellwords.split (别名 shellwords)

    • String#shellsplit

• stringio

  • StringIO#getbyte

  • StringIO#readbyte

    新方法。（与 1.9 兼容的别名）

  • StringIO#each_char

  • StringIO#chars

    新方法。

  • StringIO#each

  • StringIO#each_line

  • StringIO#each_byte

    如果没有给出块，则返回一个枚举器。

• tempfile

  • Tempfile.open 和 Tempfile.new 现在接受要创建的临时文件的后缀。要指定后缀，请将 [basename, suffix] 数组作为第一个参数传递。

    Tempfile.open(['image', 'jpg']) { |tempfile| ... }

• tmpdir

  • 新方法

    • Dir.mktmpdir

• uri

  • 添加了 LDAPS 方案。

  • RFC3986 的更改

    • FTP

      • URI('example.com/foo').path #=> 'foo'

      • URI('example.com/%2Ffoo').path #=> '/foo'

      • URI::FTP.build([nil, 'example.com', nil, '/foo', 'i']).to_s #=> 'example.com/%2Ffoo;type=i'

    • URI 合并

      • URI('a/b/c/d;p?q').merge('?y') == URI('a/b/c/d;p?y')

      • URI('a/b/c/d;p?q').merge('/./g') == URI('a/g')

      • URI('a/b/c/d;p?q').merge('/../g') == URI('a/g')

      • URI('a/b/c/d;p?q').merge('../../../g') == URI('a/g')

      • URI('a/b/c/d;p?q').merge('../../../../g') == URI('a/g')

• rss

  • 0.1.6 -> 0.2.4

  • 修复图像模块 URI

  • Atom 支持

  • ITunes 模块支持

  • Slash 模块支持

  • content:encoded 和 RSS 2.0 支持

解释器实现¶ ↑

• 将块传递给 Proc [实验性]

  当前实现的版本已知存在缺陷/错误，尤其是在嵌套块调用方面。请将其视为一项实验性功能。

• 堆栈跟踪

  对于非 SystemStackError 异常，将显示完整的堆栈跟踪。

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

• String#slice! 存在一些无意的错误，这些错误已被修复，因为它们要么与文档不一致，要么与 slice 的相应行为不符。不幸的是，这会在以下（有些罕见的）情况下导致一些不兼容性。

  • 当给定超出边界的值时，slice! 不再扩展数组。

    # Ruby 1.8.6
    a = [1,2]
    a.slice!(4,0)   #=> nil
    a               #=> [1,2,nil,nil]
    
    # Ruby 1.8.7
    a = [1,2]
    a.slice!(4,0)   #=> nil
    a               #=> [1,2]
    

  • 当给定负长度或超出边界的负位置时，slice! 不再引发异常，而是返回 nil。

    # Ruby 1.8.6
    a = [1,2]
    a.slice!(1,-1)  #=> (raises IndexError)
    a.slice!(-5,1)  #=> (raises IndexError)
    
    # Ruby 1.8.7
    a = [1,2]
    a.slice!(1,-1)  #=> nil
    a.slice!(-5,1)  #=> nil
    

• String#to_i、 String#hex 和 String#oct 不再接受由下划线 ('__') 组成的序列作为数字的一部分。

  # Ruby 1.8.6
  '1__0'.to_i     #=> 10
  '1__0'.to_i(2)  #=> 2  # 0b10
  '1__0'.oct      #=> 8  # 010
  '1__0'.hex      #=> 16 # 0x10
  
  # Ruby 1.8.7
  '1__0'.to_i     #=> 1
  '1__0'.to_i(2)  #=> 1
  '1__0'.oct      #=> 1
  '1__0'.hex      #=> 1
  

  旧的行为与 Ruby 语法不一致，被认为是错误。

• 日期

  • Date.parse

    '##.##.##' （其中每个'#'是一个数字）现在被视为 'YY.MM.DD' 而不是 'MM.DD.YY'。虽然此更改可能会让您感到困惑，但如果您知道自己在处理什么，则始终可以使用Date.strptime()。

• REXML

  • REXML::Document.entity_expansion_limit=

    用于设置实体扩展限制的新方法。默认情况下，限制设置为 10000。有关详细信息，请参阅以下 URL。

    www.ruby-lang.org/en/news/2008/08/23/dos-vulnerability-in-rexml/

• stringio

  • StringIO#each_byte

    返回值已从 nil 更改为 self。这与文档所说的相同，也与 each_line() 的行为相同。

• tempfile

  • 文件名格式已更改。默认情况下，临时文件名不再包含点。有关如何指定后缀，请参阅上文。

• uri

  • 有关详细信息，请参阅上文。

自 1.8.5 版本以来的更改¶ ↑

新的平台/构建工具支持¶ ↑

• IA64 HP-UX

• Visual C++ 8 SP1

• autoconf 2.6x

全局常量¶ ↑

• RUBY_PATCHLEVEL

  自 1.8.5-p1 以来的新常量。

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

• 内置类

  • 新方法：Kernel#instance_variable_defined?

  • 新方法： Module#class_variable_defined?

  • 新功能： Dir::glob() 现在可以接受 glob 模式数组。

• 日期

  • 基于 date2 4.0.3 更新。

• digest

  • 用于 C 和 Ruby 的新内部 API。

  • 支持自动加载。

    require 'digest'
    
    # autoloads digest/md5
    md = Digest::MD5.digest("string")
    

  • 新的摘要类方法：file

  • 新的摘要实例方法：clone、reset、new、inspect、digest_length (别名 size 或 length)、block_length()

  • 新库：digest/bubblebabble

  • 新函数：Digest(name)

• fileutils

  • FileUtils.cp_r() 的新选项：:remove_destination

• nkf

  • 基于截至 2007-01-28 的 nkf 更新。

• thread

  • 已替换为 C 中速度快得多的互斥锁实现。之前的实现速度较慢，但被认为是稳定的，可以通过配置选项“--disable-fastthread”获得。

• tk

  • 基于 Tile 0.7.8 更新了 Tile 扩展支持。

  • 支持 Tcl/Tk 的非 X11 版本（例如 Tcl/Tk Aqua）的 --without-X11 配置选项。

  • 新的示例脚本：irbtkw.rbw - Ruby/Tk 上的 IRB。它在 Windows 上没有关于 STDIN 阻塞的问题。

• webrick

  • 新方法：WEBrick::Cookie.parse_set_cookies()

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

• 内置类

  • 当 $SAFE 级别大于零时， String#intern 现在会引发 SecurityError。

• 日期

  • Time#to_date 和 Time#to_datetime 被添加为私有方法。它们在 ActiveSupport 1.4.1 和更早版本中会导致名称冲突错误，这些版本随 Rails 1.2.2 和更早版本一起提供。将 ActiveSupport 和/或 Rails 更新到最新版本可以解决此问题。

• digest

  • 构造函数不再接受要馈入的初始字符串。以下示例显示了如何迁移

    # Before
    md = Digest::MD5.new("string")
    # After (works with any version)
    md = Digest::MD5.new.update("string")
    
    # Before
    hd = Digest::MD5.new("string").hexdigest
    # After (works with any version)
    hd = Digest::MD5.hexdigest("string")
    

  • Digest::Base#==

    • self == string

      已删除二进制摘要值和十六进制摘要值之间的自动检测。始终假定给定的十六进制摘要值用于比较。

    • self == md

      Digest 对象通过生成的摘要值进行比较，而不是通过精确的向量状态进行比较。

• fileutils

  • 一个小的实现更改会导致 Rake <= 0.7.1 中断。将 Rake 更新到 0.7.2 或更高版本可以解决此问题。

• tk

  • Tk::X_Scrollable (Y_Scrollable) 重命名为 Tk::XScrollable (YScrollable)。Tk::X_Scrollable (Y_Scrollable) 仍然可用，但它是一个别名。