Package org.jcsp.util

Class InfiniteBuffer<T>

    • Constructor Detail

      • InfiniteBuffer

        public InfiniteBuffer()
        Construct a new InfiniteBuffer with the default size (of 8).
      • InfiniteBuffer

        public InfiniteBuffer​(int initialSize)
        Construct a new InfiniteBuffer with the specified initial size.
        Parameters:
        initialSize - the number of Objects the InfiniteBuffer can initially store.
        Throws:
        BufferSizeError - if size is zero or negative. Note: no action should be taken to try/catch this exception - application code generating it is in error and needs correcting.
    • Method Detail

      • get

        public T get()
        Returns the oldest Object from the InfiniteBuffer and removes it.

        Pre-condition: getState must not currently return EMPTY.

        Specified by:
        get in interface ChannelDataStore<T>
        Returns:
        the oldest Object from the InfiniteBuffer
      • startGet

        public T startGet()
        Returns the oldest object from the buffer but does not remove it. Pre-condition: getState must not currently return EMPTY.
        Specified by:
        startGet in interface ChannelDataStore<T>
        Returns:
        the oldest Object from the Buffer
        See Also:
        ChannelDataStore.endGet()
      • put

        public void put​(T value)
        Puts a new Object into the InfiniteBuffer.

        Implementation note: if InfiniteBuffer is full, a new internal buffer with double the capacity is constructed and the old data copied across.

        Specified by:
        put in interface ChannelDataStore<T>
        Parameters:
        value - the Object to put into the InfiniteBuffer
      • getState

        public int getState()
        Returns the current state of the InfiniteBuffer.
        Specified by:
        getState in interface ChannelDataStore<T>
        Returns:
        the current state of the InfiniteBuffer (EMPTY or NONEMPTYFULL)
      • clone

        public Object clone()
        Returns a new (and EMPTY) InfiniteBuffer with the same creation parameters as this one.

        Note: Only the initial size and structure of the InfiniteBuffer is cloned, not any stored data.

        Specified by:
        clone in interface ChannelDataStore<T>
        Overrides:
        clone in class Object
        Returns:
        the cloned instance of this InfiniteBuffer.