components.standard

Interface Standard<T>

Type Parameters:

T -

All Known Subinterfaces:

BinaryTree<T>, BinaryTreeKernel<T>, LinkedList<T>, LinkedListKernel<T>, Matrix<T>, MatrixKernel<T>, Queue<T>, QueueKernel<T>, Sequence<T>, SequenceKernel<T>, Stack<T>, StackKernel<T>

All Known Implementing Classes:

BinaryTreeNL, BinaryTreeSecondary, DoublyLinkedList, IntegerMatrix, LinkedList1L, LinkedListSecondary, MatrixSecondary, Queue1L, QueueDL, QueueSecondary, Sequence1L, SequenceDL, SequenceSecondary, SinglyLinkedList, Stack1L, StackSecondary, StackSL

public interface Standard<T>

Method Summary

Modifier and Type	Method and Description
void	clear() Resets this to its initial value.
T	newInstance() Returns a new object with the same dynamic type as this, having an initial value.
void	transferFrom(T source) Sets this to the incoming value of source, and resets source to an initial value; the declaration notwithstanding, the dynamic type of source must be the same as the dynamic type of this.

Method Detail

clear

void clear()

Resets this to its initial value.

Clears:

this

transferFrom

void transferFrom(T source)

Sets this to the incoming value of source, and resets source to an initial value; the declaration notwithstanding, the dynamic type of source must be the same as the dynamic type of this. If the type T has a no-argument constructor, then source satisfies the contract of the no-argument constructor for T. If T does not have a no-argument constructor, then source satisfies the contract of the constructor call that was used to initialize #source.

Parameters:

source - object whose value is to be transferred

Clears:

source

Ensures:

this = #source

Replaces:

this

newInstance

T newInstance()

Returns a new object with the same dynamic type as this, having an initial value. If the type T has a no-argument constructor, then the value of the new returned object satisfies the contract of the no-argument constructor for T. If T does not have a no-argument constructor, then the value of the new returned object satisfies the contract of the constructor call that was used to initialize this.

Returns:

new object "like" this with an initial value

Ensures:

is_initial(newInstance)