1 files changed, 296 insertions, 0 deletions
diff --git a/BJC-Utils2/src/main/java/bjc/utils/esodata/TapeChanger.java b/BJC-Utils2/src/main/java/bjc/utils/esodata/TapeChanger.java
new file mode 100644
index 0000000..1a07cbb
--- /dev/null
+++ b/BJC-Utils2/src/main/java/bjc/utils/esodata/TapeChanger.java
@@ -0,0 +1,296 @@
+package bjc.utils.esodata;
+
+/**
+ * A tape changer is essentially a tape of tapes.
+ *
+ * It has a current tape that you can do operations to, but also operations to add/remove other tapes.
+ * 
+ * If there is no tape currently loaded into the changer, all the methods will either return null/false.
+ *
+ * @param T The element type of the tapes.
+ */
+public class TapeChanger<T> implements Tape<T> {
+	private Tape<Tape<T>> tapes;
+	private Tape<T>       currentTape;
+
+	/**
+	 * Create a new empty tape changer.
+	 */
+	public TapeChanger() {
+		tapes = new SingleTape<>();
+	}
+
+	/**
+	 * Create a new tape changer with the specified tapes.
+	 *
+	 * The first tape in the list will be mounted.
+	 *
+	 * @param taps The tapes to put in this tape changer.
+	 */
+	public TapeChanger(Tape<T> current, Tape<T>... others) {
+		this();
+
+		tapes.insertBefore(current);
+
+		for(Tape<T> tp : others) {
+			tapes.insertAfter(others);
+			tapes.right();
+		}
+
+		tapes.first();
+		currentTape = tapes.item();
+	}
+
+	/**
+	 * Get the item the tape is currently on.
+	 *
+	 * @return The item the tape is on.
+	 */
+	public T item() {
+		if(currentTape == null) return false;
+
+		return currentTape.item();
+	}
+
+	/**
+	 * Set the item the tape is currently on.
+	 *
+	 * @param itm The new value for the tape item.
+	 */
+	public void item(T itm) {
+		if(currentTape == null) return;
+
+		currentTape.item(itm);
+	}
+
+	/**
+	 * Get the current number of elements in the tape.
+	 *
+	 * @return The current number of elements in the tape.
+	 */
+	public int size() {
+		if(currentTape == null) return 0;
+
+		return currentTape.size();
+	}
+
+	/**
+	 * Insert an element before the current item.
+	 *
+	 * @param itm The item to add.
+	 */
+	public void insertBefore(T itm) {
+		if(currentTape == null) return;
+
+		currentTape.insertBefore(itm);
+	}
+
+	/**
+	 * Insert an element after the current item.
+	 */
+	public void insertAfter(T itm) {
+		if(currentTape == null) return;
+
+		currentTape.insertAfter(itm);
+	}
+
+	/**
+	 * Remove the current element.
+	 * 
+	 * Also moves the cursor back one step if possible to maintain
+	 * relative position, and removes the corresponding item from the non-active side
+	 *
+	 * @return The removed item from the active side.
+	 */
+	public T remove() {
+		if(currentTape == null) return null;
+
+		return currentTape.remove();
+	}
+
+	/**
+	 * Move the cursor to the left-most position.
+	 */
+	public void first() {
+		if(currentTape == null) return;
+
+		currentTape.first();
+	}
+
+	/**
+	 * Move the cursor the right-most position.
+	 */
+	public void last() {
+		if(currentTape == null) return;
+
+		currentTape.last();
+	}
+
+	/**
+	 * Move the cursor one space left.
+	 *
+	 * The cursor can't go past zero.
+	 *
+	 * @return True if the cursor was moved left.
+	 */
+	public boolean left() {
+		return left(1);
+	}
+
+	/**
+	 * Move the cursor the specified amount left.
+	 *
+	 * The cursor can't go past zero.
+	 * Attempts to move the cursor by amounts that would exceed zero
+	 * don't move the cursor at all.
+	 *
+	 * @param amt The amount to attempt to move the cursor left.
+	 *
+	 * @return True if the cursor was moved left.
+	 */
+	public boolean left(int amt) {
+		if(currentTape == null) return false;
+
+		return currentTape.left(amt);
+	}
+
+
+	/**
+	 * Move the cursor one space right.
+	 *
+	 * Moving the cursor right will auto-extend the tape if that is enabled.
+	 *
+	 * @return Whether the cursor was moved right.
+	 */
+	public boolean right() {
+		return right(1);
+	}
+
+	/**
+	 * Move the cursor the specified amount right.
+	 *
+	 * Moving the cursor right will auto-extend the tape if that is enabled.
+	 *
+	 * @param amt The amount to move the cursor right by.
+	 *
+	 * @return Whether the cursor was moved right.
+	 */
+	public boolean right(int amt) {
+		if(currentTape == null) return;
+
+		return currentTape.right(amt);
+	}
+
+	/**
+	 * Flips the tape.
+	 *
+	 * The active side becomes inactive, and the inactive side becomes active.
+	 *
+	 * If the current tape is not double-sided, does nothing.
+	 */
+	public void flip() {
+		if(currentTape == null) return;
+
+		if(currentTape.isDoubleSided()) {
+			((DoubleTape<T>)currentTape).flip();
+		}
+	}
+
+	@Override
+	public boolean isDoubleSided() {
+		if(currentTape == null) return;
+
+		return currentTape.isDoubleSided();
+	}
+
+	/**
+	 * Check if a tape is currently loaded.
+	 *
+	 * @return Whether or not a tape is loaded.
+	 */
+	public boolean isLoaded() {
+		return currentTape != null;
+	}
+
+	/**
+	 * Move to the next tape in the changer.
+	 *
+	 * Attempting to load a tape that isn't there won't eject the current tape.
+	 *
+	 * @return Whether or not the next tape was loaded.
+	 */
+	public boolean nextTape() {
+		boolean succ = tapes.right();
+
+		if(succ) currentTape = tapes.item();
+
+		return succ;
+	}
+
+	/**
+	 * Move to the previous tape in the changer.
+	 *
+	 * Attempting to load a tape that isn't there won't eject the current tape.
+	 *
+	 * @return Whether or not the previous tape was loaded.
+	 */
+	public boolean prevTape() {
+		boolean succ = tapes.left();
+
+		if(succ) currentTape = tapes.item();
+
+		return succ;
+	}
+
+	/**
+	 * Inserts a tape into the tape changer.
+	 *
+	 * Any currently loaded tape is ejected, and becomes the previous tape.
+	 *
+	 * The specified tape is loaded.
+	 *
+	 * @param The tape to insert and load.
+	 */
+	public void insertTape(Tape<T> tp) {
+		tapes.insertAfter(tp);
+		tapes.right();
+		
+		currentTape = tapes.item();
+	}
+
+	/**
+	 * Removes the current tape.
+	 *
+	 * Does nothing if there is not a tape loaded.
+	 *
+	 * Loads the previous tape, if there is one.
+	 *
+	 * @return The removed tape.
+	 */
+	public Tape<T> removeTape() {
+		if(currentTape == null) return null;
+
+		Tape<T> tp = tapes.remove();
+		currentTape = tapes.item();
+
+		return tp;
+	}
+
+	/**
+	 * Ejects the current tape.
+	 *
+	 * Does nothing if no tape is loaded.
+	 */
+	public void eject() {
+		currentTape = null;
+	}
+
+	/**
+	 * Get how many tapes are currently in the changer.
+	 *
+	 * @return How many tapes are currently in the changer.
+	 */
+	public int tapeCount() {
+		return tapes.size();
+	}
+}