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:
  • Constructor Details

    • BufferSizeError

      public BufferSizeError(String s)