li.cil.tis3d.common.module.execution.target

Class NilTargetInterface

java.lang.Object

li.cil.tis3d.common.module.execution.target.NilTargetInterface

All Implemented Interfaces:

TargetInterface

public final class NilTargetInterface
extends java.lang.Object

Interface for the Target.NIL target.

Provides instant read and write on the virtual NIL register, which will always return 0 when read, and silently consume all values written to it.

Constructor Summary

Constructors

Constructor and Description
NilTargetInterface(Machine machine)

Method Summary

Modifier and Type	Method and Description
void	beginRead() Begin a reading operation on the target.
boolean	beginWrite(short value) Begin a writing operation on the target.
boolean	canTransfer() Whether the target can transfer data, i.e.
protected Machine	getMachine()
protected MachineState	getState()
boolean	isReading() Whether the target is currently being read from.
boolean	isWriting() Whether the target is currently being written to.
short	read() Finish a read operation by fetching the data made available from the represented target.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface li.cil.tis3d.common.module.execution.target.TargetInterface

onBeforeWriteComplete

Constructor Detail

NilTargetInterface

public NilTargetInterface(Machine machine)

Method Detail

beginWrite

public boolean beginWrite(short value)

Description copied from interface: TargetInterface

Begin a writing operation on the target.

Make sure not to call this if the target is already being written to, or an exception will be thrown. Use TargetInterface.isWriting() to check for this.

Parameters:

value - the value to write to the target.

Returns:

true if the operation finished synchronously, false otherwise.

isWriting

public boolean isWriting()

Description copied from interface: TargetInterface

Whether the target is currently being written to.

This is true as soon as TargetInterface.beginWrite(short) was called and until TargetInterface.read() was called to finish or cancel the operation, unless the operation was completed synchronously, in which case TargetInterface.beginWrite(short) returned true.

Returns:

whether the target is currently being written to.

beginRead

public void beginRead()

Description copied from interface: TargetInterface

Begin a reading operation on the target.

Make sure not to call this if the target is already being read from, or an exception will be thrown. Use TargetInterface.isReading() to check for this.

isReading

public boolean isReading()

Description copied from interface: TargetInterface

Whether the target is currently being read from.

This is true as soon as TargetInterface.beginRead() was called and until TargetInterface.read() was called to finish the operation.

Returns:

whether the target is currently being read from.

canTransfer

public boolean canTransfer()

Description copied from interface: TargetInterface

Whether the target can transfer data, i.e. TargetInterface.read() can be called.

Note that this is not equivalent to TargetInterface.isReading() && TargetInterface.isWriting(). Depending on the target type, this may be only true in the first update after that has been true and later, but it may also be true right away or always.

Returns:

whether the target can now transfer data.

read

public short read()

Description copied from interface: TargetInterface

Finish a read operation by fetching the data made available from the represented target.

Make sure not to call this if the target is not in the correct state, or an exception will be thrown. use TargetInterface.canTransfer() to check for this.

Returns:

the value transferred through the target.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getMachine

protected Machine getMachine()

getState

protected MachineState getState()