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’）

  如果您是软件包维护者，请使每个库包配置库时向 ‘extconf.rb’ 传递 ‘–vendor’ 选项，以便将库文件安装在 ‘vendor_ruby’ 下。

  您可以使用配置选项（例如 ‘–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 现在是一个内置模块。下一个和倒带方法使用“生成器”库实现。小心使用并注意性能损失。

• 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 模块支持

  • 支持 RSS 2.0 的 content:encoded

解释器实现¶ ↑

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

  已知此实现的当前形状存在错误/损坏，尤其是在嵌套块调用中。请将此视为一项实验性功能。

• 堆栈跟踪

  在非 SystemStackError 异常时，会显示完整的堆栈跟踪。

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

• String#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

  • 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 模式的数组。

• date

  • 基于 date2 4.0.3 更新。

• digest

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

  • 支持自动加载。

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

  • 新的 digest 类方法：file

  • 新的 digest 实例方法：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()

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

• 内置类

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

• date

  • 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) 仍然可用，但它是一个别名。