ArrayUtils.java revision 874d0d4032dc940327a81359f144d38d3cb580a3
1/* 2 * Copyright (C) 2006 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17package com.android.internal.util; 18 19import dalvik.system.VMRuntime; 20import libcore.util.EmptyArray; 21 22import java.lang.reflect.Array; 23 24/** 25 * ArrayUtils contains some methods that you can call to find out 26 * the most efficient increments by which to grow arrays. 27 */ 28public class ArrayUtils 29{ 30 private static final int CACHE_SIZE = 73; 31 private static Object[] sCache = new Object[CACHE_SIZE]; 32 33 private ArrayUtils() { /* cannot be instantiated */ } 34 35 public static byte[] newUnpaddedByteArray(int minLen) { 36 return (byte[])VMRuntime.getRuntime().newUnpaddedArray(byte.class, minLen); 37 } 38 39 public static char[] newUnpaddedCharArray(int minLen) { 40 return (char[])VMRuntime.getRuntime().newUnpaddedArray(char.class, minLen); 41 } 42 43 public static int[] newUnpaddedIntArray(int minLen) { 44 return (int[])VMRuntime.getRuntime().newUnpaddedArray(int.class, minLen); 45 } 46 47 public static boolean[] newUnpaddedBooleanArray(int minLen) { 48 return (boolean[])VMRuntime.getRuntime().newUnpaddedArray(boolean.class, minLen); 49 } 50 51 public static long[] newUnpaddedLongArray(int minLen) { 52 return (long[])VMRuntime.getRuntime().newUnpaddedArray(long.class, minLen); 53 } 54 55 public static float[] newUnpaddedFloatArray(int minLen) { 56 return (float[])VMRuntime.getRuntime().newUnpaddedArray(float.class, minLen); 57 } 58 59 public static Object[] newUnpaddedObjectArray(int minLen) { 60 return (Object[])VMRuntime.getRuntime().newUnpaddedArray(Object.class, minLen); 61 } 62 63 @SuppressWarnings("unchecked") 64 public static <T> T[] newUnpaddedArray(Class<T> clazz, int minLen) { 65 return (T[])VMRuntime.getRuntime().newUnpaddedArray(clazz, minLen); 66 } 67 68 /** 69 * Checks if the beginnings of two byte arrays are equal. 70 * 71 * @param array1 the first byte array 72 * @param array2 the second byte array 73 * @param length the number of bytes to check 74 * @return true if they're equal, false otherwise 75 */ 76 public static boolean equals(byte[] array1, byte[] array2, int length) { 77 if (length < 0) { 78 throw new IllegalArgumentException(); 79 } 80 81 if (array1 == array2) { 82 return true; 83 } 84 if (array1 == null || array2 == null || array1.length < length || array2.length < length) { 85 return false; 86 } 87 for (int i = 0; i < length; i++) { 88 if (array1[i] != array2[i]) { 89 return false; 90 } 91 } 92 return true; 93 } 94 95 /** 96 * Returns an empty array of the specified type. The intent is that 97 * it will return the same empty array every time to avoid reallocation, 98 * although this is not guaranteed. 99 */ 100 @SuppressWarnings("unchecked") 101 public static <T> T[] emptyArray(Class<T> kind) { 102 if (kind == Object.class) { 103 return (T[]) EmptyArray.OBJECT; 104 } 105 106 int bucket = ((System.identityHashCode(kind) / 8) & 0x7FFFFFFF) % CACHE_SIZE; 107 Object cache = sCache[bucket]; 108 109 if (cache == null || cache.getClass().getComponentType() != kind) { 110 cache = Array.newInstance(kind, 0); 111 sCache[bucket] = cache; 112 113 // Log.e("cache", "new empty " + kind.getName() + " at " + bucket); 114 } 115 116 return (T[]) cache; 117 } 118 119 /** 120 * Checks if given array is null or has zero elements. 121 */ 122 public static <T> boolean isEmpty(T[] array) { 123 return array == null || array.length == 0; 124 } 125 126 /** 127 * Checks that value is present as at least one of the elements of the array. 128 * @param array the array to check in 129 * @param value the value to check for 130 * @return true if the value is present in the array 131 */ 132 public static <T> boolean contains(T[] array, T value) { 133 return indexOf(array, value) != -1; 134 } 135 136 /** 137 * Return first index of {@code value} in {@code array}, or {@code -1} if 138 * not found. 139 */ 140 public static <T> int indexOf(T[] array, T value) { 141 for (int i = 0; i < array.length; i++) { 142 if (array[i] == null) { 143 if (value == null) return i; 144 } else { 145 if (value != null && array[i].equals(value)) return i; 146 } 147 } 148 return -1; 149 } 150 151 /** 152 * Test if all {@code check} items are contained in {@code array}. 153 */ 154 public static <T> boolean containsAll(T[] array, T[] check) { 155 for (T checkItem : check) { 156 if (!contains(array, checkItem)) { 157 return false; 158 } 159 } 160 return true; 161 } 162 163 public static boolean contains(int[] array, int value) { 164 for (int element : array) { 165 if (element == value) { 166 return true; 167 } 168 } 169 return false; 170 } 171 172 public static boolean contains(long[] array, long value) { 173 for (long element : array) { 174 if (element == value) { 175 return true; 176 } 177 } 178 return false; 179 } 180 181 public static long total(long[] array) { 182 long total = 0; 183 for (long value : array) { 184 total += value; 185 } 186 return total; 187 } 188 189 /** 190 * Appends an element to a copy of the array and returns the copy. 191 * @param array The original array, or null to represent an empty array. 192 * @param element The element to add. 193 * @return A new array that contains all of the elements of the original array 194 * with the specified element added at the end. 195 */ 196 @SuppressWarnings("unchecked") 197 public static <T> T[] appendElement(Class<T> kind, T[] array, T element) { 198 final T[] result; 199 final int end; 200 if (array != null) { 201 end = array.length; 202 result = (T[])Array.newInstance(kind, end + 1); 203 System.arraycopy(array, 0, result, 0, end); 204 } else { 205 end = 0; 206 result = (T[])Array.newInstance(kind, 1); 207 } 208 result[end] = element; 209 return result; 210 } 211 212 /** 213 * Removes an element from a copy of the array and returns the copy. 214 * If the element is not present, then the original array is returned unmodified. 215 * @param array The original array, or null to represent an empty array. 216 * @param element The element to remove. 217 * @return A new array that contains all of the elements of the original array 218 * except the first copy of the specified element removed. If the specified element 219 * was not present, then returns the original array. Returns null if the result 220 * would be an empty array. 221 */ 222 @SuppressWarnings("unchecked") 223 public static <T> T[] removeElement(Class<T> kind, T[] array, T element) { 224 if (array != null) { 225 final int length = array.length; 226 for (int i = 0; i < length; i++) { 227 if (array[i] == element) { 228 if (length == 1) { 229 return null; 230 } 231 T[] result = (T[])Array.newInstance(kind, length - 1); 232 System.arraycopy(array, 0, result, 0, i); 233 System.arraycopy(array, i + 1, result, i, length - i - 1); 234 return result; 235 } 236 } 237 } 238 return array; 239 } 240 241 /** 242 * Appends a new value to a copy of the array and returns the copy. If 243 * the value is already present, the original array is returned 244 * @param cur The original array, or null to represent an empty array. 245 * @param val The value to add. 246 * @return A new array that contains all of the values of the original array 247 * with the new value added, or the original array. 248 */ 249 public static int[] appendInt(int[] cur, int val) { 250 if (cur == null) { 251 return new int[] { val }; 252 } 253 final int N = cur.length; 254 for (int i = 0; i < N; i++) { 255 if (cur[i] == val) { 256 return cur; 257 } 258 } 259 int[] ret = new int[N + 1]; 260 System.arraycopy(cur, 0, ret, 0, N); 261 ret[N] = val; 262 return ret; 263 } 264 265 public static int[] removeInt(int[] cur, int val) { 266 if (cur == null) { 267 return null; 268 } 269 final int N = cur.length; 270 for (int i = 0; i < N; i++) { 271 if (cur[i] == val) { 272 int[] ret = new int[N - 1]; 273 if (i > 0) { 274 System.arraycopy(cur, 0, ret, 0, i); 275 } 276 if (i < (N - 1)) { 277 System.arraycopy(cur, i + 1, ret, i, N - i - 1); 278 } 279 return ret; 280 } 281 } 282 return cur; 283 } 284 285 /** 286 * Appends a new value to a copy of the array and returns the copy. If 287 * the value is already present, the original array is returned 288 * @param cur The original array, or null to represent an empty array. 289 * @param val The value to add. 290 * @return A new array that contains all of the values of the original array 291 * with the new value added, or the original array. 292 */ 293 public static long[] appendLong(long[] cur, long val) { 294 if (cur == null) { 295 return new long[] { val }; 296 } 297 final int N = cur.length; 298 for (int i = 0; i < N; i++) { 299 if (cur[i] == val) { 300 return cur; 301 } 302 } 303 long[] ret = new long[N + 1]; 304 System.arraycopy(cur, 0, ret, 0, N); 305 ret[N] = val; 306 return ret; 307 } 308 309 public static long[] removeLong(long[] cur, long val) { 310 if (cur == null) { 311 return null; 312 } 313 final int N = cur.length; 314 for (int i = 0; i < N; i++) { 315 if (cur[i] == val) { 316 long[] ret = new long[N - 1]; 317 if (i > 0) { 318 System.arraycopy(cur, 0, ret, 0, i); 319 } 320 if (i < (N - 1)) { 321 System.arraycopy(cur, i + 1, ret, i, N - i - 1); 322 } 323 return ret; 324 } 325 } 326 return cur; 327 } 328} 329