在线文档教程
Ruby 2.4

WeakRef

WeakRef 类

Parent:Delegator

弱引用(Weak Reference)类,允许引用的对象被垃圾回收。

WeakRef 可能与其引用的对象完全相同。

用法:

foo = Object.new # create a new object instance p foo.to_s # original's class foo = WeakRef.new(foo) # reassign foo with WeakRef instance p foo.to_s # should be same class GC.start # start the garbage collector p foo.to_s # should raise exception (recycled)

示例

在 WeakRef 的帮助下,我们可以实现我们自己初级的 WeakHash 类。

我们将它称为 WeakHash,因为它实际上只是一个哈希,除了所有的键和值都可以被垃圾收集。

require 'weakref' class WeakHash < Hash def []= key, obj super WeakRef.new(key), WeakRef.new(obj) end end

这只是一个简单的实现,我们已经打开了 Hash 类并更改了 Hash#store,以便在将它们作为我们的键值对传递给散列之前,使用keyobj参数创建一个新的 WeakRef 对象。

有了这个,你将不得不限制自己的字符串键,否则你会得到一个 ArgumentError,因为 WeakRef 无法为符号创建终结器。符号是不可改变的,不能被垃圾收集。

让我们在行动中看看它:

omg = "lol" c = WeakHash.new c['foo'] = "bar" c['baz'] = Object.new c['qux'] = omg puts c.inspect #=> {"foo"=>"bar", "baz"=>#<Object:0x007f4ddfc6cb48>, "qux"=>"lol"} # Now run the garbage collector GC.start c['foo'] #=> nil c['baz'] #=> nil c['qux'] #=> nil omg #=> "lol" puts c.inspect #=> WeakRef::RefError: Invalid Reference - probably recycled

你可以看到局部变量omg保持不变,虽然它在我们的哈希对象中的引用是垃圾收集的,还有其他的键和值。另外,当我们试图检查我们的散列时,我们得到了一个 WeakRef :: RefError。这是因为这些对象也是垃圾收集的。

公共类方法

new(orig) 显示源代码

创建一个弱引用(weak reference)到 orig

如果给定orig是不可变的,比如 Symbol,Integer 或 Float,则引发一个 ArgumentError 。

调用超类方法 Delegator.new

# File lib/weakref.rb, line 82 def initialize(orig) case orig when true, false, nil @delegate_sd_obj = orig else @@__map[self] = orig end super end

公共实例方法

weakref_alive?()显示源文件

如果引用的对象仍然存在,则返回 true。

# File lib/weakref.rb, line 103 def weakref_alive? @@__map.key?(self) or defined?(@delegate_sd_obj) end