Set

class Set(client, service_name, name)

Bases: hazelcast.proxy.base.PartitionSpecificProxy

Concurrent, distributed implementation of Set.

add(item)

Adds the specified item if it is not exists in this set.

Parameters

item – (object), the specified item to be added.

Returns

(bool), true if this set is changed after call, false otherwise.

add_all(items)

Adds the elements in the specified collection if they’re not exist in this set.

Parameters

items – (Collection), collection which includes the items to be added.

Returns

(bool), true if this set is changed after call, false otherwise.

add_listener(include_value=False, item_added_func=None, item_removed_func=None)

Adds an item listener for this container. Listener will be notified for all container add/remove events.

Parameters
  • include_value – (bool), whether received events include the updated item or not (optional).

  • item_added_func – Function to be called when an item is added to this set (optional).

  • item_removed_func – Function to be called when an item is deleted from this set (optional).

Returns

(str), a registration id which is used as a key to remove the listener.

clear()

Clears the set. Set will be empty with this call.

contains(item)

Determines whether this set contains the specified item or not.

Parameters

item – (object), the specified item to be searched.

Returns

(bool), true if the specified item exists in this set, false otherwise.

contains_all(items)

Determines whether this set contains all of the items in the specified collection or not.

Parameters

items – (Collection), the specified collection which includes the items to be searched.

Returns

(bool), true if all of the items in the specified collection exist in this set, false otherwise.

get_all()

Returns all of the items in the set.

Returns

(Sequence), list of the items in this set.

is_empty()

Determines whether this set is empty or not.

Returns

(bool), true if this set is empty, false otherwise.

remove(item)

Removes the specified element from the set if it exists.

Parameters

item – (object), the specified element to be removed.

Returns

(bool), true if the specified element exists in this set.

remove_all(items)

Removes all of the elements of the specified collection from this set.

Parameters

items – (Collection), the specified collection.

Returns

(bool), true if the call changed this set, false otherwise.

remove_listener(registration_id)

Removes the specified item listener. Returns silently if the specified listener was not added before.

Parameters

registration_id – (str), id of the listener to be deleted.

Returns

(bool), true if the item listener is removed, false otherwise.

retain_all(items)

Removes the items which are not contained in the specified collection. In other words, only the items that are contained in the specified collection will be retained.

Parameters

items – (Collection), collection which includes the elements to be retained in this set.

Returns

(bool), true if this set changed as a result of the call.

size()

Returns the number of items in this set.

Returns

(int), number of items in this set.