net.datastructures

Class LinkedBinaryTree<E>

java.lang.Object

net.datastructures.LinkedBinaryTree<E>

All Implemented Interfaces:

BinaryTree<E>, Tree<E>

Direct Known Subclasses:

BinarySearchTree

public class LinkedBinaryTree<E>
extends java.lang.Object
implements BinaryTree<E>

An implementation of the BinaryTree interface by means of a linked structure. //end#fragment LinkedBinaryTree This class serves as a superclass for the BinarySearchTree implementation. This design decision was made to emphasize the conceptual relationship that a BinarySearchTree is a specialized LinkedBinaryTree. An unwanted side-effect of this is that the size method returns the number of total nodes whereas the size method in the BinarySearchTree class returns the number of internal nodes only. For this reason, the the size variable instead of the size method is used within this class.

See Also:

//begin#fragment LinkedBinaryTree

Constructor Summary

Constructors

Constructor and Description
LinkedBinaryTree() Creates an empty binary tree.

Method Summary

Modifier and Type	Method and Description
Position<E>	addRoot(E e) Adds a root node to an empty tree
void	attach(Position<E> v, BinaryTree<E> T1, BinaryTree<E> T2) Attaches two trees to be subtrees of an external node.
java.lang.Iterable<Position<E>>	children(Position<E> v) Returns an iterable collection of the children of a node.
void	expandExternal(Position<E> v, E l, E r) Expand an external node into an internal node with two external node children
boolean	hasLeft(Position<E> v) Returns whether a node has a left child.
boolean	hasRight(Position<E> v) Returns whether a node has a right child.
Position<E>	insertLeft(Position<E> v, E e) Inserts a left child at a given node.
Position<E>	insertRight(Position<E> v, E e) Inserts a right child at a given node.
boolean	isEmpty() Returns whether the tree is empty.
boolean	isExternal(Position<E> v) Returns whether a node is external.
boolean	isInternal(Position<E> v) Returns whether a node is internal.
boolean	isRoot(Position<E> v) Returns whether a node is the root.
java.util.Iterator<E>	iterator() Returns an iterator of the elements stored at the nodes
Position<E>	left(Position<E> v) Returns the left child of a node.
Position<E>	parent(Position<E> v) Returns the parent of a node.
java.lang.Iterable<Position<E>>	positions() Returns an iterable collection of the tree nodes.
E	remove(Position<E> v) Removes a node with zero or one child.
void	removeAboveExternal(Position<E> v) Remove an external node v and replace its parent with v's sibling
E	replace(Position<E> v, E o) Replaces the element at a node.
Position<E>	right(Position<E> v) Returns the right child of a node.
Position<E>	root() Returns the root of the tree.
Position<E>	sibling(Position<E> v) Return the sibling of a node
int	size() Returns the number of nodes in the tree.
void	swapElements(Position<E> v, Position<E> w) Swap the elements at two nodes

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LinkedBinaryTree

public LinkedBinaryTree()

Creates an empty binary tree.

Method Detail

addRoot

public Position<E> addRoot(E e)
                    throws NonEmptyTreeException

Adds a root node to an empty tree

Throws:

NonEmptyTreeException

attach

public void attach(Position<E> v,
                   BinaryTree<E> T1,
                   BinaryTree<E> T2)
            throws InvalidPositionException

Attaches two trees to be subtrees of an external node.

Throws:

InvalidPositionException

children

public java.lang.Iterable<Position<E>> children(Position<E> v)
                                         throws InvalidPositionException

Returns an iterable collection of the children of a node.

Specified by:

children in interface Tree<E>

Throws:

InvalidPositionException

expandExternal

public void expandExternal(Position<E> v,
                           E l,
                           E r)
                    throws InvalidPositionException

Expand an external node into an internal node with two external node children

Throws:

InvalidPositionException

hasLeft

public boolean hasLeft(Position<E> v)
                throws InvalidPositionException

Returns whether a node has a left child.

Specified by:

hasLeft in interface BinaryTree<E>

Throws:

InvalidPositionException

hasRight

public boolean hasRight(Position<E> v)
                 throws InvalidPositionException

Returns whether a node has a right child.

Specified by:

hasRight in interface BinaryTree<E>

Throws:

InvalidPositionException

insertLeft

public Position<E> insertLeft(Position<E> v,
                              E e)
                       throws InvalidPositionException

Inserts a left child at a given node.

Throws:

InvalidPositionException

insertRight

public Position<E> insertRight(Position<E> v,
                               E e)
                        throws InvalidPositionException

Inserts a right child at a given node.

Throws:

InvalidPositionException

isEmpty

public boolean isEmpty()

Returns whether the tree is empty.

Specified by:

isEmpty in interface Tree<E>

isExternal

public boolean isExternal(Position<E> v)
                   throws InvalidPositionException

Returns whether a node is external.

Specified by:

isExternal in interface Tree<E>

Throws:

InvalidPositionException

isInternal

public boolean isInternal(Position<E> v)
                   throws InvalidPositionException

Returns whether a node is internal.

Specified by:

isInternal in interface Tree<E>

Throws:

InvalidPositionException

isRoot

public boolean isRoot(Position<E> v)
               throws InvalidPositionException

Returns whether a node is the root.

Specified by:

isRoot in interface Tree<E>

Throws:

InvalidPositionException

iterator

public java.util.Iterator<E> iterator()

Returns an iterator of the elements stored at the nodes

Specified by:

iterator in interface Tree<E>

left

public Position<E> left(Position<E> v)
                 throws InvalidPositionException,
                        BoundaryViolationException

Returns the left child of a node.

Specified by:

left in interface BinaryTree<E>

Throws:

InvalidPositionException

BoundaryViolationException

parent

public Position<E> parent(Position<E> v)
                   throws InvalidPositionException,
                          BoundaryViolationException

Returns the parent of a node.

Specified by:

parent in interface Tree<E>

Throws:

InvalidPositionException

BoundaryViolationException

positions

public java.lang.Iterable<Position<E>> positions()

Returns an iterable collection of the tree nodes.

Specified by:

positions in interface Tree<E>

remove

public E remove(Position<E> v)
         throws InvalidPositionException

Removes a node with zero or one child.

Throws:

InvalidPositionException

removeAboveExternal

public void removeAboveExternal(Position<E> v)
                         throws InvalidPositionException

Remove an external node v and replace its parent with v's sibling

Throws:

InvalidPositionException

replace

public E replace(Position<E> v,
                 E o)
          throws InvalidPositionException

Replaces the element at a node.

Specified by:

replace in interface Tree<E>

Throws:

InvalidPositionException

right

public Position<E> right(Position<E> v)
                  throws InvalidPositionException,
                         BoundaryViolationException

Returns the right child of a node.

Specified by:

right in interface BinaryTree<E>

Throws:

InvalidPositionException

BoundaryViolationException

root

public Position<E> root()
                 throws EmptyTreeException

Returns the root of the tree.

Specified by:

root in interface Tree<E>

Throws:

EmptyTreeException

sibling

public Position<E> sibling(Position<E> v)
                    throws InvalidPositionException,
                           BoundaryViolationException

Return the sibling of a node

Throws:

InvalidPositionException

BoundaryViolationException

size

public int size()

Returns the number of nodes in the tree.

Specified by:

size in interface Tree<E>

swapElements

public void swapElements(Position<E> v,
                         Position<E> w)
                  throws InvalidPositionException

Swap the elements at two nodes

Throws:

InvalidPositionException