Removes the element at the specified position from the specified array. : Array Objects « Collections « Java Tutorial

Java Tutorial
1. Language
2. Data Type
3. Operators
4. Statement Control
5. Class Definition
6. Development
7. Reflection
8. Regular Expressions
9. Collections
10. Thread
11. File
12. Generics
13. I18N
14. Swing
15. Swing Event
16. 2D Graphics
17. SWT
18. SWT 2D Graphics
19. Network
20. Database
21. Hibernate
22. JPA
23. JSP
24. JSTL
25. Servlet
26. Web Services SOA
27. EJB3
28. Spring
29. PDF
30. Email
31. J2ME
32. J2EE Application
33. XML
34. Design Pattern
35. Log
36. Security
37. Apache Common
38. Ant
39. JUnit
Java
Java Source Code / Java Documentation
Java Open Source
Jar File Download
Java Articles
Java Products
Java by API
Photoshop Tutorials
Maya Tutorials
Flash Tutorials
3ds-Max Tutorials
Illustrator Tutorials
GIMP Tutorials
C# / C Sharp
C# / CSharp Tutorial
C# / CSharp Open Source
ASP.Net
ASP.NET Tutorial
JavaScript DHTML
JavaScript Tutorial
JavaScript Reference
HTML / CSS
HTML CSS Reference
C / ANSI-C
C Tutorial
C++
C++ Tutorial
Ruby
PHP
Python
Python Tutorial
Python Open Source
SQL Server / T-SQL
SQL Server / T-SQL Tutorial
Oracle PL / SQL
Oracle PL/SQL Tutorial
PostgreSQL
SQL / MySQL
MySQL Tutorial
VB.Net
VB.Net Tutorial
Flash / Flex / ActionScript
VBA / Excel / Access / Word
XML
XML Tutorial
Microsoft Office PowerPoint 2007 Tutorial
Microsoft Office Excel 2007 Tutorial
Microsoft Office Word 2007 Tutorial
Java Tutorial » Collections » Array Objects 
9. 6. 11. Removes the element at the specified position from the specified array.
/*   Copyright 2004 The Apache Software Foundation
 *
 *   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.
 */


import java.lang.reflect.Array;


/**
 * Operations on arrays, primitive arrays (like <code>int[]</code>) and
 * primitive wrapper arrays (like <code>Integer[]</code>).
 
 * This class tries to handle <code>null</code> input gracefully.
 * An exception will not be thrown for a <code>null</code>
 * array input. However, an Object array that contains a <code>null</code>
 * element may throw an exception. Each method documents its behaviour.
 *
 @author Stephen Colebourne
 @author Moritz Petersen
 @author <a href="mailto:fredrik@westermarck.com">Fredrik Westermarck</a>
 @author Nikolay Metchev
 @author Matthew Hawthorne
 @author Tim O'Brien
 @author Pete Gieser
 @author Gary Gregory
 @author <a href="mailto:equinus100@hotmail.com">Ashwin S</a>
 @author Maarten Coene
 @since 2.0
 @version $Id: ArrayUtils.java 632503 2008-03-01 00:21:52Z ggregory $
 */
public class Main {

  /**
   * Removes the element at the specified position from the specified array.
   * All subsequent elements are shifted to the left (substracts one from
   * their indices).
   *
   * This method returns a new array with the same elements of the input
   * array except the element on the specified position. The component 
   * type of the returned array is always the same as that of the input 
   * array.
   *
   * If the input array is <code>null</code>, an IndexOutOfBoundsException
   * will be thrown, because in that case no valid index can be specified.
   *
   * <pre>
   * ArrayUtils.remove([1], 0)         = []
   * ArrayUtils.remove([2, 6], 0)      = [6]
   * ArrayUtils.remove([2, 6], 1)      = [2]
   * ArrayUtils.remove([2, 6, 3], 1)   = [2, 3]
   * </pre>
   
   @param array  the array to remove the element from, may not be <code>null</code>
   @param index  the position of the element to be removed
   @return A new array containing the existing elements except the element
   *         at the specified position.
   @throws IndexOutOfBoundsException if the index is out of range 
   * (index < 0 || index >= array.length), or if the array is <code>null</code>.
   @since 2.1
   */
  public static short[] remove(short[] array, int index) {
      return (short[]) remove((Objectarray, index);
  }
  /**
   * Removes the element at the specified position from the specified array.
   * All subsequent elements are shifted to the left (substracts one from
   * their indices).
   *
   * This method returns a new array with the same elements of the input
   * array except the element on the specified position. The component 
   * type of the returned array is always the same as that of the input 
   * array.
   *
   * If the input array is <code>null</code>, an IndexOutOfBoundsException
   * will be thrown, because in that case no valid index can be specified.
   
   @param array  the array to remove the element from, may not be <code>null</code>
   @param index  the position of the element to be removed
   @return A new array containing the existing elements except the element
   *         at the specified position.
   @throws IndexOutOfBoundsException if the index is out of range 
   * (index < 0 || index >= array.length), or if the array is <code>null</code>.
   @since 2.1
   */
  private static Object remove(Object array, int index) {
      int length = getLength(array);
      if (index < || index >= length) {
          throw new IndexOutOfBoundsException("Index: " + index + ", Length: " + length);
      }
      
      Object result = Array.newInstance(array.getClass().getComponentType(), length - 1);
      System.arraycopy(array, 0, result, 0, index);
      if (index < length - 1) {
          System.arraycopy(array, index + 1, result, index, length - index - 1);
      }
      
      return result;
  }
  /**
   * Finds the index of the given value in the array starting at the given index.
   *
   * This method returns {@link #INDEX_NOT_FOUND} (<code>-1</code>) for a <code>null</code> input array.
   *
   * A negative startIndex is treated as zero. A startIndex larger than the array
   * length will return {@link #INDEX_NOT_FOUND} (<code>-1</code>).
   
   @param array  the array to search through for the object, may be <code>null</code>
   @param valueToFind  the value to find
   @param startIndex  the index to start searching at
   @return the index of the value within the array,
   *  {@link #INDEX_NOT_FOUND} (<code>-1</code>) if not found or <code>null</code> array input
   */
  public static int indexOf(short[] array, short valueToFind) {
      if (array == null) {
          return -1;
      }
      for (int i = 0; i < array.length; i++) {
          if (valueToFind == array[i]) {
              return i;
          }
      }
      return -1;
  }
  /**
   * Returns the length of the specified array.
   * This method can deal with <code>Object</code> arrays and with primitive arrays.
   *
   * If the input array is <code>null</code>, <code>0</code> is returned.
   *
   * <pre>
   * ArrayUtils.getLength(null)            = 0
   * ArrayUtils.getLength([])              = 0
   * ArrayUtils.getLength([null])          = 1
   * ArrayUtils.getLength([true, false])   = 2
   * ArrayUtils.getLength([1, 2, 3])       = 3
   * ArrayUtils.getLength(["a", "b", "c"]) = 3
   * </pre>
   *
   @param array  the array to retrieve the length from, may be null
   @return The length of the array, or <code>0</code> if the array is <code>null</code>
   @throws IllegalArgumentException if the object arguement is not an array.
   @since 2.1
   */
  public static int getLength(Object array) {
      if (array == null) {
          return 0;
      }
      return Array.getLength(array);
  }
  /**
   * Shallow clones an array returning a typecast result and handling
   * <code>null</code>.
   *
   * The objects in the array are not cloned, thus there is no special
   * handling for multi-dimensional arrays.
   
   * This method returns <code>null</code> for a <code>null</code> input array.
   
   @param array  the array to shallow clone, may be <code>null</code>
   @return the cloned array, <code>null</code> if <code>null</code> input
   */
  public static short[] clone(short[] array) {
      if (array == null) {
          return null;
      }
      return (short[]) array.clone();
  }



}
9. 6. Array Objects
9. 6. 1. Arrays of Objects
9. 6. 2. Arrays of Strings: using 'new' operator
9. 6. 3. Arrays of Strings: initial values determine the size of the array
9. 6. 4. Demonstrate String arrays.
9. 6. 5. Checks whether two arrays are the same length, treating null arrays as length 0.
9. 6. 6. Checks whether two arrays are the same type taking into account multi-dimensional arrays.
9. 6. 7. Turn an array of ints into a printable string.
9. 6. 8. Check if the given object is an array (primitve or native).
9. 6. 9. Reverses the order of the given long type value array.
9. 6. 10. Removes the first occurrence of the specified element from the specified array.
9. 6. 11. Removes the element at the specified position from the specified array.
www.java2java.com | Contact Us
Copyright 2009 - 12 Demo Source and Support. All rights reserved.
All other trademarks are property of their respective owners.