このマニュアルは既にメンテナンスが終了したバージョンの Ruby を対象としています。 最新版のマニュアルへ

Ruby 1.9.3 リファレンスマニュアル

module Singleton

要約

Singleton パターンを提供するモジュールです。

Mix-in により singleton パターンを提供します。

Singleton モジュールを include することにより、クラスは高々ひとつのインスタンスしか持たないことが保証されます。

Singleton を Mix-in したクラスのクラスメソッド instance はその唯一のインスタンスを返します。

new は private メソッドに移され、外部から呼び出そうとするとエラーになります。

サンプルコード

require 'singleton'
class SomeSingletonClass
  include Singleton
 #....
end
a = SomeSingletonClass.instance
b = SomeSingletonClass.instance  # a and b are same object
p [a,b]
a = SomeSingletonClass.new               # error (`new' is private)

目次

特異メソッド

特異メソッド

instance -> object[permalink][rdoc]

そのクラスの唯一のインスタンスを返します。最初に呼ばれたときはそのインスタンスを生成します。

Singleton を include したクラスで定義されますので、正確には Singleton モジュールのメソッドではありません。