lib/concurrent-ruby/concurrent/set.rb



require 'concurrent/utility/engine'
require 'concurrent/thread_safe/util'
require 'set'

module Concurrent

  # @!macro concurrent_set
  #
  #   A thread-safe subclass of Set. This version locks against the object
  #   itself for every method call, ensuring only one thread can be reading
  #   or writing at a time. This includes iteration methods like `#each`.
  #
  #   @note `a += b` is **not** a **thread-safe** operation on
  #     `Concurrent::Set`. It reads Set `a`, then it creates new `Concurrent::Set`
  #     which is union of `a` and `b`, then it writes the union to `a`.
  #     The read and write are independent operations they do not form a single atomic
  #     operation therefore when two `+=` operations are executed concurrently updates
  #     may be lost. Use `#merge` instead.
  #
  #   @see http://ruby-doc.org/stdlib-2.4.0/libdoc/set/rdoc/Set.html Ruby standard library `Set`

  # @!macro internal_implementation_note
  SetImplementation = case
                      when Concurrent.on_cruby?
                        # The CRuby implementation of Set is written in Ruby itself and is
                        # not thread safe for certain methods.
                        require 'monitor'
                        require 'concurrent/thread_safe/util/data_structures'

                        class CRubySet < ::Set
                        end

                        ThreadSafe::Util.make_synchronized_on_cruby CRubySet
                        CRubySet

                      when Concurrent.on_jruby?
                        require 'jruby/synchronized'

                        class JRubySet < ::Set
                          include JRuby::Synchronized
                        end

                        JRubySet

                      when Concurrent.on_truffleruby?
                        require 'concurrent/thread_safe/util/data_structures'

                        class TruffleRubySet < ::Set
                        end

                        ThreadSafe::Util.make_synchronized_on_truffleruby TruffleRubySet
                        TruffleRubySet

                      else
                        warn 'Possibly unsupported Ruby implementation'
                        ::Set
                      end
  private_constant :SetImplementation

  # @!macro concurrent_set
  class Set < SetImplementation
  end
end