AddAllAsync Method

AddAllAsync(ICollection<TItem>, OverflowPolicy)

Adds all the items of a collection to the tail of the Ringbuffer.

Declaration

Task<long> AddAllAsync(ICollection<TItem> items, OverflowPolicy overflowPolicy)

Parameters

ICollection<TItem>	items	the batch of items to Add.
OverflowPolicy	overflowPolicy	overflow policy to use

Returns

Task<Int64>

the ICompletableFuture to synchronize on completion.

Remarks

Adds all the items of a collection to the tail of the Ringbuffer. A addAll is likely to outperform multiple calls to due to better io utilization and a reduced number of executed operations. If the batch is empty, the call is ignored. When the collection is not empty, the content is copied into a different data-structure. This means that:

1. after this call completes, the collection can be re-used.
2. the collection doesn't need to be serializable

If the collection is larger than the capacity of the ringbuffer, then the items that were written first will be overwritten. Therefor this call will not block. The items are inserted in the order of the Iterator of the collection. If an addAll is executed concurrently with an Add or addAll, no guarantee is given that items are contiguous. The result of the future contains the sequenceId of the last written item

Exceptions

ArgumentNullException	if batch is null, or if an item in this batch is null or if overflowPolicy is null
ArgumentException	if collection is empty