/*
* esodata - data structures and other things, of varying utility
* Copyright 2022, Ben Culkin
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see .
*/
package bjc.esodata;
import java.util.Deque;
import java.util.LinkedList;
/**
* A FIFO implementation of a stack.
*
* Basically, a stack that actually acts like a queue.
*
* @param
* The datatype stored in the stack.
*
* @author Ben Culkin
*/
public class QueueStack extends Stack {
/* Our backing queue. */
private final Deque backing;
/** Create a new empty stack queue. */
public QueueStack() {
backing = new LinkedList<>();
}
@Override
public void push(final T elm) {
backing.add(elm);
}
@Override
public T pop() {
if (backing.isEmpty()) throw new StackUnderflow();
return backing.remove();
}
@Override
public T top() {
if (backing.isEmpty()) throw new StackUnderflow();
return backing.peek();
}
@Override
public int size() {
return backing.size();
}
@Override
public boolean isEmpty() {
return backing.size() == 0;
}
@SuppressWarnings("unchecked")
@Override
public T[] toArray() {
return (T[]) backing.toArray();
}
@Override
public String toString() {
return String.format("QueueStack [backing=%s]", backing);
}
@Override
public int hashCode() {
final int prime = 31;
int result = 1;
result = prime * result + (backing == null ? 0 : backing.hashCode());
return result;
}
@Override
public boolean equals(final Object obj) {
if (this == obj) return true;
if (obj == null) return false;
if (!(obj instanceof QueueStack>)) return false;
final QueueStack> other = (QueueStack>) obj;
if (backing == null) {
if (other.backing != null) return false;
} else if (!backing.equals(other.backing)) {
return false;
}
return true;
}
}