/* * 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; /** * Simple implementation of a stack. * * @param * The datatype stored in the stack. * * @author Ben Culkin */ public class SimpleStack extends Stack { /* Our backing stack. */ private final Deque backing; /** Create a new empty stack. */ public SimpleStack() { backing = new LinkedList<>(); } @Override public void push(final T elm) { backing.push(elm); } @Override public T pop() { if (backing.isEmpty()) throw new StackUnderflow(); return backing.pop(); } @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; } @Override @SuppressWarnings("unchecked") public T[] toArray() { return (T[]) backing.toArray(); } @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 SimpleStack)) return false; final SimpleStack other = (SimpleStack) obj; if (backing == null) { if (other.backing != null) return false; } else if (!backing.equals(other.backing)) { return false; } return true; } @Override public String toString() { return String.format("SimpleStack [backing=%s]", backing); } }