Adds an item to the tail of the Ringbuffer.
Namespace: Hazelcast.Core
Assembly: Hazelcast.Net (in Hazelcast.Net.dll) Version: 3.8.2
Syntax
Parameters
- item
- Type: T
the item to add.
Return Value
Type: Int64the sequence of the added item.
Exceptions
Exception | Condition |
---|---|
ArgumentNullException | if item is null. |
Remarks
Using the sequence as id
This sequence will always be unique for this Ringbuffer instance so it can be used as a unique id generator if you are publishing items on this Ringbuffer. However you need to take care of correctly determining an initial id when any node uses the ringbuffer for the first time. The most reliable way to do that is to write a dummy item into the ringbuffer and use the returned sequence as initial id. On the reading side, this dummy item should be discard. Please keep in mind that this id is not the sequence of the item you are about to publish but from a previously published item. So it can't be used to find that item.See Also