Java tutorial
/******************************************************************************* * Copyright 2011 See AUTHORS file. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. ******************************************************************************/ package com.badlogic.gdx.utils; import java.util.Arrays; import com.badlogic.gdx.math.MathUtils; /** A resizable, ordered or unordered short array. Avoids the boxing that occurs with ArrayList<Short>. If unordered, this class * avoids a memory copy when removing elements (the last element is moved to the removed element's position). * @author Nathan Sweet */ public class ShortArray { public short[] items; public int size; public boolean ordered; /** Creates an ordered array with a capacity of 16. */ public ShortArray() { this(true, 16); } /** Creates an ordered array with the specified capacity. */ public ShortArray(int capacity) { this(true, capacity); } /** @param ordered If false, methods that remove elements may change the order of other elements in the array, which avoids a * memory copy. * @param capacity Any elements added beyond this will cause the backing array to be grown. */ public ShortArray(boolean ordered, int capacity) { this.ordered = ordered; items = new short[capacity]; } /** Creates a new array containing the elements in the specific array. The new array will be ordered if the specific array is * ordered. The capacity is set to the number of elements, so any subsequent elements added will cause the backing array to be * grown. */ public ShortArray(ShortArray array) { this.ordered = array.ordered; size = array.size; items = new short[size]; System.arraycopy(array.items, 0, items, 0, size); } /** Creates a new ordered array containing the elements in the specified array. The capacity is set to the number of elements, * so any subsequent elements added will cause the backing array to be grown. */ public ShortArray(short[] array) { this(true, array, 0, array.length); } /** Creates a new array containing the elements in the specified array. The capacity is set to the number of elements, so any * subsequent elements added will cause the backing array to be grown. * @param ordered If false, methods that remove elements may change the order of other elements in the array, which avoids a * memory copy. */ public ShortArray(boolean ordered, short[] array, int startIndex, int count) { this(ordered, count); size = count; System.arraycopy(array, startIndex, items, 0, count); } /** Casts the specified value to short and adds it. */ public void add(int value) { short[] items = this.items; if (size == items.length) items = resize(Math.max(8, (int) (size * 1.75f))); items[size++] = (short) value; } public void add(short value) { short[] items = this.items; if (size == items.length) items = resize(Math.max(8, (int) (size * 1.75f))); items[size++] = value; } public void addAll(ShortArray array) { addAll(array, 0, array.size); } public void addAll(ShortArray array, int offset, int length) { if (offset + length > array.size) throw new IllegalArgumentException( "offset + length must be <= size: " + offset + " + " + length + " <= " + array.size); addAll(array.items, offset, length); } public void addAll(short... array) { addAll(array, 0, array.length); } public void addAll(short[] array, int offset, int length) { short[] items = this.items; int sizeNeeded = size + length; if (sizeNeeded > items.length) items = resize(Math.max(8, (int) (sizeNeeded * 1.75f))); System.arraycopy(array, offset, items, size, length); size += length; } public short get(int index) { if (index >= size) throw new IndexOutOfBoundsException("index can't be >= size: " + index + " >= " + size); return items[index]; } public void set(int index, short value) { if (index >= size) throw new IndexOutOfBoundsException("index can't be >= size: " + index + " >= " + size); items[index] = value; } public void incr(int index, short value) { if (index >= size) throw new IndexOutOfBoundsException("index can't be >= size: " + index + " >= " + size); items[index] += value; } public void mul(int index, short value) { if (index >= size) throw new IndexOutOfBoundsException("index can't be >= size: " + index + " >= " + size); items[index] *= value; } public void insert(int index, short value) { if (index > size) throw new IndexOutOfBoundsException("index can't be > size: " + index + " > " + size); short[] items = this.items; if (size == items.length) items = resize(Math.max(8, (int) (size * 1.75f))); if (ordered) System.arraycopy(items, index, items, index + 1, size - index); else items[size] = items[index]; size++; items[index] = value; } public void swap(int first, int second) { if (first >= size) throw new IndexOutOfBoundsException("first can't be >= size: " + first + " >= " + size); if (second >= size) throw new IndexOutOfBoundsException("second can't be >= size: " + second + " >= " + size); short[] items = this.items; short firstValue = items[first]; items[first] = items[second]; items[second] = firstValue; } public boolean contains(short value) { int i = size - 1; short[] items = this.items; while (i >= 0) if (items[i--] == value) return true; return false; } public int indexOf(short value) { short[] items = this.items; for (int i = 0, n = size; i < n; i++) if (items[i] == value) return i; return -1; } public int lastIndexOf(char value) { short[] items = this.items; for (int i = size - 1; i >= 0; i--) if (items[i] == value) return i; return -1; } public boolean removeValue(short value) { short[] items = this.items; for (int i = 0, n = size; i < n; i++) { if (items[i] == value) { removeIndex(i); return true; } } return false; } /** Removes and returns the item at the specified index. */ public short removeIndex(int index) { if (index >= size) throw new IndexOutOfBoundsException("index can't be >= size: " + index + " >= " + size); short[] items = this.items; short value = items[index]; size--; if (ordered) System.arraycopy(items, index + 1, items, index, size - index); else items[index] = items[size]; return value; } /** Removes the items between the specified indices, inclusive. */ public void removeRange(int start, int end) { if (end >= size) throw new IndexOutOfBoundsException("end can't be >= size: " + end + " >= " + size); if (start > end) throw new IndexOutOfBoundsException("start can't be > end: " + start + " > " + end); short[] items = this.items; int count = end - start + 1; if (ordered) System.arraycopy(items, start + count, items, start, size - (start + count)); else { int lastIndex = this.size - 1; for (int i = 0; i < count; i++) items[start + i] = items[lastIndex - i]; } size -= count; } /** Removes from this array all of elements contained in the specified array. * @return true if this array was modified. */ public boolean removeAll(ShortArray array) { int size = this.size; int startSize = size; short[] items = this.items; for (int i = 0, n = array.size; i < n; i++) { short item = array.get(i); for (int ii = 0; ii < size; ii++) { if (item == items[ii]) { removeIndex(ii); size--; break; } } } return size != startSize; } /** Removes and returns the last item. */ public short pop() { return items[--size]; } /** Returns the last item. */ public short peek() { return items[size - 1]; } /** Returns the first item. */ public short first() { if (size == 0) throw new IllegalStateException("Array is empty."); return items[0]; } public void clear() { size = 0; } /** Reduces the size of the backing array to the size of the actual items. This is useful to release memory when many items have * been removed, or if it is known that more items will not be added. * @return {@link #items} */ public short[] shrink() { if (items.length != size) resize(size); return items; } /** Increases the size of the backing array to accommodate the specified number of additional items. Useful before adding many * items to avoid multiple backing array resizes. * @return {@link #items} */ public short[] ensureCapacity(int additionalCapacity) { int sizeNeeded = size + additionalCapacity; if (sizeNeeded > items.length) resize(Math.max(8, sizeNeeded)); return items; } protected short[] resize(int newSize) { short[] newItems = new short[newSize]; short[] items = this.items; System.arraycopy(items, 0, newItems, 0, Math.min(size, newItems.length)); this.items = newItems; return newItems; } public void sort() { Arrays.sort(items, 0, size); } public void reverse() { short[] items = this.items; for (int i = 0, lastIndex = size - 1, n = size / 2; i < n; i++) { int ii = lastIndex - i; short temp = items[i]; items[i] = items[ii]; items[ii] = temp; } } public void shuffle() { short[] items = this.items; for (int i = size - 1; i >= 0; i--) { int ii = MathUtils.random(i); short temp = items[i]; items[i] = items[ii]; items[ii] = temp; } } /** Reduces the size of the array to the specified size. If the array is already smaller than the specified size, no action is * taken. */ public void truncate(int newSize) { if (size > newSize) size = newSize; } /** Returns a random item from the array, or zero if the array is empty. */ public short random() { if (size == 0) return 0; return items[MathUtils.random(0, size - 1)]; } public short[] toArray() { short[] array = new short[size]; System.arraycopy(items, 0, array, 0, size); return array; } public boolean equals(Object object) { if (object == this) return true; if (!(object instanceof ShortArray)) return false; ShortArray array = (ShortArray) object; int n = size; if (n != array.size) return false; for (int i = 0; i < n; i++) if (items[i] != array.items[i]) return false; return true; } public String toString() { if (size == 0) return "[]"; short[] items = this.items; StringBuilder buffer = new StringBuilder(32); buffer.append('['); buffer.append(items[0]); for (int i = 1; i < size; i++) { buffer.append(", "); buffer.append(items[i]); } buffer.append(']'); return buffer.toString(); } public String toString(String separator) { if (size == 0) return ""; short[] items = this.items; StringBuilder buffer = new StringBuilder(32); buffer.append(items[0]); for (int i = 1; i < size; i++) { buffer.append(separator); buffer.append(items[i]); } return buffer.toString(); } /** @see #ShortArray(short[]) */ static public ShortArray with(short... array) { return new ShortArray(array); } }