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 * The element type of the tapes. */ public class TapeChanger implements Tape { private Tape> tapes; private Tape currentTape; /** * Create a new empty tape changer. */ public TapeChanger() { tapes = new SingleTape<>(); } /** * Create a new tape changer with the specified tapes. * * @param current * The tape to mount first. * @param others * The tapes to put in this tape changer. */ @SafeVarargs public TapeChanger(Tape current, Tape... others) { this(); tapes.insertBefore(current); for (Tape tp : others) { tapes.insertAfter(tp); tapes.right(); } tapes.first(); currentTape = tapes.item(); } /** * Get the item the tape is currently on. * * @return The item the tape is on. */ @Override public T item() { if (currentTape == null) return null; return currentTape.item(); } /** * Set the item the tape is currently on. * * @param itm * The new value for the tape item. */ @Override 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. */ @Override public int size() { if (currentTape == null) return 0; return currentTape.size(); } /** * Insert an element before the current item. * * @param itm * The item to add. */ @Override public void insertBefore(T itm) { if (currentTape == null) return; currentTape.insertBefore(itm); } /** * Insert an element after the current item. */ @Override 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. */ @Override public T remove() { if (currentTape == null) return null; return currentTape.remove(); } /** * Move the cursor to the left-most position. */ @Override public void first() { if (currentTape == null) return; currentTape.first(); } /** * Move the cursor the right-most position. */ @Override 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. */ @Override 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. */ @Override 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. */ @Override 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. */ @Override public boolean right(int amt) { if (currentTape == null) return false; 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) currentTape).flip(); } } @Override public boolean isDoubleSided() { if (currentTape == null) return false; 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 tp * The tape to insert and load. */ public void insertTape(Tape 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 removeTape() { if (currentTape == null) return null; Tape 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(); } @Override public int hashCode() { final int prime = 31; int result = 1; result = prime * result + ((currentTape == null) ? 0 : currentTape.hashCode()); result = prime * result + ((tapes == null) ? 0 : tapes.hashCode()); return result; } @Override public boolean equals(Object obj) { if (this == obj) return true; if (obj == null) return false; if (!(obj instanceof TapeChanger)) return false; TapeChanger other = (TapeChanger) obj; if (currentTape == null) { if (other.currentTape != null) return false; } else if (!currentTape.equals(other.currentTape)) return false; if (tapes == null) { if (other.tapes != null) return false; } else if (!tapes.equals(other.tapes)) return false; return true; } @Override public String toString() { return String.format("TapeChanger [tapes=%s, currentTape='%s']", tapes, currentTape); } }