xtd::collections::concurrent::concurrent_bag< type_t > Class Template Reference

Inheritance diagram for xtd::collections::concurrent::concurrent_bag< type_t >:

Definition

template<typename type_t>
class xtd::collections::concurrent::concurrent_bag< type_t >

Represents a thread-safe, unordered collection of objects.

Definition

template<typename type_t>
class concurrent_bag : pulic xtd::object, public xtd::collections::concurrent::iproducer_consumer_collection <type_t>

Header

#include <xtd/collections/concurrent/iproducer_consumer_collection>

Namespace

xtd::collections::concurrent

Library

xtd.core

Public Aliases
using	value_type
	Represents the concurrent bag value type.
using	reference
	Represents the reference of list value type.
using	const_reference
	Represents the const reference of list value type.
using	collection_type
	Represents the concurrent bag collection type.
using	local_storage_type
	Represents the concurrent bag collection type.
using	storage_type
	Represents the concurrent bag collection type.

Public Methods
auto	add (const_reference item) -> void override
	Adds an item to the xtd::collections::concurrent::concurrent_bag <type_t>.
auto	copy_to (xtd::array< value_type > &array, xtd::usize array_index) const -> void override
	Copies the elements of the xtd::collections::concurrent::concurrent_bag <type_t> to an xtd::array, starting at a particular xtd::array index.
auto	get_enumerator () const -> xtd::collections::generic::enumerator< value_type > override
	Returns an enumerator that iterates through a collection.
auto	to_array () const -> xtd::array< value_type > override
	Copies the elements contained in the xtd::collections::concurrent::concurrent_bag <type_t> to a new array.
auto	to_string () const noexcept -> xtd::string override
	Returns a xtd::string that represents the current object.
auto	try_add (const_reference item) -> bool override
	Attempts to add an object to the xtd::collections::concurrent::concurrent_bag <type_t>.
auto	try_peek (reference item) const -> bool
	Attempts to return an object from the xtd::collections::concurrent::concurrent_bag <type_t> without removing it.
auto	try_take (reference item) -> bool override
	Attempts to remove and return an object from the xtd::collections::concurrent::concurrent <type_t>.

Public Conctructors
	concurrent_bag ()=default
	Initializes a new instance of the xtd::collections::concurrent::concurrent_bag <type_t> class.
	concurrent_bag (std::initializer_list< type_t > items)
	Constructs the container with the contents of the specified initializer list, and allocator.
	concurrent_bag (const xtd::collections::generic::ienumerable< value_type > &collection)
	Initializes a new instance of the xtd::collections::concurrent::concurrent_bag <type_t> class that contains elements copied from the specified collection.

Public Properties
auto	count () const noexcept -> xtd::usize override
	Gets the number of elements contained in the xtd::collections::generic::icollection.
auto	is_empty () const noexcept -> bool
	Gets a value indicating whether the xtd::collections::concurrent::concurrent_bag <type_t> is emtpy.
auto	is_read_only () const noexcept -> bool override
	Gets a value indicating whether the xtd::collections::concurrent::concurrent_bag <type_t> is read-only.
auto	is_synchronized () const noexcept -> bool override
	Gets a value indicating whether access to the xtd::collections::concurrent::concurrent_bag <type_t> is synchronized (thread safe).

Additional Inherited Members
using	value_type
	Represents the xtd::collections::generic::icollection value type.
using	value_type
	Represents the xtd::collections::generic::ienumerable value type.
using	iterator
	Represents the iterator of xtd::collections::generic::ienumerable value type.
using	const_iterator
	Represents the const iterator of xtd::collections::generic::ienumerable value type.
using	iterator
	Represents the iterator of enumerable value type.
using	const_iterator
	Represents the const iterator of enumerable value type.
using	enumerable_type
	Represents the ienumerable enumerable type.
using	source_type
	Represents the ienumerable source type.
using	ienumerable
	Represents the ienumerable value type.
using	list
	Represents the list value type.
	object ()=default
	Create a new instance of the ultimate base class object.
virtual auto	equals (const object &obj) const noexcept -> bool
	Determines whether the specified object is equal to the current object.
virtual auto	get_hash_code () const noexcept -> xtd::usize
	Serves as a hash function for a particular type.
virtual auto	get_type () const noexcept -> type_object
	Gets the type of the current instance.
template<typename object_t>
auto	memberwise_clone () const -> xtd::unique_ptr_object< object_t >
	Creates a shallow copy of the current object.
virtual auto	copy_to (xtd::array< type_t > &array, xtd::usize array_index) const -> void=0
	Copies the elements of the xtd::collections::generic::icollection <type_t> to an xtd::array, starting at a particular xtd::array index.
virtual auto	try_add (const type_t &item) -> bool=0
	Attempts to add an object to the xtd::collections::concurrent::iproducer_consumer_collection <type_t>.
virtual auto	try_take (type_t &item) -> bool=0
	Attempts to remove and return an object from the xtd::collections::concurrent::iproducer_consumer_collection <type_t>.
virtual auto	add (const type_t &item) -> void=0
	Adds an item to the xtd::collections::generic::icollection <type_t>.
virtual auto	contains (const type_t &item) const noexcept -> bool=0
	Determines whether the xtd::collections::generic::icollection <type_t> contains a specific value.
virtual auto	remove (const type_t &item) -> bool=0
	Removes the first occurrence of a specific object from the xtd::collections::generic::icollection <type_t>.
virtual auto	begin () const -> const_iterator
	Returns an iterator to the first element of the enumerable.
virtual auto	cbegin () const -> const_iterator
	Returns an iterator to the first element of the enumerable.
virtual auto	cend () const -> const_iterator
	Returns an iterator to the element following the last element of the enumerable.
virtual auto	end () const -> const_iterator
	Returns an iterator to the element following the last element of the enumerable.
auto	aggregate (const std::function< type_t(const type_t &, const type_t &)> &funcfunc) const -> type_t
	Applies an accumulator function over a sequence.
auto	all (const std::function< bool(const type_t &)> &predicatepredicate) const -> bool
	Determines whether all elements of a sequence satisfy a condition.
auto	any () const noexcept -> bool
	Determines whether a sequence contains any elements.
auto	append (const type_t &element) const noexcept
	Appends a value to the end of the sequence.
auto	as_enumerable () const noexcept
	Returns the input typed as xtd::collections::generic::ienumerable <type_t>.
auto	average () const noexcept
	Computes the average of a sequence of source_t values.
auto	cast () const noexcept
	Casts the elements of an xtd::collections::generic::ienumerable to the specified type.
auto	chunk (xtd::usize size) const
	Splits the elements of a sequence into chunks of size at most size.
auto	concat (const ienumerable< type_t > &second) const noexcept
	Concatenates two sequences.
auto	contains (const type_t &value) const noexcept -> bool
	Determines whether a sequence contains a specified element by using the default equality comparer.
auto	count () const noexcept -> xtd::usize
	Returns the number of elements in current sequence.
auto	count_by (const std::function< key_t(const type_t &)> &key_selector) const noexcept
	Returns the count of elements in the current sequence grouped by key.
auto	default_if_empty () const noexcept
	Returns the elements of the specified sequence or the type parameter's default value in a singleton collection if the current sequence is empty.
auto	distinct () const noexcept
	Returns distinct elements from a sequence by using the default equality comparer to compare values.
auto	first_or_default (const std::function< bool(const type_t &)> &predicatepredicate, const type_t &default_value) const noexcept -> type_t
	Returns the first element of the sequence that satisfies a condition, or a specified default value if no such element is found.
auto	order () const
	Sorts the elements of a sequence in ascending order.
auto	order_by (const std::function< type_t(const type_t &)> &key_selector) const
	Sorts the elements of a sequence in ascending order according to a key.
auto	order_by_descending (const std::function< key_t(const type_t &)> &key_selector) const
	Sorts the elements of a sequence in descending order according to a key.
auto	select (auto &&selector) const
	Projects each element of a sequence into a new form.
auto	to_array () const noexcept -> xtd::array< type_t >
	Creates a xtd::array <type_t> from an xtd::collections::generic::ienumerable <type_t>.
auto	to_list () const noexcept -> xtd::collections::generic::list< type_t >
	Creates a xtd::collections::generic::list <type_t> from an xtd::collections::generic::ienumerable <type_t>.
auto	where (auto &&predicatepredicate) const
	Filters a sequence of values based on a predicate.
virtual auto	empty () const noexcept -> bool
	Checks whether the container is empty.
virtual auto	size () const noexcept -> xtd::usize
	Gets the number of elements contained in the xtd::collections::generic::icollection <type_t>.
virtual auto	operator<< (const type_t &item) -> icollection< type_t > &
	The shift left operator adds an item to the xtd::collections::generic::icollection <type_t>.
virtual auto	operator>> (const type_t &item) -> icollection< type_t > &
	The shift right operator removes the first occurrence of a specific object from the xtd::collections::generic::icollection <type_t>.
template<typename object_a_t, typename object_b_t>
static auto	equals (const object_a_t &object_a, const object_b_t &object_b) noexcept -> bool
	Determines whether the specified object instances are considered equal.
template<typename object_a_t, typename object_b_t>
static auto	reference_equals (const object_a_t &object_a, const object_b_t &object_b) noexcept -> bool
	Determines whether the specified object instances are the same instance.
static auto	to_const_iterator (typename source_collection_t::const_iterator &value, const source_collection_t &source_collection, const target_collection_t &target_collection) noexcept -> typename target_collection_t::const_iterator
	Converts source iterator to target iterator.
static auto	to_iterator (typename source_collection_t::const_iterator &value, const source_collection_t &source_collection, const target_collection_t &target_collection) noexcept -> typename target_collection_t::const_iterator
	Converts source iterator to target iterator.

Member Typedef Documentation

value_type

template<typename type_t>

using xtd::collections::concurrent::concurrent_bag< type_t >::value_type

Represents the concurrent bag value type.

reference

template<typename type_t>

using xtd::collections::concurrent::concurrent_bag< type_t >::reference

Represents the reference of list value type.

const_reference

template<typename type_t>

using xtd::collections::concurrent::concurrent_bag< type_t >::const_reference

Represents the const reference of list value type.

collection_type

template<typename type_t>

using xtd::collections::concurrent::concurrent_bag< type_t >::collection_type

Represents the concurrent bag collection type.

local_storage_type

template<typename type_t>

using xtd::collections::concurrent::concurrent_bag< type_t >::local_storage_type

Represents the concurrent bag collection type.

storage_type

template<typename type_t>

using xtd::collections::concurrent::concurrent_bag< type_t >::storage_type

Represents the concurrent bag collection type.

Constructor & Destructor Documentation

concurrent_bag() [1/3]

template<typename type_t>

xtd::collections::concurrent::concurrent_bag< type_t >::concurrent_bag ( )

default

Initializes a new instance of the xtd::collections::concurrent::concurrent_bag <type_t> class.

concurrent_bag() [2/3]

template<typename type_t>

xtd::collections::concurrent::concurrent_bag< type_t >::concurrent_bag ( std::initializer_list< type_t > items )

inline

Constructs the container with the contents of the specified initializer list, and allocator.

Parameters

items

The initializer list to initialize the elements of the container with.

concurrent_bag() [3/3]

template<typename type_t>

xtd::collections::concurrent::concurrent_bag< type_t >::concurrent_bag ( const xtd::collections::generic::ienumerable< value_type > & collection )

inline

Initializes a new instance of the xtd::collections::concurrent::concurrent_bag <type_t> class that contains elements copied from the specified collection.

Member Function Documentation

count()

template<typename type_t>

auto xtd::collections::concurrent::concurrent_bag< type_t >::count ( ) const -> xtd::usize

inlinenodiscardoverridevirtualnoexcept

Gets the number of elements contained in the xtd::collections::generic::icollection.

Returns

The number of elements contained in the xtd::collections::generic::icollection.

Implements xtd::collections::concurrent::iproducer_consumer_collection< type_t >.

is_empty()

template<typename type_t>

auto xtd::collections::concurrent::concurrent_bag< type_t >::is_empty ( ) const -> bool

inlinenodiscardnoexcept

Gets a value indicating whether the xtd::collections::concurrent::concurrent_bag <type_t> is emtpy.

Returns

true if the xtd::collections::concurrent::concurrent_bag <type_t> is empty; otherwise, false.

is_read_only()

template<typename type_t>

auto xtd::collections::concurrent::concurrent_bag< type_t >::is_read_only ( ) const -> bool

inlinenodiscardoverridevirtualnoexcept

Gets a value indicating whether the xtd::collections::concurrent::concurrent_bag <type_t> is read-only.

Returns

true if the xtd::collections::concurrent::concurrent_bag <type_t> is read-only; otherwise, false.

Remarks

A collection that is read-only does not allow the addition or removal of elements after the collection is created. Note that read-only in this context does not indicate whether individual elements of the collection can be modified, since the xtd::collections::concurrent::concurrent_bag <type_t> interface only supports addition and removal operations. For example, the xtd::collections::concurrent::concurrent_bag::is_read_only property of an array that is cast or converted to an xtd::collections::concurrent::concurrent_bag <type_t> object returns true, even though individual array elements can be modified.

Implements xtd::collections::generic::icollection< type_t >.

is_synchronized()

template<typename type_t>

auto xtd::collections::concurrent::concurrent_bag< type_t >::is_synchronized ( ) const -> bool

inlinenodiscardoverridevirtualnoexcept

Gets a value indicating whether access to the xtd::collections::concurrent::concurrent_bag <type_t> is synchronized (thread safe).

Returns

true if access to the ICollection is synchronized (thread safe); otherwise, false.

Remarks

xtd::collections::concurrent::iproducer_consumer_collection::sync_root returns an object, which can be used to synchronize access to the xtd::collections::generic::icollection.

Most collection classes in the xtd::collections namespace also implement a Synchronized method, which provides a synchronized wrapper around the underlying collection.

Enumerating through a collection is intrinsically not a thread-safe procedure. Even when a collection is synchronized, other threads can still modify the collection, which causes the enumerator to throw an exception. To guarantee thread safety during enumeration, you can either lock the collection during the entire enumeration or catch the exceptions resulting from changes made by other threads.

The following code example shows how to lock the collection using the xtd::collections::concurrent::iproducer_consumer_collection::sync_root property during the entire enumeration.

icollection& my_collection = some_collection;
lock(my_collection.sync_root()) {
  for (const auto& item : my_collection) {
    // Insert your code here.
  }
}

Implements xtd::collections::concurrent::iproducer_consumer_collection< type_t >.

add()

template<typename type_t>

auto xtd::collections::concurrent::concurrent_bag< type_t >::add ( const_reference item ) -> void

inlineoverride

Adds an item to the xtd::collections::concurrent::concurrent_bag <type_t>.

Parameters

item	The object to add to the xtd::collections::concurrent::concurrent_bag <type_t>.

Exceptions

xtd::not_supported_exception

The xtd::collections::concurrent::concurrent_bag <type_t> is read-only.

copy_to()

template<typename type_t>

auto xtd::collections::concurrent::concurrent_bag< type_t >::copy_to ( xtd::array< value_type > & array, xtd::usize array_index ) const -> void

inlineoverride

Copies the elements of the xtd::collections::concurrent::concurrent_bag <type_t> to an xtd::array, starting at a particular xtd::array index.

Parameters

array	The one-dimensional xtd::array that is the destination of the elements copied from xtd::collections::concurrent::concurrent_bag <type_t>. The xtd::array must have zero-based indexing.
array_index	The zero-based index in array at which copying begins.

Exceptions

xtd::argument_exception

The number of elements in the source xtd::collections::concurrent::concurrent_bag <type_t> is greater than the available space from `array_index` to the end of the destination `array`.

get_enumerator()

template<typename type_t>

auto xtd::collections::concurrent::concurrent_bag< type_t >::get_enumerator ( ) const -> xtd::collections::generic::enumerator< value_type >

inlinenodiscardoverridevirtual

Returns an enumerator that iterates through a collection.

Returns

An xtd::collections::generic::enumerator object that can be used to iterate through the collection.

Implements xtd::collections::concurrent::iproducer_consumer_collection< type_t >.

to_array()

template<typename type_t>

auto xtd::collections::concurrent::concurrent_bag< type_t >::to_array ( ) const -> xtd::array< value_type >

inlinenodiscardoverridevirtual

Copies the elements contained in the xtd::collections::concurrent::concurrent_bag <type_t> to a new array.

Returns

A new array containing the elements copied from the xtd::collections::concurrent::iproducer_consumer_collection <type_t.

Remarks

The method provides a snapshot of the underlying collection. It is possible for other threads to add or remove items immediately after the array is made.

Implements xtd::collections::concurrent::iproducer_consumer_collection< type_t >.

to_string()

template<typename type_t>

auto xtd::collections::concurrent::concurrent_bag< type_t >::to_string ( ) const -> xtd::string

inlinenodiscardoverridevirtualnoexcept

Returns a xtd::string that represents the current object.

Returns

A string that represents the current object.

Reimplemented from xtd::object.

try_add()

template<typename type_t>

auto xtd::collections::concurrent::concurrent_bag< type_t >::try_add ( const_reference item ) -> bool

inlineoverride

Attempts to add an object to the xtd::collections::concurrent::concurrent_bag <type_t>.

Parameters

item	The object to add to the xtd::collections::concurrent::iproducer_consumer_collection <type_t>.

Returns

true if the object was added successfully; otherwise, false. @exceprion xtd::argument_exception The item was invalid for this collection.

try_peek()

template<typename type_t>

auto xtd::collections::concurrent::concurrent_bag< type_t >::try_peek ( reference item ) const -> bool

inline

Attempts to return an object from the xtd::collections::concurrent::concurrent_bag <type_t> without removing it.

Parameters

item	When this method returns, result contains an object from the ConcurrentBag<T> or the default value of T if the operation failed.

Returns

true if an object was returned successfully; otherwise, false.

try_take()

template<typename type_t>

auto xtd::collections::concurrent::concurrent_bag< type_t >::try_take ( reference item ) -> bool

inlineoverride

Attempts to remove and return an object from the xtd::collections::concurrent::concurrent <type_t>.

Parameters

item	When this method returns, if the object was removed and returned successfully, item contains the removed object. If no object was available to be removed, the value is unspecified.

Returns

true if an object was removed and returned successfully; otherwise, false.

---

The documentation for this class was generated from the following file:

• xtd.core/include/xtd/collections/concurrent/concurrent_bag.hpp