Package org.jcsp.util

Class BufferSizeError

  • All Implemented Interfaces:
    Serializable

    public class BufferSizeError
    extends Error
    This is thrown if an attempt is made to create some variety of buffered channel with a zero or negative sized buffer.

    Description

    Buffered channels must have (usually non-zero) positive sized buffers. The following constructions will all throw this Error:
       One2OneChannel c = Channel.one2one (new Buffer (-42));                 // must be >= 0
       One2OneChannel c = Channel.one2one (new OverFlowingBuffer (-42));      // must be > 0
       One2OneChannel c = Channel.one2one (new OverWriteOldestBuffer (-42));  // must be > 0
       One2OneChannel c = Channel.one2one (new OverWritingBuffer (-42));      // must be > 0
       One2OneChannel c = Channel.one2one (new InfiniteBuffer (-42));         // must be > 0
     
    Zero-buffered non-overwriting channels are, of course, the default channel semantics. The following constructions are all legal and equivalent:
       One2OneChannel c = Channel.one2one ();
       One2OneChannel c = Channel.one2one (new ZeroBuffer ());    // less efficient
       One2OneChannel c = Channel.one2one (new Buffer (0));       // less efficient
     
    No action should be taken to catch BufferSizeError. Application code generating it is in error and needs correcting.
    Author:
    P.H. Welch
    See Also:
    Serialized Form
    • Constructor Detail

      • BufferSizeError

        public BufferSizeError​(String s)