jcsp.util.ints
Class BufferIntSizeError

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Error
              |
              +--jcsp.util.ints.BufferIntSizeError

All Implemented Interfaces:

Serializable

public class BufferIntSizeError

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:

   One2OneChannelInt c = One2OneChannelInt.create (new BufferInt (-42));                 // zero allowed
   One2OneChannelInt c = One2OneChannelInt.create (new OverFlowingBufferInt (-42));      // zero not allowed
   One2OneChannelInt c = One2OneChannelInt.create (new OverWriteOldestBufferInt (-42));  // zero not allowed
   One2OneChannelInt c = One2OneChannelInt.create (new OverWritingBufferInt (-42));      // zero not allowed
   One2OneChannelInt c = One2OneChannelInt.create (new InfiniteBufferInt (-42));         // zero not allowed
 

Zero-buffered non-overwriting channels are, of course, the default channel semantics. The following constructions are all legal and equivalent:

   One2OneChannelInt c = new One2OneChannelInt ();
   One2OneChannelInt c = One2OneChannelInt.create (new ZeroBufferInt ());
   One2OneChannelInt c = One2OneChannelInt.create (new BufferInt (0));      // legal but 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 Summary

BufferIntSizeError(String s)

Methods inherited from class java.lang.Throwable

fillInStackTrace, getLocalizedMessage, getMessage, printStackTrace, printStackTrace, printStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

BufferIntSizeError

public BufferIntSizeError(String s)