You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@commons.apache.org by br...@apache.org on 2015/05/01 22:55:53 UTC
svn commit: r949864 [6/48] - in
/websites/production/commons/content/proper/commons-lang: ./ apidocs/
apidocs/org/apache/commons/lang3/ apidocs/org/apache/commons/lang3/builder/
apidocs/org/apache/commons/lang3/time/ apidocs/src-html/org/apache/commons...
Modified: websites/production/commons/content/proper/commons-lang/apidocs/src-html/org/apache/commons/lang3/ArrayUtils.html
==============================================================================
--- websites/production/commons/content/proper/commons-lang/apidocs/src-html/org/apache/commons/lang3/ArrayUtils.html (original)
+++ websites/production/commons/content/proper/commons-lang/apidocs/src-html/org/apache/commons/lang3/ArrayUtils.html Fri May 1 20:55:51 2015
@@ -1855,4750 +1855,5919 @@
<span class="sourceLineNo">1847</span> }<a name="line.1847"></a>
<span class="sourceLineNo">1848</span> }<a name="line.1848"></a>
<span class="sourceLineNo">1849</span><a name="line.1849"></a>
-<span class="sourceLineNo">1850</span> // IndexOf search<a name="line.1850"></a>
-<span class="sourceLineNo">1851</span> // ----------------------------------------------------------------------<a name="line.1851"></a>
-<span class="sourceLineNo">1852</span><a name="line.1852"></a>
-<span class="sourceLineNo">1853</span> // Object IndexOf<a name="line.1853"></a>
-<span class="sourceLineNo">1854</span> //-----------------------------------------------------------------------<a name="line.1854"></a>
-<span class="sourceLineNo">1855</span> /**<a name="line.1855"></a>
-<span class="sourceLineNo">1856</span> * <p>Finds the index of the given object in the array.</p><a name="line.1856"></a>
-<span class="sourceLineNo">1857</span> *<a name="line.1857"></a>
-<span class="sourceLineNo">1858</span> * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.</p><a name="line.1858"></a>
-<span class="sourceLineNo">1859</span> *<a name="line.1859"></a>
-<span class="sourceLineNo">1860</span> * @param array the array to search through for the object, may be {@code null}<a name="line.1860"></a>
-<span class="sourceLineNo">1861</span> * @param objectToFind the object to find, may be {@code null}<a name="line.1861"></a>
-<span class="sourceLineNo">1862</span> * @return the index of the object within the array,<a name="line.1862"></a>
-<span class="sourceLineNo">1863</span> * {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null} array input<a name="line.1863"></a>
-<span class="sourceLineNo">1864</span> */<a name="line.1864"></a>
-<span class="sourceLineNo">1865</span> public static int indexOf(final Object[] array, final Object objectToFind) {<a name="line.1865"></a>
-<span class="sourceLineNo">1866</span> return indexOf(array, objectToFind, 0);<a name="line.1866"></a>
-<span class="sourceLineNo">1867</span> }<a name="line.1867"></a>
-<span class="sourceLineNo">1868</span><a name="line.1868"></a>
-<span class="sourceLineNo">1869</span> /**<a name="line.1869"></a>
-<span class="sourceLineNo">1870</span> * <p>Finds the index of the given object in the array starting at the given index.</p><a name="line.1870"></a>
-<span class="sourceLineNo">1871</span> *<a name="line.1871"></a>
-<span class="sourceLineNo">1872</span> * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.</p><a name="line.1872"></a>
-<span class="sourceLineNo">1873</span> *<a name="line.1873"></a>
-<span class="sourceLineNo">1874</span> * <p>A negative startIndex is treated as zero. A startIndex larger than the array<a name="line.1874"></a>
-<span class="sourceLineNo">1875</span> * length will return {@link #INDEX_NOT_FOUND} ({@code -1}).</p><a name="line.1875"></a>
-<span class="sourceLineNo">1876</span> *<a name="line.1876"></a>
-<span class="sourceLineNo">1877</span> * @param array the array to search through for the object, may be {@code null}<a name="line.1877"></a>
-<span class="sourceLineNo">1878</span> * @param objectToFind the object to find, may be {@code null}<a name="line.1878"></a>
-<span class="sourceLineNo">1879</span> * @param startIndex the index to start searching at<a name="line.1879"></a>
-<span class="sourceLineNo">1880</span> * @return the index of the object within the array starting at the index,<a name="line.1880"></a>
-<span class="sourceLineNo">1881</span> * {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null} array input<a name="line.1881"></a>
-<span class="sourceLineNo">1882</span> */<a name="line.1882"></a>
-<span class="sourceLineNo">1883</span> public static int indexOf(final Object[] array, final Object objectToFind, int startIndex) {<a name="line.1883"></a>
-<span class="sourceLineNo">1884</span> if (array == null) {<a name="line.1884"></a>
-<span class="sourceLineNo">1885</span> return INDEX_NOT_FOUND;<a name="line.1885"></a>
-<span class="sourceLineNo">1886</span> }<a name="line.1886"></a>
-<span class="sourceLineNo">1887</span> if (startIndex < 0) {<a name="line.1887"></a>
-<span class="sourceLineNo">1888</span> startIndex = 0;<a name="line.1888"></a>
-<span class="sourceLineNo">1889</span> }<a name="line.1889"></a>
-<span class="sourceLineNo">1890</span> if (objectToFind == null) {<a name="line.1890"></a>
-<span class="sourceLineNo">1891</span> for (int i = startIndex; i < array.length; i++) {<a name="line.1891"></a>
-<span class="sourceLineNo">1892</span> if (array[i] == null) {<a name="line.1892"></a>
-<span class="sourceLineNo">1893</span> return i;<a name="line.1893"></a>
-<span class="sourceLineNo">1894</span> }<a name="line.1894"></a>
-<span class="sourceLineNo">1895</span> }<a name="line.1895"></a>
-<span class="sourceLineNo">1896</span> } else if (array.getClass().getComponentType().isInstance(objectToFind)) {<a name="line.1896"></a>
-<span class="sourceLineNo">1897</span> for (int i = startIndex; i < array.length; i++) {<a name="line.1897"></a>
-<span class="sourceLineNo">1898</span> if (objectToFind.equals(array[i])) {<a name="line.1898"></a>
-<span class="sourceLineNo">1899</span> return i;<a name="line.1899"></a>
-<span class="sourceLineNo">1900</span> }<a name="line.1900"></a>
-<span class="sourceLineNo">1901</span> }<a name="line.1901"></a>
+<span class="sourceLineNo">1850</span> // Swap<a name="line.1850"></a>
+<span class="sourceLineNo">1851</span> //-----------------------------------------------------------------------<a name="line.1851"></a>
+<span class="sourceLineNo">1852</span> /**<a name="line.1852"></a>
+<span class="sourceLineNo">1853</span> * <p>Swaps two elements in the given array.</p><a name="line.1853"></a>
+<span class="sourceLineNo">1854</span> *<a name="line.1854"></a>
+<span class="sourceLineNo">1855</span> * <p>There is no special handling for multi-dimensional arrays.</p><a name="line.1855"></a>
+<span class="sourceLineNo">1856</span> *<a name="line.1856"></a>
+<span class="sourceLineNo">1857</span> * <p>This method does nothing for a {@code null} input array.</p><a name="line.1857"></a>
+<span class="sourceLineNo">1858</span> * <a name="line.1858"></a>
+<span class="sourceLineNo">1859</span> * <p>Examples:<a name="line.1859"></a>
+<span class="sourceLineNo">1860</span> * <ul><a name="line.1860"></a>
+<span class="sourceLineNo">1861</span> * <li>ArrayUtils.swap(["1", "2", "3"], 0, 2) -> ["3", "2", "1"]</li><a name="line.1861"></a>
+<span class="sourceLineNo">1862</span> * <li>ArrayUtils.swap(["1", "2", "3"], 0, 0) -> ["1", "2", "3"]</li><a name="line.1862"></a>
+<span class="sourceLineNo">1863</span> * <li>ArrayUtils.swap(["1", "2", "3"], 1, 0) -> ["2", "1", "3"]</li><a name="line.1863"></a>
+<span class="sourceLineNo">1864</span> * <li>ArrayUtils.swap(["1", "2", "3"], 0, 5) -> ArrayOutOfBoundsException</li><a name="line.1864"></a>
+<span class="sourceLineNo">1865</span> * </ul><a name="line.1865"></a>
+<span class="sourceLineNo">1866</span> * </p><a name="line.1866"></a>
+<span class="sourceLineNo">1867</span> *<a name="line.1867"></a>
+<span class="sourceLineNo">1868</span> * @param array the array to swap, may be {@code null}<a name="line.1868"></a>
+<span class="sourceLineNo">1869</span> * @param offset1 the index of the first element to swap<a name="line.1869"></a>
+<span class="sourceLineNo">1870</span> * @param offset2 the index of the second element to swap<a name="line.1870"></a>
+<span class="sourceLineNo">1871</span> * @throws ArrayIndexOutOfBoundsException if one of the indices is out of range<a name="line.1871"></a>
+<span class="sourceLineNo">1872</span> */<a name="line.1872"></a>
+<span class="sourceLineNo">1873</span> public static void swap(final Object[] array, int offset1, int offset2) {<a name="line.1873"></a>
+<span class="sourceLineNo">1874</span> if (array == null) {<a name="line.1874"></a>
+<span class="sourceLineNo">1875</span> return;<a name="line.1875"></a>
+<span class="sourceLineNo">1876</span> }<a name="line.1876"></a>
+<span class="sourceLineNo">1877</span> swap(array, offset1, offset2, 1);<a name="line.1877"></a>
+<span class="sourceLineNo">1878</span> }<a name="line.1878"></a>
+<span class="sourceLineNo">1879</span><a name="line.1879"></a>
+<span class="sourceLineNo">1880</span> /**<a name="line.1880"></a>
+<span class="sourceLineNo">1881</span> * <p>Swaps two elements in the given array.</p><a name="line.1881"></a>
+<span class="sourceLineNo">1882</span> *<a name="line.1882"></a>
+<span class="sourceLineNo">1883</span> * <p>This method does nothing for a {@code null} input array.</p><a name="line.1883"></a>
+<span class="sourceLineNo">1884</span> *<a name="line.1884"></a>
+<span class="sourceLineNo">1885</span> * <p>Examples:<a name="line.1885"></a>
+<span class="sourceLineNo">1886</span> * <ul><a name="line.1886"></a>
+<span class="sourceLineNo">1887</span> * <li>ArrayUtils.swap([true, false, true], 0, 2) -> [true, false, true]</li><a name="line.1887"></a>
+<span class="sourceLineNo">1888</span> * <li>ArrayUtils.swap([true, false, true], 0, 0) -> [true, false, true]</li><a name="line.1888"></a>
+<span class="sourceLineNo">1889</span> * <li>ArrayUtils.swap([true, false, true], 1, 0) -> [false, true, true]</li><a name="line.1889"></a>
+<span class="sourceLineNo">1890</span> * <li>ArrayUtils.swap([true, false, true], 0, 5) -> ArrayOutOfBoundsException</li><a name="line.1890"></a>
+<span class="sourceLineNo">1891</span> * </ul><a name="line.1891"></a>
+<span class="sourceLineNo">1892</span> * </p><a name="line.1892"></a>
+<span class="sourceLineNo">1893</span> * <a name="line.1893"></a>
+<span class="sourceLineNo">1894</span> * @param array the array to swap, may be {@code null}<a name="line.1894"></a>
+<span class="sourceLineNo">1895</span> * @param offset1 the index of the first element to swap<a name="line.1895"></a>
+<span class="sourceLineNo">1896</span> * @param offset2 the index of the second element to swap<a name="line.1896"></a>
+<span class="sourceLineNo">1897</span> * @throws ArrayIndexOutOfBoundsException if one of the indices is out of range<a name="line.1897"></a>
+<span class="sourceLineNo">1898</span> */<a name="line.1898"></a>
+<span class="sourceLineNo">1899</span> public static void swap(final long[] array, int offset1, int offset2) {<a name="line.1899"></a>
+<span class="sourceLineNo">1900</span> if (array == null) {<a name="line.1900"></a>
+<span class="sourceLineNo">1901</span> return;<a name="line.1901"></a>
<span class="sourceLineNo">1902</span> }<a name="line.1902"></a>
-<span class="sourceLineNo">1903</span> return INDEX_NOT_FOUND;<a name="line.1903"></a>
+<span class="sourceLineNo">1903</span> swap(array, offset1, offset2, 1);<a name="line.1903"></a>
<span class="sourceLineNo">1904</span> }<a name="line.1904"></a>
<span class="sourceLineNo">1905</span><a name="line.1905"></a>
<span class="sourceLineNo">1906</span> /**<a name="line.1906"></a>
-<span class="sourceLineNo">1907</span> * <p>Finds the last index of the given object within the array.</p><a name="line.1907"></a>
+<span class="sourceLineNo">1907</span> * <p>Swaps two elements in the given array.</p><a name="line.1907"></a>
<span class="sourceLineNo">1908</span> *<a name="line.1908"></a>
-<span class="sourceLineNo">1909</span> * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.</p><a name="line.1909"></a>
+<span class="sourceLineNo">1909</span> * <p>This method does nothing for a {@code null} input array.</p><a name="line.1909"></a>
<span class="sourceLineNo">1910</span> *<a name="line.1910"></a>
-<span class="sourceLineNo">1911</span> * @param array the array to travers backwords looking for the object, may be {@code null}<a name="line.1911"></a>
-<span class="sourceLineNo">1912</span> * @param objectToFind the object to find, may be {@code null}<a name="line.1912"></a>
-<span class="sourceLineNo">1913</span> * @return the last index of the object within the array,<a name="line.1913"></a>
-<span class="sourceLineNo">1914</span> * {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null} array input<a name="line.1914"></a>
-<span class="sourceLineNo">1915</span> */<a name="line.1915"></a>
-<span class="sourceLineNo">1916</span> public static int lastIndexOf(final Object[] array, final Object objectToFind) {<a name="line.1916"></a>
-<span class="sourceLineNo">1917</span> return lastIndexOf(array, objectToFind, Integer.MAX_VALUE);<a name="line.1917"></a>
-<span class="sourceLineNo">1918</span> }<a name="line.1918"></a>
-<span class="sourceLineNo">1919</span><a name="line.1919"></a>
-<span class="sourceLineNo">1920</span> /**<a name="line.1920"></a>
-<span class="sourceLineNo">1921</span> * <p>Finds the last index of the given object in the array starting at the given index.</p><a name="line.1921"></a>
-<span class="sourceLineNo">1922</span> *<a name="line.1922"></a>
-<span class="sourceLineNo">1923</span> * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.</p><a name="line.1923"></a>
-<span class="sourceLineNo">1924</span> *<a name="line.1924"></a>
-<span class="sourceLineNo">1925</span> * <p>A negative startIndex will return {@link #INDEX_NOT_FOUND} ({@code -1}). A startIndex larger than<a name="line.1925"></a>
-<span class="sourceLineNo">1926</span> * the array length will search from the end of the array.</p><a name="line.1926"></a>
-<span class="sourceLineNo">1927</span> *<a name="line.1927"></a>
-<span class="sourceLineNo">1928</span> * @param array the array to traverse for looking for the object, may be {@code null}<a name="line.1928"></a>
-<span class="sourceLineNo">1929</span> * @param objectToFind the object to find, may be {@code null}<a name="line.1929"></a>
-<span class="sourceLineNo">1930</span> * @param startIndex the start index to travers backwards from<a name="line.1930"></a>
-<span class="sourceLineNo">1931</span> * @return the last index of the object within the array,<a name="line.1931"></a>
-<span class="sourceLineNo">1932</span> * {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null} array input<a name="line.1932"></a>
-<span class="sourceLineNo">1933</span> */<a name="line.1933"></a>
-<span class="sourceLineNo">1934</span> public static int lastIndexOf(final Object[] array, final Object objectToFind, int startIndex) {<a name="line.1934"></a>
-<span class="sourceLineNo">1935</span> if (array == null) {<a name="line.1935"></a>
-<span class="sourceLineNo">1936</span> return INDEX_NOT_FOUND;<a name="line.1936"></a>
-<span class="sourceLineNo">1937</span> }<a name="line.1937"></a>
-<span class="sourceLineNo">1938</span> if (startIndex < 0) {<a name="line.1938"></a>
-<span class="sourceLineNo">1939</span> return INDEX_NOT_FOUND;<a name="line.1939"></a>
-<span class="sourceLineNo">1940</span> } else if (startIndex >= array.length) {<a name="line.1940"></a>
-<span class="sourceLineNo">1941</span> startIndex = array.length - 1;<a name="line.1941"></a>
-<span class="sourceLineNo">1942</span> }<a name="line.1942"></a>
-<span class="sourceLineNo">1943</span> if (objectToFind == null) {<a name="line.1943"></a>
-<span class="sourceLineNo">1944</span> for (int i = startIndex; i >= 0; i--) {<a name="line.1944"></a>
-<span class="sourceLineNo">1945</span> if (array[i] == null) {<a name="line.1945"></a>
-<span class="sourceLineNo">1946</span> return i;<a name="line.1946"></a>
-<span class="sourceLineNo">1947</span> }<a name="line.1947"></a>
-<span class="sourceLineNo">1948</span> }<a name="line.1948"></a>
-<span class="sourceLineNo">1949</span> } else if (array.getClass().getComponentType().isInstance(objectToFind)) {<a name="line.1949"></a>
-<span class="sourceLineNo">1950</span> for (int i = startIndex; i >= 0; i--) {<a name="line.1950"></a>
-<span class="sourceLineNo">1951</span> if (objectToFind.equals(array[i])) {<a name="line.1951"></a>
-<span class="sourceLineNo">1952</span> return i;<a name="line.1952"></a>
-<span class="sourceLineNo">1953</span> }<a name="line.1953"></a>
-<span class="sourceLineNo">1954</span> }<a name="line.1954"></a>
-<span class="sourceLineNo">1955</span> }<a name="line.1955"></a>
-<span class="sourceLineNo">1956</span> return INDEX_NOT_FOUND;<a name="line.1956"></a>
-<span class="sourceLineNo">1957</span> }<a name="line.1957"></a>
-<span class="sourceLineNo">1958</span><a name="line.1958"></a>
-<span class="sourceLineNo">1959</span> /**<a name="line.1959"></a>
-<span class="sourceLineNo">1960</span> * <p>Checks if the object is in the given array.</p><a name="line.1960"></a>
-<span class="sourceLineNo">1961</span> *<a name="line.1961"></a>
-<span class="sourceLineNo">1962</span> * <p>The method returns {@code false} if a {@code null} array is passed in.</p><a name="line.1962"></a>
-<span class="sourceLineNo">1963</span> *<a name="line.1963"></a>
-<span class="sourceLineNo">1964</span> * @param array the array to search through<a name="line.1964"></a>
-<span class="sourceLineNo">1965</span> * @param objectToFind the object to find<a name="line.1965"></a>
-<span class="sourceLineNo">1966</span> * @return {@code true} if the array contains the object<a name="line.1966"></a>
-<span class="sourceLineNo">1967</span> */<a name="line.1967"></a>
-<span class="sourceLineNo">1968</span> public static boolean contains(final Object[] array, final Object objectToFind) {<a name="line.1968"></a>
-<span class="sourceLineNo">1969</span> return indexOf(array, objectToFind) != INDEX_NOT_FOUND;<a name="line.1969"></a>
-<span class="sourceLineNo">1970</span> }<a name="line.1970"></a>
-<span class="sourceLineNo">1971</span><a name="line.1971"></a>
-<span class="sourceLineNo">1972</span> // long IndexOf<a name="line.1972"></a>
-<span class="sourceLineNo">1973</span> //-----------------------------------------------------------------------<a name="line.1973"></a>
-<span class="sourceLineNo">1974</span> /**<a name="line.1974"></a>
-<span class="sourceLineNo">1975</span> * <p>Finds the index of the given value in the array.</p><a name="line.1975"></a>
-<span class="sourceLineNo">1976</span> *<a name="line.1976"></a>
-<span class="sourceLineNo">1977</span> * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.</p><a name="line.1977"></a>
-<span class="sourceLineNo">1978</span> *<a name="line.1978"></a>
-<span class="sourceLineNo">1979</span> * @param array the array to search through for the object, may be {@code null}<a name="line.1979"></a>
-<span class="sourceLineNo">1980</span> * @param valueToFind the value to find<a name="line.1980"></a>
-<span class="sourceLineNo">1981</span> * @return the index of the value within the array,<a name="line.1981"></a>
-<span class="sourceLineNo">1982</span> * {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null} array input<a name="line.1982"></a>
-<span class="sourceLineNo">1983</span> */<a name="line.1983"></a>
-<span class="sourceLineNo">1984</span> public static int indexOf(final long[] array, final long valueToFind) {<a name="line.1984"></a>
-<span class="sourceLineNo">1985</span> return indexOf(array, valueToFind, 0);<a name="line.1985"></a>
-<span class="sourceLineNo">1986</span> }<a name="line.1986"></a>
-<span class="sourceLineNo">1987</span><a name="line.1987"></a>
-<span class="sourceLineNo">1988</span> /**<a name="line.1988"></a>
-<span class="sourceLineNo">1989</span> * <p>Finds the index of the given value in the array starting at the given index.</p><a name="line.1989"></a>
-<span class="sourceLineNo">1990</span> *<a name="line.1990"></a>
-<span class="sourceLineNo">1991</span> * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.</p><a name="line.1991"></a>
-<span class="sourceLineNo">1992</span> *<a name="line.1992"></a>
-<span class="sourceLineNo">1993</span> * <p>A negative startIndex is treated as zero. A startIndex larger than the array<a name="line.1993"></a>
-<span class="sourceLineNo">1994</span> * length will return {@link #INDEX_NOT_FOUND} ({@code -1}).</p><a name="line.1994"></a>
-<span class="sourceLineNo">1995</span> *<a name="line.1995"></a>
-<span class="sourceLineNo">1996</span> * @param array the array to search through for the object, may be {@code null}<a name="line.1996"></a>
-<span class="sourceLineNo">1997</span> * @param valueToFind the value to find<a name="line.1997"></a>
-<span class="sourceLineNo">1998</span> * @param startIndex the index to start searching at<a name="line.1998"></a>
-<span class="sourceLineNo">1999</span> * @return the index of the value within the array,<a name="line.1999"></a>
-<span class="sourceLineNo">2000</span> * {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null} array input<a name="line.2000"></a>
-<span class="sourceLineNo">2001</span> */<a name="line.2001"></a>
-<span class="sourceLineNo">2002</span> public static int indexOf(final long[] array, final long valueToFind, int startIndex) {<a name="line.2002"></a>
-<span class="sourceLineNo">2003</span> if (array == null) {<a name="line.2003"></a>
-<span class="sourceLineNo">2004</span> return INDEX_NOT_FOUND;<a name="line.2004"></a>
-<span class="sourceLineNo">2005</span> }<a name="line.2005"></a>
-<span class="sourceLineNo">2006</span> if (startIndex < 0) {<a name="line.2006"></a>
-<span class="sourceLineNo">2007</span> startIndex = 0;<a name="line.2007"></a>
-<span class="sourceLineNo">2008</span> }<a name="line.2008"></a>
-<span class="sourceLineNo">2009</span> for (int i = startIndex; i < array.length; i++) {<a name="line.2009"></a>
-<span class="sourceLineNo">2010</span> if (valueToFind == array[i]) {<a name="line.2010"></a>
-<span class="sourceLineNo">2011</span> return i;<a name="line.2011"></a>
-<span class="sourceLineNo">2012</span> }<a name="line.2012"></a>
-<span class="sourceLineNo">2013</span> }<a name="line.2013"></a>
-<span class="sourceLineNo">2014</span> return INDEX_NOT_FOUND;<a name="line.2014"></a>
-<span class="sourceLineNo">2015</span> }<a name="line.2015"></a>
-<span class="sourceLineNo">2016</span><a name="line.2016"></a>
-<span class="sourceLineNo">2017</span> /**<a name="line.2017"></a>
-<span class="sourceLineNo">2018</span> * <p>Finds the last index of the given value within the array.</p><a name="line.2018"></a>
-<span class="sourceLineNo">2019</span> *<a name="line.2019"></a>
-<span class="sourceLineNo">2020</span> * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.</p><a name="line.2020"></a>
-<span class="sourceLineNo">2021</span> *<a name="line.2021"></a>
-<span class="sourceLineNo">2022</span> * @param array the array to travers backwords looking for the object, may be {@code null}<a name="line.2022"></a>
-<span class="sourceLineNo">2023</span> * @param valueToFind the object to find<a name="line.2023"></a>
-<span class="sourceLineNo">2024</span> * @return the last index of the value within the array,<a name="line.2024"></a>
-<span class="sourceLineNo">2025</span> * {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null} array input<a name="line.2025"></a>
-<span class="sourceLineNo">2026</span> */<a name="line.2026"></a>
-<span class="sourceLineNo">2027</span> public static int lastIndexOf(final long[] array, final long valueToFind) {<a name="line.2027"></a>
-<span class="sourceLineNo">2028</span> return lastIndexOf(array, valueToFind, Integer.MAX_VALUE);<a name="line.2028"></a>
-<span class="sourceLineNo">2029</span> }<a name="line.2029"></a>
-<span class="sourceLineNo">2030</span><a name="line.2030"></a>
-<span class="sourceLineNo">2031</span> /**<a name="line.2031"></a>
-<span class="sourceLineNo">2032</span> * <p>Finds the last index of the given value in the array starting at the given index.</p><a name="line.2032"></a>
-<span class="sourceLineNo">2033</span> *<a name="line.2033"></a>
-<span class="sourceLineNo">2034</span> * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.</p><a name="line.2034"></a>
-<span class="sourceLineNo">2035</span> *<a name="line.2035"></a>
-<span class="sourceLineNo">2036</span> * <p>A negative startIndex will return {@link #INDEX_NOT_FOUND} ({@code -1}). A startIndex larger than the<a name="line.2036"></a>
-<span class="sourceLineNo">2037</span> * array length will search from the end of the array.</p><a name="line.2037"></a>
+<span class="sourceLineNo">1911</span> * <p>Examples:<a name="line.1911"></a>
+<span class="sourceLineNo">1912</span> * <ul><a name="line.1912"></a>
+<span class="sourceLineNo">1913</span> * <li>ArrayUtils.swap([1, 2, 3], 0, 2) -> [3, 2, 1]</li><a name="line.1913"></a>
+<span class="sourceLineNo">1914</span> * <li>ArrayUtils.swap([1, 2, 3], 0, 0) -> [1, 2, 3]</li><a name="line.1914"></a>
+<span class="sourceLineNo">1915</span> * <li>ArrayUtils.swap([1, 2, 3], 1, 0) -> [2, 1, 3]</li><a name="line.1915"></a>
+<span class="sourceLineNo">1916</span> * <li>ArrayUtils.swap([1, 2, 3], 0, 5) -> ArrayOutOfBoundsException</li><a name="line.1916"></a>
+<span class="sourceLineNo">1917</span> * </ul><a name="line.1917"></a>
+<span class="sourceLineNo">1918</span> * </p><a name="line.1918"></a>
+<span class="sourceLineNo">1919</span> *<a name="line.1919"></a>
+<span class="sourceLineNo">1920</span> * @param array the array to swap, may be {@code null}<a name="line.1920"></a>
+<span class="sourceLineNo">1921</span> * @param offset1 the index of the first element to swap<a name="line.1921"></a>
+<span class="sourceLineNo">1922</span> * @param offset2 the index of the second element to swap<a name="line.1922"></a>
+<span class="sourceLineNo">1923</span> * @throws ArrayIndexOutOfBoundsException if one of the indices is out of range<a name="line.1923"></a>
+<span class="sourceLineNo">1924</span> */<a name="line.1924"></a>
+<span class="sourceLineNo">1925</span> public static void swap(final int[] array, int offset1, int offset2) {<a name="line.1925"></a>
+<span class="sourceLineNo">1926</span> if (array == null) {<a name="line.1926"></a>
+<span class="sourceLineNo">1927</span> return;<a name="line.1927"></a>
+<span class="sourceLineNo">1928</span> }<a name="line.1928"></a>
+<span class="sourceLineNo">1929</span> swap(array, offset1, offset2, 1);<a name="line.1929"></a>
+<span class="sourceLineNo">1930</span> }<a name="line.1930"></a>
+<span class="sourceLineNo">1931</span><a name="line.1931"></a>
+<span class="sourceLineNo">1932</span> /**<a name="line.1932"></a>
+<span class="sourceLineNo">1933</span> * <p>Swaps two elements in the given array.</p><a name="line.1933"></a>
+<span class="sourceLineNo">1934</span> *<a name="line.1934"></a>
+<span class="sourceLineNo">1935</span> * <p>This method does nothing for a {@code null} input array.</p><a name="line.1935"></a>
+<span class="sourceLineNo">1936</span> *<a name="line.1936"></a>
+<span class="sourceLineNo">1937</span> * <p>Examples:<a name="line.1937"></a>
+<span class="sourceLineNo">1938</span> * <ul><a name="line.1938"></a>
+<span class="sourceLineNo">1939</span> * <li>ArrayUtils.swap([1, 2, 3], 0, 2) -> [3, 2, 1]</li><a name="line.1939"></a>
+<span class="sourceLineNo">1940</span> * <li>ArrayUtils.swap([1, 2, 3], 0, 0) -> [1, 2, 3]</li><a name="line.1940"></a>
+<span class="sourceLineNo">1941</span> * <li>ArrayUtils.swap([1, 2, 3], 1, 0) -> [2, 1, 3]</li><a name="line.1941"></a>
+<span class="sourceLineNo">1942</span> * <li>ArrayUtils.swap([1, 2, 3], 0, 5) -> ArrayOutOfBoundsException</li><a name="line.1942"></a>
+<span class="sourceLineNo">1943</span> * </ul><a name="line.1943"></a>
+<span class="sourceLineNo">1944</span> * </p><a name="line.1944"></a>
+<span class="sourceLineNo">1945</span> * <a name="line.1945"></a>
+<span class="sourceLineNo">1946</span> * @param array the array to swap, may be {@code null}<a name="line.1946"></a>
+<span class="sourceLineNo">1947</span> * @param offset1 the index of the first element to swap<a name="line.1947"></a>
+<span class="sourceLineNo">1948</span> * @param offset2 the index of the second element to swap<a name="line.1948"></a>
+<span class="sourceLineNo">1949</span> * @throws ArrayIndexOutOfBoundsException if one of the indices is out of range<a name="line.1949"></a>
+<span class="sourceLineNo">1950</span> */<a name="line.1950"></a>
+<span class="sourceLineNo">1951</span> public static void swap(final short[] array, int offset1, int offset2) {<a name="line.1951"></a>
+<span class="sourceLineNo">1952</span> if (array == null) {<a name="line.1952"></a>
+<span class="sourceLineNo">1953</span> return;<a name="line.1953"></a>
+<span class="sourceLineNo">1954</span> }<a name="line.1954"></a>
+<span class="sourceLineNo">1955</span> swap(array, offset1, offset2, 1);<a name="line.1955"></a>
+<span class="sourceLineNo">1956</span> }<a name="line.1956"></a>
+<span class="sourceLineNo">1957</span><a name="line.1957"></a>
+<span class="sourceLineNo">1958</span> /**<a name="line.1958"></a>
+<span class="sourceLineNo">1959</span> * <p>Swaps two elements in the given array.</p><a name="line.1959"></a>
+<span class="sourceLineNo">1960</span> *<a name="line.1960"></a>
+<span class="sourceLineNo">1961</span> * <p>This method does nothing for a {@code null} input array.</p><a name="line.1961"></a>
+<span class="sourceLineNo">1962</span> * <a name="line.1962"></a>
+<span class="sourceLineNo">1963</span> * <p>Examples:<a name="line.1963"></a>
+<span class="sourceLineNo">1964</span> * <ul><a name="line.1964"></a>
+<span class="sourceLineNo">1965</span> * <li>ArrayUtils.swap([1, 2, 3], 0, 2) -> [3, 2, 1]</li><a name="line.1965"></a>
+<span class="sourceLineNo">1966</span> * <li>ArrayUtils.swap([1, 2, 3], 0, 0) -> [1, 2, 3]</li><a name="line.1966"></a>
+<span class="sourceLineNo">1967</span> * <li>ArrayUtils.swap([1, 2, 3], 1, 0) -> [2, 1, 3]</li><a name="line.1967"></a>
+<span class="sourceLineNo">1968</span> * <li>ArrayUtils.swap([1, 2, 3], 0, 5) -> ArrayOutOfBoundsException</li><a name="line.1968"></a>
+<span class="sourceLineNo">1969</span> * </ul><a name="line.1969"></a>
+<span class="sourceLineNo">1970</span> * </p><a name="line.1970"></a>
+<span class="sourceLineNo">1971</span> *<a name="line.1971"></a>
+<span class="sourceLineNo">1972</span> * @param array the array to swap, may be {@code null}<a name="line.1972"></a>
+<span class="sourceLineNo">1973</span> * @param offset1 the index of the first element to swap<a name="line.1973"></a>
+<span class="sourceLineNo">1974</span> * @param offset2 the index of the second element to swap<a name="line.1974"></a>
+<span class="sourceLineNo">1975</span> * @throws ArrayIndexOutOfBoundsException if one of the indices is out of range<a name="line.1975"></a>
+<span class="sourceLineNo">1976</span> */<a name="line.1976"></a>
+<span class="sourceLineNo">1977</span> public static void swap(final char[] array, int offset1, int offset2) {<a name="line.1977"></a>
+<span class="sourceLineNo">1978</span> if (array == null) {<a name="line.1978"></a>
+<span class="sourceLineNo">1979</span> return;<a name="line.1979"></a>
+<span class="sourceLineNo">1980</span> }<a name="line.1980"></a>
+<span class="sourceLineNo">1981</span> swap(array, offset1, offset2, 1);<a name="line.1981"></a>
+<span class="sourceLineNo">1982</span> }<a name="line.1982"></a>
+<span class="sourceLineNo">1983</span><a name="line.1983"></a>
+<span class="sourceLineNo">1984</span> /**<a name="line.1984"></a>
+<span class="sourceLineNo">1985</span> * <p>Swaps two elements in the given array.</p><a name="line.1985"></a>
+<span class="sourceLineNo">1986</span> *<a name="line.1986"></a>
+<span class="sourceLineNo">1987</span> * <p>This method does nothing for a {@code null} input array.</p><a name="line.1987"></a>
+<span class="sourceLineNo">1988</span> *<a name="line.1988"></a>
+<span class="sourceLineNo">1989</span> * <p>Examples:<a name="line.1989"></a>
+<span class="sourceLineNo">1990</span> * <ul><a name="line.1990"></a>
+<span class="sourceLineNo">1991</span> * <li>ArrayUtils.swap([1, 2, 3], 0, 2) -> [3, 2, 1]</li><a name="line.1991"></a>
+<span class="sourceLineNo">1992</span> * <li>ArrayUtils.swap([1, 2, 3], 0, 0) -> [1, 2, 3]</li><a name="line.1992"></a>
+<span class="sourceLineNo">1993</span> * <li>ArrayUtils.swap([1, 2, 3], 1, 0) -> [2, 1, 3]</li><a name="line.1993"></a>
+<span class="sourceLineNo">1994</span> * <li>ArrayUtils.swap([1, 2, 3], 0, 5) -> ArrayOutOfBoundsException</li><a name="line.1994"></a>
+<span class="sourceLineNo">1995</span> * </ul><a name="line.1995"></a>
+<span class="sourceLineNo">1996</span> * </p><a name="line.1996"></a>
+<span class="sourceLineNo">1997</span> * <a name="line.1997"></a>
+<span class="sourceLineNo">1998</span> * @param array the array to swap, may be {@code null}<a name="line.1998"></a>
+<span class="sourceLineNo">1999</span> * @param offset1 the index of the first element to swap<a name="line.1999"></a>
+<span class="sourceLineNo">2000</span> * @param offset2 the index of the second element to swap<a name="line.2000"></a>
+<span class="sourceLineNo">2001</span> * @throws ArrayIndexOutOfBoundsException if one of the indices is out of range<a name="line.2001"></a>
+<span class="sourceLineNo">2002</span> */<a name="line.2002"></a>
+<span class="sourceLineNo">2003</span> public static void swap(final byte[] array, int offset1, int offset2) {<a name="line.2003"></a>
+<span class="sourceLineNo">2004</span> if (array == null) {<a name="line.2004"></a>
+<span class="sourceLineNo">2005</span> return;<a name="line.2005"></a>
+<span class="sourceLineNo">2006</span> }<a name="line.2006"></a>
+<span class="sourceLineNo">2007</span> swap(array, offset1, offset2, 1);<a name="line.2007"></a>
+<span class="sourceLineNo">2008</span> }<a name="line.2008"></a>
+<span class="sourceLineNo">2009</span><a name="line.2009"></a>
+<span class="sourceLineNo">2010</span> /**<a name="line.2010"></a>
+<span class="sourceLineNo">2011</span> * <p>Swaps two elements in the given array.</p><a name="line.2011"></a>
+<span class="sourceLineNo">2012</span> *<a name="line.2012"></a>
+<span class="sourceLineNo">2013</span> * <p>This method does nothing for a {@code null} input array.</p><a name="line.2013"></a>
+<span class="sourceLineNo">2014</span> *<a name="line.2014"></a>
+<span class="sourceLineNo">2015</span> * <p>Examples:<a name="line.2015"></a>
+<span class="sourceLineNo">2016</span> * <ul><a name="line.2016"></a>
+<span class="sourceLineNo">2017</span> * <li>ArrayUtils.swap([1, 2, 3], 0, 2) -> [3, 2, 1]</li><a name="line.2017"></a>
+<span class="sourceLineNo">2018</span> * <li>ArrayUtils.swap([1, 2, 3], 0, 0) -> [1, 2, 3]</li><a name="line.2018"></a>
+<span class="sourceLineNo">2019</span> * <li>ArrayUtils.swap([1, 2, 3], 1, 0) -> [2, 1, 3]</li><a name="line.2019"></a>
+<span class="sourceLineNo">2020</span> * <li>ArrayUtils.swap([1, 2, 3], 0, 5) -> ArrayOutOfBoundsException</li><a name="line.2020"></a>
+<span class="sourceLineNo">2021</span> * </ul><a name="line.2021"></a>
+<span class="sourceLineNo">2022</span> * </p><a name="line.2022"></a>
+<span class="sourceLineNo">2023</span> * <a name="line.2023"></a>
+<span class="sourceLineNo">2024</span> * @param array the array to swap, may be {@code null}<a name="line.2024"></a>
+<span class="sourceLineNo">2025</span> * @param offset1 the index of the first element to swap<a name="line.2025"></a>
+<span class="sourceLineNo">2026</span> * @param offset2 the index of the second element to swap<a name="line.2026"></a>
+<span class="sourceLineNo">2027</span> * @throws ArrayIndexOutOfBoundsException if one of the indices is out of range<a name="line.2027"></a>
+<span class="sourceLineNo">2028</span> */<a name="line.2028"></a>
+<span class="sourceLineNo">2029</span> public static void swap(final double[] array, int offset1, int offset2) {<a name="line.2029"></a>
+<span class="sourceLineNo">2030</span> if (array == null) {<a name="line.2030"></a>
+<span class="sourceLineNo">2031</span> return;<a name="line.2031"></a>
+<span class="sourceLineNo">2032</span> }<a name="line.2032"></a>
+<span class="sourceLineNo">2033</span> swap(array, offset1, offset2, 1);<a name="line.2033"></a>
+<span class="sourceLineNo">2034</span> }<a name="line.2034"></a>
+<span class="sourceLineNo">2035</span><a name="line.2035"></a>
+<span class="sourceLineNo">2036</span> /**<a name="line.2036"></a>
+<span class="sourceLineNo">2037</span> * <p>Swaps two elements in the given array.</p><a name="line.2037"></a>
<span class="sourceLineNo">2038</span> *<a name="line.2038"></a>
-<span class="sourceLineNo">2039</span> * @param array the array to traverse for looking for the object, may be {@code null}<a name="line.2039"></a>
-<span class="sourceLineNo">2040</span> * @param valueToFind the value to find<a name="line.2040"></a>
-<span class="sourceLineNo">2041</span> * @param startIndex the start index to travers backwards from<a name="line.2041"></a>
-<span class="sourceLineNo">2042</span> * @return the last index of the value within the array,<a name="line.2042"></a>
-<span class="sourceLineNo">2043</span> * {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null} array input<a name="line.2043"></a>
-<span class="sourceLineNo">2044</span> */<a name="line.2044"></a>
-<span class="sourceLineNo">2045</span> public static int lastIndexOf(final long[] array, final long valueToFind, int startIndex) {<a name="line.2045"></a>
-<span class="sourceLineNo">2046</span> if (array == null) {<a name="line.2046"></a>
-<span class="sourceLineNo">2047</span> return INDEX_NOT_FOUND;<a name="line.2047"></a>
-<span class="sourceLineNo">2048</span> }<a name="line.2048"></a>
-<span class="sourceLineNo">2049</span> if (startIndex < 0) {<a name="line.2049"></a>
-<span class="sourceLineNo">2050</span> return INDEX_NOT_FOUND;<a name="line.2050"></a>
-<span class="sourceLineNo">2051</span> } else if (startIndex >= array.length) {<a name="line.2051"></a>
-<span class="sourceLineNo">2052</span> startIndex = array.length - 1;<a name="line.2052"></a>
-<span class="sourceLineNo">2053</span> }<a name="line.2053"></a>
-<span class="sourceLineNo">2054</span> for (int i = startIndex; i >= 0; i--) {<a name="line.2054"></a>
-<span class="sourceLineNo">2055</span> if (valueToFind == array[i]) {<a name="line.2055"></a>
-<span class="sourceLineNo">2056</span> return i;<a name="line.2056"></a>
-<span class="sourceLineNo">2057</span> }<a name="line.2057"></a>
+<span class="sourceLineNo">2039</span> * <p>This method does nothing for a {@code null} input array.</p><a name="line.2039"></a>
+<span class="sourceLineNo">2040</span> *<a name="line.2040"></a>
+<span class="sourceLineNo">2041</span> * <p>Examples:<a name="line.2041"></a>
+<span class="sourceLineNo">2042</span> * <ul><a name="line.2042"></a>
+<span class="sourceLineNo">2043</span> * <li>ArrayUtils.swap([1, 2, 3], 0, 2) -> [3, 2, 1]</li><a name="line.2043"></a>
+<span class="sourceLineNo">2044</span> * <li>ArrayUtils.swap([1, 2, 3], 0, 0) -> [1, 2, 3]</li><a name="line.2044"></a>
+<span class="sourceLineNo">2045</span> * <li>ArrayUtils.swap([1, 2, 3], 1, 0) -> [2, 1, 3]</li><a name="line.2045"></a>
+<span class="sourceLineNo">2046</span> * <li>ArrayUtils.swap([1, 2, 3], 0, 5) -> ArrayOutOfBoundsException</li><a name="line.2046"></a>
+<span class="sourceLineNo">2047</span> * </ul><a name="line.2047"></a>
+<span class="sourceLineNo">2048</span> * </p><a name="line.2048"></a>
+<span class="sourceLineNo">2049</span> * <a name="line.2049"></a>
+<span class="sourceLineNo">2050</span> * @param array the array to swap, may be {@code null}<a name="line.2050"></a>
+<span class="sourceLineNo">2051</span> * @param offset1 the index of the first element to swap<a name="line.2051"></a>
+<span class="sourceLineNo">2052</span> * @param offset2 the index of the second element to swap<a name="line.2052"></a>
+<span class="sourceLineNo">2053</span> * @throws ArrayIndexOutOfBoundsException if one of the indices is out of range<a name="line.2053"></a>
+<span class="sourceLineNo">2054</span> */<a name="line.2054"></a>
+<span class="sourceLineNo">2055</span> public static void swap(final float[] array, int offset1, int offset2) {<a name="line.2055"></a>
+<span class="sourceLineNo">2056</span> if (array == null) {<a name="line.2056"></a>
+<span class="sourceLineNo">2057</span> return;<a name="line.2057"></a>
<span class="sourceLineNo">2058</span> }<a name="line.2058"></a>
-<span class="sourceLineNo">2059</span> return INDEX_NOT_FOUND;<a name="line.2059"></a>
+<span class="sourceLineNo">2059</span> swap(array, offset1, offset2, 1);<a name="line.2059"></a>
<span class="sourceLineNo">2060</span> }<a name="line.2060"></a>
<span class="sourceLineNo">2061</span><a name="line.2061"></a>
<span class="sourceLineNo">2062</span> /**<a name="line.2062"></a>
-<span class="sourceLineNo">2063</span> * <p>Checks if the value is in the given array.</p><a name="line.2063"></a>
+<span class="sourceLineNo">2063</span> * <p>Swaps two elements in the given array.</p><a name="line.2063"></a>
<span class="sourceLineNo">2064</span> *<a name="line.2064"></a>
-<span class="sourceLineNo">2065</span> * <p>The method returns {@code false} if a {@code null} array is passed in.</p><a name="line.2065"></a>
+<span class="sourceLineNo">2065</span> * <p>This method does nothing for a {@code null} input array.</p><a name="line.2065"></a>
<span class="sourceLineNo">2066</span> *<a name="line.2066"></a>
-<span class="sourceLineNo">2067</span> * @param array the array to search through<a name="line.2067"></a>
-<span class="sourceLineNo">2068</span> * @param valueToFind the value to find<a name="line.2068"></a>
-<span class="sourceLineNo">2069</span> * @return {@code true} if the array contains the object<a name="line.2069"></a>
-<span class="sourceLineNo">2070</span> */<a name="line.2070"></a>
-<span class="sourceLineNo">2071</span> public static boolean contains(final long[] array, final long valueToFind) {<a name="line.2071"></a>
-<span class="sourceLineNo">2072</span> return indexOf(array, valueToFind) != INDEX_NOT_FOUND;<a name="line.2072"></a>
-<span class="sourceLineNo">2073</span> }<a name="line.2073"></a>
-<span class="sourceLineNo">2074</span><a name="line.2074"></a>
-<span class="sourceLineNo">2075</span> // int IndexOf<a name="line.2075"></a>
-<span class="sourceLineNo">2076</span> //-----------------------------------------------------------------------<a name="line.2076"></a>
-<span class="sourceLineNo">2077</span> /**<a name="line.2077"></a>
-<span class="sourceLineNo">2078</span> * <p>Finds the index of the given value in the array.</p><a name="line.2078"></a>
-<span class="sourceLineNo">2079</span> *<a name="line.2079"></a>
-<span class="sourceLineNo">2080</span> * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.</p><a name="line.2080"></a>
-<span class="sourceLineNo">2081</span> *<a name="line.2081"></a>
-<span class="sourceLineNo">2082</span> * @param array the array to search through for the object, may be {@code null}<a name="line.2082"></a>
-<span class="sourceLineNo">2083</span> * @param valueToFind the value to find<a name="line.2083"></a>
-<span class="sourceLineNo">2084</span> * @return the index of the value within the array,<a name="line.2084"></a>
-<span class="sourceLineNo">2085</span> * {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null} array input<a name="line.2085"></a>
-<span class="sourceLineNo">2086</span> */<a name="line.2086"></a>
-<span class="sourceLineNo">2087</span> public static int indexOf(final int[] array, final int valueToFind) {<a name="line.2087"></a>
-<span class="sourceLineNo">2088</span> return indexOf(array, valueToFind, 0);<a name="line.2088"></a>
-<span class="sourceLineNo">2089</span> }<a name="line.2089"></a>
-<span class="sourceLineNo">2090</span><a name="line.2090"></a>
-<span class="sourceLineNo">2091</span> /**<a name="line.2091"></a>
-<span class="sourceLineNo">2092</span> * <p>Finds the index of the given value in the array starting at the given index.</p><a name="line.2092"></a>
-<span class="sourceLineNo">2093</span> *<a name="line.2093"></a>
-<span class="sourceLineNo">2094</span> * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.</p><a name="line.2094"></a>
-<span class="sourceLineNo">2095</span> *<a name="line.2095"></a>
-<span class="sourceLineNo">2096</span> * <p>A negative startIndex is treated as zero. A startIndex larger than the array<a name="line.2096"></a>
-<span class="sourceLineNo">2097</span> * length will return {@link #INDEX_NOT_FOUND} ({@code -1}).</p><a name="line.2097"></a>
-<span class="sourceLineNo">2098</span> *<a name="line.2098"></a>
-<span class="sourceLineNo">2099</span> * @param array the array to search through for the object, may be {@code null}<a name="line.2099"></a>
-<span class="sourceLineNo">2100</span> * @param valueToFind the value to find<a name="line.2100"></a>
-<span class="sourceLineNo">2101</span> * @param startIndex the index to start searching at<a name="line.2101"></a>
-<span class="sourceLineNo">2102</span> * @return the index of the value within the array,<a name="line.2102"></a>
-<span class="sourceLineNo">2103</span> * {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null} array input<a name="line.2103"></a>
-<span class="sourceLineNo">2104</span> */<a name="line.2104"></a>
-<span class="sourceLineNo">2105</span> public static int indexOf(final int[] array, final int valueToFind, int startIndex) {<a name="line.2105"></a>
-<span class="sourceLineNo">2106</span> if (array == null) {<a name="line.2106"></a>
-<span class="sourceLineNo">2107</span> return INDEX_NOT_FOUND;<a name="line.2107"></a>
-<span class="sourceLineNo">2108</span> }<a name="line.2108"></a>
-<span class="sourceLineNo">2109</span> if (startIndex < 0) {<a name="line.2109"></a>
-<span class="sourceLineNo">2110</span> startIndex = 0;<a name="line.2110"></a>
+<span class="sourceLineNo">2067</span> * <p>Examples:<a name="line.2067"></a>
+<span class="sourceLineNo">2068</span> * <ul><a name="line.2068"></a>
+<span class="sourceLineNo">2069</span> * <li>ArrayUtils.swap([1, 2, 3], 0, 2) -> [3, 2, 1]</li><a name="line.2069"></a>
+<span class="sourceLineNo">2070</span> * <li>ArrayUtils.swap([1, 2, 3], 0, 0) -> [1, 2, 3]</li><a name="line.2070"></a>
+<span class="sourceLineNo">2071</span> * <li>ArrayUtils.swap([1, 2, 3], 1, 0) -> [2, 1, 3]</li><a name="line.2071"></a>
+<span class="sourceLineNo">2072</span> * <li>ArrayUtils.swap([1, 2, 3], 0, 5) -> ArrayOutOfBoundsException</li><a name="line.2072"></a>
+<span class="sourceLineNo">2073</span> * </ul><a name="line.2073"></a>
+<span class="sourceLineNo">2074</span> * </p><a name="line.2074"></a>
+<span class="sourceLineNo">2075</span> * <a name="line.2075"></a>
+<span class="sourceLineNo">2076</span> * @param array the array to swap, may be {@code null}<a name="line.2076"></a>
+<span class="sourceLineNo">2077</span> * @param offset1 the index of the first element to swap<a name="line.2077"></a>
+<span class="sourceLineNo">2078</span> * @param offset2 the index of the second element to swap<a name="line.2078"></a>
+<span class="sourceLineNo">2079</span> * @throws ArrayIndexOutOfBoundsException if one of the indices is out of range<a name="line.2079"></a>
+<span class="sourceLineNo">2080</span> */<a name="line.2080"></a>
+<span class="sourceLineNo">2081</span> public static void swap(final boolean[] array, int offset1, int offset2) {<a name="line.2081"></a>
+<span class="sourceLineNo">2082</span> if (array == null) {<a name="line.2082"></a>
+<span class="sourceLineNo">2083</span> return;<a name="line.2083"></a>
+<span class="sourceLineNo">2084</span> }<a name="line.2084"></a>
+<span class="sourceLineNo">2085</span> swap(array, offset1, offset2, 1);<a name="line.2085"></a>
+<span class="sourceLineNo">2086</span> }<a name="line.2086"></a>
+<span class="sourceLineNo">2087</span><a name="line.2087"></a>
+<span class="sourceLineNo">2088</span> /**<a name="line.2088"></a>
+<span class="sourceLineNo">2089</span> * <p>Swaps a series of elements in the given array.</p><a name="line.2089"></a>
+<span class="sourceLineNo">2090</span> * <a name="line.2090"></a>
+<span class="sourceLineNo">2091</span> * <p>This method does nothing for a {@code null} input array.</p><a name="line.2091"></a>
+<span class="sourceLineNo">2092</span> * <a name="line.2092"></a>
+<span class="sourceLineNo">2093</span> * <p>Examples:<a name="line.2093"></a>
+<span class="sourceLineNo">2094</span> * <ul><a name="line.2094"></a>
+<span class="sourceLineNo">2095</span> * <li>ArrayUtils.swap(["1", "2", "3", "4"], 0, 2, 1) -> ["3", "2", "1", "4"]</li><a name="line.2095"></a>
+<span class="sourceLineNo">2096</span> * <li>ArrayUtils.swap(["1", "2", "3", "4"], 0, 0, 1) -> ["1", "2", "3", "4"]</li><a name="line.2096"></a>
+<span class="sourceLineNo">2097</span> * <li>ArrayUtils.swap(["1", "2", "3", "4"], 2, 0, 2) -> ["3", "4", "1", "2"]</li><a name="line.2097"></a>
+<span class="sourceLineNo">2098</span> * <li>ArrayUtils.swap(["1", "2", "3", "4"], 0, 3, 3) -> ArrayOutOfBoundsException</li><a name="line.2098"></a>
+<span class="sourceLineNo">2099</span> * </ul><a name="line.2099"></a>
+<span class="sourceLineNo">2100</span> * </p><a name="line.2100"></a>
+<span class="sourceLineNo">2101</span> * <a name="line.2101"></a>
+<span class="sourceLineNo">2102</span> * @param array the array to swap, may be {@code null}<a name="line.2102"></a>
+<span class="sourceLineNo">2103</span> * @param offset1 the index of the first element in the series to swap<a name="line.2103"></a>
+<span class="sourceLineNo">2104</span> * @param offset2 the index of the second element in the series to swap<a name="line.2104"></a>
+<span class="sourceLineNo">2105</span> * @param len the number of elements to swap starting with the given indices<a name="line.2105"></a>
+<span class="sourceLineNo">2106</span> * @throws ArrayIndexOutOfBoundsException if one of the indices (plus the length of the series to swap) is out of range<a name="line.2106"></a>
+<span class="sourceLineNo">2107</span> */<a name="line.2107"></a>
+<span class="sourceLineNo">2108</span> public static void swap(final boolean[] array, int offset1, int offset2, int len) {<a name="line.2108"></a>
+<span class="sourceLineNo">2109</span> if (array == null) {<a name="line.2109"></a>
+<span class="sourceLineNo">2110</span> return;<a name="line.2110"></a>
<span class="sourceLineNo">2111</span> }<a name="line.2111"></a>
-<span class="sourceLineNo">2112</span> for (int i = startIndex; i < array.length; i++) {<a name="line.2112"></a>
-<span class="sourceLineNo">2113</span> if (valueToFind == array[i]) {<a name="line.2113"></a>
-<span class="sourceLineNo">2114</span> return i;<a name="line.2114"></a>
-<span class="sourceLineNo">2115</span> }<a name="line.2115"></a>
+<span class="sourceLineNo">2112</span> for (int i = 0; i < len; i++) {<a name="line.2112"></a>
+<span class="sourceLineNo">2113</span> boolean aux = array[offset1 + i];<a name="line.2113"></a>
+<span class="sourceLineNo">2114</span> array[offset1 + i] = array[offset2 + i];<a name="line.2114"></a>
+<span class="sourceLineNo">2115</span> array[offset2 + i] = aux;<a name="line.2115"></a>
<span class="sourceLineNo">2116</span> }<a name="line.2116"></a>
-<span class="sourceLineNo">2117</span> return INDEX_NOT_FOUND;<a name="line.2117"></a>
-<span class="sourceLineNo">2118</span> }<a name="line.2118"></a>
-<span class="sourceLineNo">2119</span><a name="line.2119"></a>
-<span class="sourceLineNo">2120</span> /**<a name="line.2120"></a>
-<span class="sourceLineNo">2121</span> * <p>Finds the last index of the given value within the array.</p><a name="line.2121"></a>
-<span class="sourceLineNo">2122</span> *<a name="line.2122"></a>
-<span class="sourceLineNo">2123</span> * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.</p><a name="line.2123"></a>
-<span class="sourceLineNo">2124</span> *<a name="line.2124"></a>
-<span class="sourceLineNo">2125</span> * @param array the array to travers backwords looking for the object, may be {@code null}<a name="line.2125"></a>
-<span class="sourceLineNo">2126</span> * @param valueToFind the object to find<a name="line.2126"></a>
-<span class="sourceLineNo">2127</span> * @return the last index of the value within the array,<a name="line.2127"></a>
-<span class="sourceLineNo">2128</span> * {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null} array input<a name="line.2128"></a>
-<span class="sourceLineNo">2129</span> */<a name="line.2129"></a>
-<span class="sourceLineNo">2130</span> public static int lastIndexOf(final int[] array, final int valueToFind) {<a name="line.2130"></a>
-<span class="sourceLineNo">2131</span> return lastIndexOf(array, valueToFind, Integer.MAX_VALUE);<a name="line.2131"></a>
-<span class="sourceLineNo">2132</span> }<a name="line.2132"></a>
-<span class="sourceLineNo">2133</span><a name="line.2133"></a>
-<span class="sourceLineNo">2134</span> /**<a name="line.2134"></a>
-<span class="sourceLineNo">2135</span> * <p>Finds the last index of the given value in the array starting at the given index.</p><a name="line.2135"></a>
-<span class="sourceLineNo">2136</span> *<a name="line.2136"></a>
-<span class="sourceLineNo">2137</span> * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.</p><a name="line.2137"></a>
-<span class="sourceLineNo">2138</span> *<a name="line.2138"></a>
-<span class="sourceLineNo">2139</span> * <p>A negative startIndex will return {@link #INDEX_NOT_FOUND} ({@code -1}). A startIndex larger than the<a name="line.2139"></a>
-<span class="sourceLineNo">2140</span> * array length will search from the end of the array.</p><a name="line.2140"></a>
-<span class="sourceLineNo">2141</span> *<a name="line.2141"></a>
-<span class="sourceLineNo">2142</span> * @param array the array to traverse for looking for the object, may be {@code null}<a name="line.2142"></a>
-<span class="sourceLineNo">2143</span> * @param valueToFind the value to find<a name="line.2143"></a>
-<span class="sourceLineNo">2144</span> * @param startIndex the start index to travers backwards from<a name="line.2144"></a>
-<span class="sourceLineNo">2145</span> * @return the last index of the value within the array,<a name="line.2145"></a>
-<span class="sourceLineNo">2146</span> * {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null} array input<a name="line.2146"></a>
-<span class="sourceLineNo">2147</span> */<a name="line.2147"></a>
-<span class="sourceLineNo">2148</span> public static int lastIndexOf(final int[] array, final int valueToFind, int startIndex) {<a name="line.2148"></a>
-<span class="sourceLineNo">2149</span> if (array == null) {<a name="line.2149"></a>
-<span class="sourceLineNo">2150</span> return INDEX_NOT_FOUND;<a name="line.2150"></a>
-<span class="sourceLineNo">2151</span> }<a name="line.2151"></a>
-<span class="sourceLineNo">2152</span> if (startIndex < 0) {<a name="line.2152"></a>
-<span class="sourceLineNo">2153</span> return INDEX_NOT_FOUND;<a name="line.2153"></a>
-<span class="sourceLineNo">2154</span> } else if (startIndex >= array.length) {<a name="line.2154"></a>
-<span class="sourceLineNo">2155</span> startIndex = array.length - 1;<a name="line.2155"></a>
-<span class="sourceLineNo">2156</span> }<a name="line.2156"></a>
-<span class="sourceLineNo">2157</span> for (int i = startIndex; i >= 0; i--) {<a name="line.2157"></a>
-<span class="sourceLineNo">2158</span> if (valueToFind == array[i]) {<a name="line.2158"></a>
-<span class="sourceLineNo">2159</span> return i;<a name="line.2159"></a>
-<span class="sourceLineNo">2160</span> }<a name="line.2160"></a>
-<span class="sourceLineNo">2161</span> }<a name="line.2161"></a>
-<span class="sourceLineNo">2162</span> return INDEX_NOT_FOUND;<a name="line.2162"></a>
-<span class="sourceLineNo">2163</span> }<a name="line.2163"></a>
-<span class="sourceLineNo">2164</span><a name="line.2164"></a>
-<span class="sourceLineNo">2165</span> /**<a name="line.2165"></a>
-<span class="sourceLineNo">2166</span> * <p>Checks if the value is in the given array.</p><a name="line.2166"></a>
-<span class="sourceLineNo">2167</span> *<a name="line.2167"></a>
-<span class="sourceLineNo">2168</span> * <p>The method returns {@code false} if a {@code null} array is passed in.</p><a name="line.2168"></a>
-<span class="sourceLineNo">2169</span> *<a name="line.2169"></a>
-<span class="sourceLineNo">2170</span> * @param array the array to search through<a name="line.2170"></a>
-<span class="sourceLineNo">2171</span> * @param valueToFind the value to find<a name="line.2171"></a>
-<span class="sourceLineNo">2172</span> * @return {@code true} if the array contains the object<a name="line.2172"></a>
-<span class="sourceLineNo">2173</span> */<a name="line.2173"></a>
-<span class="sourceLineNo">2174</span> public static boolean contains(final int[] array, final int valueToFind) {<a name="line.2174"></a>
-<span class="sourceLineNo">2175</span> return indexOf(array, valueToFind) != INDEX_NOT_FOUND;<a name="line.2175"></a>
-<span class="sourceLineNo">2176</span> }<a name="line.2176"></a>
-<span class="sourceLineNo">2177</span><a name="line.2177"></a>
-<span class="sourceLineNo">2178</span> // short IndexOf<a name="line.2178"></a>
-<span class="sourceLineNo">2179</span> //-----------------------------------------------------------------------<a name="line.2179"></a>
-<span class="sourceLineNo">2180</span> /**<a name="line.2180"></a>
-<span class="sourceLineNo">2181</span> * <p>Finds the index of the given value in the array.</p><a name="line.2181"></a>
-<span class="sourceLineNo">2182</span> *<a name="line.2182"></a>
-<span class="sourceLineNo">2183</span> * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.</p><a name="line.2183"></a>
-<span class="sourceLineNo">2184</span> *<a name="line.2184"></a>
-<span class="sourceLineNo">2185</span> * @param array the array to search through for the object, may be {@code null}<a name="line.2185"></a>
-<span class="sourceLineNo">2186</span> * @param valueToFind the value to find<a name="line.2186"></a>
-<span class="sourceLineNo">2187</span> * @return the index of the value within the array,<a name="line.2187"></a>
-<span class="sourceLineNo">2188</span> * {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null} array input<a name="line.2188"></a>
-<span class="sourceLineNo">2189</span> */<a name="line.2189"></a>
-<span class="sourceLineNo">2190</span> public static int indexOf(final short[] array, final short valueToFind) {<a name="line.2190"></a>
-<span class="sourceLineNo">2191</span> return indexOf(array, valueToFind, 0);<a name="line.2191"></a>
-<span class="sourceLineNo">2192</span> }<a name="line.2192"></a>
-<span class="sourceLineNo">2193</span><a name="line.2193"></a>
-<span class="sourceLineNo">2194</span> /**<a name="line.2194"></a>
-<span class="sourceLineNo">2195</span> * <p>Finds the index of the given value in the array starting at the given index.</p><a name="line.2195"></a>
-<span class="sourceLineNo">2196</span> *<a name="line.2196"></a>
-<span class="sourceLineNo">2197</span> * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.</p><a name="line.2197"></a>
-<span class="sourceLineNo">2198</span> *<a name="line.2198"></a>
-<span class="sourceLineNo">2199</span> * <p>A negative startIndex is treated as zero. A startIndex larger than the array<a name="line.2199"></a>
-<span class="sourceLineNo">2200</span> * length will return {@link #INDEX_NOT_FOUND} ({@code -1}).</p><a name="line.2200"></a>
-<span class="sourceLineNo">2201</span> *<a name="line.2201"></a>
-<span class="sourceLineNo">2202</span> * @param array the array to search through for the object, may be {@code null}<a name="line.2202"></a>
-<span class="sourceLineNo">2203</span> * @param valueToFind the value to find<a name="line.2203"></a>
-<span class="sourceLineNo">2204</span> * @param startIndex the index to start searching at<a name="line.2204"></a>
-<span class="sourceLineNo">2205</span> * @return the index of the value within the array,<a name="line.2205"></a>
-<span class="sourceLineNo">2206</span> * {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null} array input<a name="line.2206"></a>
-<span class="sourceLineNo">2207</span> */<a name="line.2207"></a>
-<span class="sourceLineNo">2208</span> public static int indexOf(final short[] array, final short valueToFind, int startIndex) {<a name="line.2208"></a>
-<span class="sourceLineNo">2209</span> if (array == null) {<a name="line.2209"></a>
-<span class="sourceLineNo">2210</span> return INDEX_NOT_FOUND;<a name="line.2210"></a>
-<span class="sourceLineNo">2211</span> }<a name="line.2211"></a>
-<span class="sourceLineNo">2212</span> if (startIndex < 0) {<a name="line.2212"></a>
-<span class="sourceLineNo">2213</span> startIndex = 0;<a name="line.2213"></a>
-<span class="sourceLineNo">2214</span> }<a name="line.2214"></a>
-<span class="sourceLineNo">2215</span> for (int i = startIndex; i < array.length; i++) {<a name="line.2215"></a>
-<span class="sourceLineNo">2216</span> if (valueToFind == array[i]) {<a name="line.2216"></a>
-<span class="sourceLineNo">2217</span> return i;<a name="line.2217"></a>
-<span class="sourceLineNo">2218</span> }<a name="line.2218"></a>
-<span class="sourceLineNo">2219</span> }<a name="line.2219"></a>
-<span class="sourceLineNo">2220</span> return INDEX_NOT_FOUND;<a name="line.2220"></a>
-<span class="sourceLineNo">2221</span> }<a name="line.2221"></a>
-<span class="sourceLineNo">2222</span><a name="line.2222"></a>
-<span class="sourceLineNo">2223</span> /**<a name="line.2223"></a>
-<span class="sourceLineNo">2224</span> * <p>Finds the last index of the given value within the array.</p><a name="line.2224"></a>
-<span class="sourceLineNo">2225</span> *<a name="line.2225"></a>
-<span class="sourceLineNo">2226</span> * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.</p><a name="line.2226"></a>
-<span class="sourceLineNo">2227</span> *<a name="line.2227"></a>
-<span class="sourceLineNo">2228</span> * @param array the array to travers backwords looking for the object, may be {@code null}<a name="line.2228"></a>
-<span class="sourceLineNo">2229</span> * @param valueToFind the object to find<a name="line.2229"></a>
-<span class="sourceLineNo">2230</span> * @return the last index of the value within the array,<a name="line.2230"></a>
-<span class="sourceLineNo">2231</span> * {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null} array input<a name="line.2231"></a>
+<span class="sourceLineNo">2117</span> }<a name="line.2117"></a>
+<span class="sourceLineNo">2118</span><a name="line.2118"></a>
+<span class="sourceLineNo">2119</span> /**<a name="line.2119"></a>
+<span class="sourceLineNo">2120</span> * <p>Swaps a series of elements in the given array.</p><a name="line.2120"></a>
+<span class="sourceLineNo">2121</span> * <a name="line.2121"></a>
+<span class="sourceLineNo">2122</span> * <p>This method does nothing for a {@code null} input array.</p><a name="line.2122"></a>
+<span class="sourceLineNo">2123</span> * <a name="line.2123"></a>
+<span class="sourceLineNo">2124</span> * <p>Examples:<a name="line.2124"></a>
+<span class="sourceLineNo">2125</span> * <ul><a name="line.2125"></a>
+<span class="sourceLineNo">2126</span> * <li>ArrayUtils.swap([true, false, true, false], 0, 2, 1) -> [true, false, true, false]</li><a name="line.2126"></a>
+<span class="sourceLineNo">2127</span> * <li>ArrayUtils.swap([true, false, true, false], 0, 0, 1) -> [true, false, true, false]</li><a name="line.2127"></a>
+<span class="sourceLineNo">2128</span> * <li>ArrayUtils.swap([true, false, true, false], 0, 2, 2) -> [true, false, true, false]</li><a name="line.2128"></a>
+<span class="sourceLineNo">2129</span> * <li>ArrayUtils.swap([true, false, true, false], 0, 5, 3) -> ArrayOutOfBoundsException</li><a name="line.2129"></a>
+<span class="sourceLineNo">2130</span> * </ul><a name="line.2130"></a>
+<span class="sourceLineNo">2131</span> * </p><a name="line.2131"></a>
+<span class="sourceLineNo">2132</span> * <a name="line.2132"></a>
+<span class="sourceLineNo">2133</span> * @param array the array to swap, may be {@code null}<a name="line.2133"></a>
+<span class="sourceLineNo">2134</span> * @param offset1 the index of the first element in the series to swap<a name="line.2134"></a>
+<span class="sourceLineNo">2135</span> * @param offset2 the index of the second element in the series to swap<a name="line.2135"></a>
+<span class="sourceLineNo">2136</span> * @param len the number of elements to swap starting with the given indices<a name="line.2136"></a>
+<span class="sourceLineNo">2137</span> * @throws ArrayIndexOutOfBoundsException if one of the indices (plus the length of the series to swap) is out of range<a name="line.2137"></a>
+<span class="sourceLineNo">2138</span> */<a name="line.2138"></a>
+<span class="sourceLineNo">2139</span><a name="line.2139"></a>
+<span class="sourceLineNo">2140</span> public static void swap(final byte[] array, int offset1, int offset2, int len) {<a name="line.2140"></a>
+<span class="sourceLineNo">2141</span> if (array == null) {<a name="line.2141"></a>
+<span class="sourceLineNo">2142</span> return;<a name="line.2142"></a>
+<span class="sourceLineNo">2143</span> }<a name="line.2143"></a>
+<span class="sourceLineNo">2144</span> for (int i = 0; i < len; i++) {<a name="line.2144"></a>
+<span class="sourceLineNo">2145</span> byte aux = array[offset1 + i];<a name="line.2145"></a>
+<span class="sourceLineNo">2146</span> array[offset1 + i] = array[offset2 + i];<a name="line.2146"></a>
+<span class="sourceLineNo">2147</span> array[offset2 + i] = aux;<a name="line.2147"></a>
+<span class="sourceLineNo">2148</span> }<a name="line.2148"></a>
+<span class="sourceLineNo">2149</span> }<a name="line.2149"></a>
+<span class="sourceLineNo">2150</span><a name="line.2150"></a>
+<span class="sourceLineNo">2151</span> /**<a name="line.2151"></a>
+<span class="sourceLineNo">2152</span> * <p>Swaps a series of elements in the given array.</p><a name="line.2152"></a>
+<span class="sourceLineNo">2153</span> * <a name="line.2153"></a>
+<span class="sourceLineNo">2154</span> * <p>This method does nothing for a {@code null} input array.</p><a name="line.2154"></a>
+<span class="sourceLineNo">2155</span> * <a name="line.2155"></a>
+<span class="sourceLineNo">2156</span> * <p>Examples:<a name="line.2156"></a>
+<span class="sourceLineNo">2157</span> * <ul><a name="line.2157"></a>
+<span class="sourceLineNo">2158</span> * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 2, 1) -> [3, 2, 1, 4]</li><a name="line.2158"></a>
+<span class="sourceLineNo">2159</span> * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 0, 1) -> [1, 2, 3, 4]</li><a name="line.2159"></a>
+<span class="sourceLineNo">2160</span> * <li>ArrayUtils.swap([1, 2, 3, 4], 2, 0, 2) -> [3, 4, 1, 2]</li><a name="line.2160"></a>
+<span class="sourceLineNo">2161</span> * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 3, 3) -> ArrayOutOfBoundsException</li><a name="line.2161"></a>
+<span class="sourceLineNo">2162</span> * </ul><a name="line.2162"></a>
+<span class="sourceLineNo">2163</span> * </p><a name="line.2163"></a>
+<span class="sourceLineNo">2164</span> * <a name="line.2164"></a>
+<span class="sourceLineNo">2165</span> * @param array the array to swap, may be {@code null}<a name="line.2165"></a>
+<span class="sourceLineNo">2166</span> * @param offset1 the index of the first element in the series to swap<a name="line.2166"></a>
+<span class="sourceLineNo">2167</span> * @param offset2 the index of the second element in the series to swap<a name="line.2167"></a>
+<span class="sourceLineNo">2168</span> * @param len the number of elements to swap starting with the given indices<a name="line.2168"></a>
+<span class="sourceLineNo">2169</span> * @throws ArrayIndexOutOfBoundsException if one of the indices (plus the length of the series to swap) is out of range<a name="line.2169"></a>
+<span class="sourceLineNo">2170</span> */<a name="line.2170"></a>
+<span class="sourceLineNo">2171</span> public static void swap(final char[] array, int offset1, int offset2, int len) {<a name="line.2171"></a>
+<span class="sourceLineNo">2172</span> if (array == null) {<a name="line.2172"></a>
+<span class="sourceLineNo">2173</span> return;<a name="line.2173"></a>
+<span class="sourceLineNo">2174</span> }<a name="line.2174"></a>
+<span class="sourceLineNo">2175</span> for (int i = 0; i < len; i++) {<a name="line.2175"></a>
+<span class="sourceLineNo">2176</span> char aux = array[offset1 + i];<a name="line.2176"></a>
+<span class="sourceLineNo">2177</span> array[offset1 + i] = array[offset2 + i];<a name="line.2177"></a>
+<span class="sourceLineNo">2178</span> array[offset2 + i] = aux;<a name="line.2178"></a>
+<span class="sourceLineNo">2179</span> }<a name="line.2179"></a>
+<span class="sourceLineNo">2180</span> }<a name="line.2180"></a>
+<span class="sourceLineNo">2181</span><a name="line.2181"></a>
+<span class="sourceLineNo">2182</span> /**<a name="line.2182"></a>
+<span class="sourceLineNo">2183</span> * <p>Swaps a series of elements in the given array.</p><a name="line.2183"></a>
+<span class="sourceLineNo">2184</span> * <a name="line.2184"></a>
+<span class="sourceLineNo">2185</span> * <p>This method does nothing for a {@code null} input array.</p><a name="line.2185"></a>
+<span class="sourceLineNo">2186</span> * <a name="line.2186"></a>
+<span class="sourceLineNo">2187</span> * <p>Examples:<a name="line.2187"></a>
+<span class="sourceLineNo">2188</span> * <ul><a name="line.2188"></a>
+<span class="sourceLineNo">2189</span> * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 2, 1) -> [3, 2, 1, 4]</li><a name="line.2189"></a>
+<span class="sourceLineNo">2190</span> * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 0, 1) -> [1, 2, 3, 4]</li><a name="line.2190"></a>
+<span class="sourceLineNo">2191</span> * <li>ArrayUtils.swap([1, 2, 3, 4], 2, 0, 2) -> [3, 4, 1, 2]</li><a name="line.2191"></a>
+<span class="sourceLineNo">2192</span> * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 3, 3) -> ArrayOutOfBoundsException</li><a name="line.2192"></a>
+<span class="sourceLineNo">2193</span> * </ul><a name="line.2193"></a>
+<span class="sourceLineNo">2194</span> * </p><a name="line.2194"></a>
+<span class="sourceLineNo">2195</span> * <a name="line.2195"></a>
+<span class="sourceLineNo">2196</span> * @param array the array to swap, may be {@code null}<a name="line.2196"></a>
+<span class="sourceLineNo">2197</span> * @param offset1 the index of the first element in the series to swap<a name="line.2197"></a>
+<span class="sourceLineNo">2198</span> * @param offset2 the index of the second element in the series to swap<a name="line.2198"></a>
+<span class="sourceLineNo">2199</span> * @param len the number of elements to swap starting with the given indices<a name="line.2199"></a>
+<span class="sourceLineNo">2200</span> * @throws ArrayIndexOutOfBoundsException if one of the indices (plus the length of the series to swap) is out of range<a name="line.2200"></a>
+<span class="sourceLineNo">2201</span> */<a name="line.2201"></a>
+<span class="sourceLineNo">2202</span> public static void swap(final double[] array, int offset1, int offset2, int len) {<a name="line.2202"></a>
+<span class="sourceLineNo">2203</span> if (array == null) {<a name="line.2203"></a>
+<span class="sourceLineNo">2204</span> return;<a name="line.2204"></a>
+<span class="sourceLineNo">2205</span> }<a name="line.2205"></a>
+<span class="sourceLineNo">2206</span> for (int i = 0; i < len; i++) {<a name="line.2206"></a>
+<span class="sourceLineNo">2207</span> double aux = array[offset1 + i];<a name="line.2207"></a>
+<span class="sourceLineNo">2208</span> array[offset1 + i] = array[offset2 + i];<a name="line.2208"></a>
+<span class="sourceLineNo">2209</span> array[offset2 + i] = aux;<a name="line.2209"></a>
+<span class="sourceLineNo">2210</span> }<a name="line.2210"></a>
+<span class="sourceLineNo">2211</span> }<a name="line.2211"></a>
+<span class="sourceLineNo">2212</span><a name="line.2212"></a>
+<span class="sourceLineNo">2213</span> /**<a name="line.2213"></a>
+<span class="sourceLineNo">2214</span> * <p>Swaps a series of elements in the given array.</p><a name="line.2214"></a>
+<span class="sourceLineNo">2215</span> * <a name="line.2215"></a>
+<span class="sourceLineNo">2216</span> * <p>This method does nothing for a {@code null} input array.</p><a name="line.2216"></a>
+<span class="sourceLineNo">2217</span> * <a name="line.2217"></a>
+<span class="sourceLineNo">2218</span> * <p>Examples:<a name="line.2218"></a>
+<span class="sourceLineNo">2219</span> * <ul><a name="line.2219"></a>
+<span class="sourceLineNo">2220</span> * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 2, 1) -> [3, 2, 1, 4]</li><a name="line.2220"></a>
+<span class="sourceLineNo">2221</span> * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 0, 1) -> [1, 2, 3, 4]</li><a name="line.2221"></a>
+<span class="sourceLineNo">2222</span> * <li>ArrayUtils.swap([1, 2, 3, 4], 2, 0, 2) -> [3, 4, 1, 2]</li><a name="line.2222"></a>
+<span class="sourceLineNo">2223</span> * <li>ArrayUtils.swap([1, 2, 3, 4], 0, 3, 3) -> ArrayOutOfBoundsException</li><a name="line.2223"></a>
+<span class="sourceLineNo">2224</span> * </ul><a name="line.2224"></a>
+<span class="sourceLineNo">2225</span> * </p><a name="line.2225"></a>
+<span class="sourceLineNo">2226</span> * <a name="line.2226"></a>
+<span class="sourceLineNo">2227</span> * @param array the array to swap, may be {@code null}<a name="line.2227"></a>
+<span class="sourceLineNo">2228</span> * @param offset1 the index of the first element in the series to swap<a name="line.2228"></a>
+<span class="sourceLineNo">2229</span> * @param offset2 the index of the second element in the series to swap<a name="line.2229"></a>
+<span class="sourceLineNo">2230</span> * @param len the number of elements to swap starting with the given indices<a name="line.2230"></a>
+<span class="sourceLineNo">2231</span> * @throws ArrayIndexOutOfBoundsException if one of the indices (plus the length of the series to swap) is out of range<a name="line.2231"></a>
<span class="sourceLineNo">2232</span> */<a name="line.2232"></a>
-<span class="sourceLineNo">2233</span> public static int lastIndexOf(final short[] array, final short valueToFind) {<a name="line.2233"></a>
-<span class="sourceLineNo">2234</span> return lastIndexOf(array, valueToFind, Integer.MAX_VALUE);<a name="line.2234"></a>
-<span class="sourceLineNo">2235</span> }<a name="line.2235"></a>
-<span class="sourceLineNo">2236</span><a name="line.2236"></a>
-<span class="sourceLineNo">2237</span> /**<a name="line.2237"></a>
-<span class="sourceLineNo">2238</span> * <p>Finds the last index of the given value in the array starting at the given index.</p><a name="line.2238"></a>
-<span class="sourceLineNo">2239</span> *<a name="line.2239"></a>
-<span class="sourceLineNo">2240</span> * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.</p><a name="line.2240"></a>
-<span class="sourceLineNo">2241</span> *<a name="line.2241"></a>
-<span class="sourceLineNo">2242</span> * <p>A negative startIndex will return {@link #INDEX_NOT_FOUND} ({@code -1}). A startIndex larger than the<a name="line.2242"></a>
-<span class="sourceLineNo">2243</span> * array length will search from the end of the array.</p><a name="line.2243"></a>
-<span class="sourceLineNo">2244</span> *<a name="line.2244"></a>
-<span class="sourceLineNo">2245</span> * @param array the array to traverse for looking for the object, may be {@code null}<a name="line.2245"></a>
-<span class="sourceLineNo">2246</span> * @param valueToFind the value to find<a name="line.2246"></a>
-<span class="sourceLineNo">2247</span> * @param startIndex the start index to travers backwards from<a name="line.2247"></a>
-<span class="sourceLineNo">2248</span> * @return the last index of the value within the array,<a name="line.2248"></a>
-<span class="sourceLineNo">2249</span> * {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null} array input<a name="line.2249"></a>
-<span class="sourceLineNo">2250</span> */<a name="line.2250"></a>
-<span class="sourceLineNo">2251</span> public static int lastIndexOf(final short[] array, final short valueToFind, int startIndex) {<a name="line.2251"></a>
-<span class="sourceLineNo">2252</span> if (array == null) {<a name="line.2252"></a>
-<span class="sourceLineNo">2253</span> return INDEX_NOT_FOUND;<a name="line.2253"></a>
-<span class="sourceLineNo">2254</span> }<a name="line.2254"></a>
-<span class="sourceLineNo">2255</span> if (startIndex < 0) {<a name="line.2255"></a>
-<span class="sourceLineNo">2256</span> return INDEX_NOT_FOUND;<a name="line.2256"></a>
-<span class="sourceLineNo">2257</span> } else if (startIndex >= array.length) {<a name="line.2257"></a>
-<span class="sourceLineNo">2258</span> startIndex = array.length - 1;<a name="line.2258"></a>
-<span class="sourceLineNo">2259</span> }<a name="line.2259"></a>
-<span class="sourceLineNo">2260</span> for (int i = startIndex; i >= 0; i--) {<a name="line.2260"></a>
-<span class="sourceLineNo">2261</span> if (valueToFind == array[i]) {<a name="line.2261"></a>
-<span class="sourceLineNo">2262</span> return i;<a name="line.2262"></a>
-<span class="sourceLineNo">2263</span> }<a name="line.2263"></a>
-<span class="sourceLineNo">2264</span> }<a name="line.2264"></a>
-<span class="sourceLineNo">2265</span> return INDEX_NOT_FOUND;<a name="line.2265"></a>
-<span class="sourceLineNo">2266</span> }<a name="line.2266"></a>
-<span class="sourceLineNo">2267</span><a name="line.2267"></a>
-<span class="sourceLineNo">2268</span> /**<a name="line.2268"></a>
-<span class="sourceLineNo">2269</span> * <p>Checks if the value is in the given array.</p><a name="line.2269"></a>
-<span class="sourceLineNo">2270</span> *<a name="line.2270"></a>
-<span class="sourceLineNo">2271</span> * <p>The method returns {@code false} if a {@code null} array is passed in.</p><a name="line.2271"></a>
-<span class="sourceLineNo">2272</span> *<a name="line.2272"></a>
-<span class="sourceLineNo">2273</span> * @param array the array to search through<a name="line.2273"></a>
-<span class="sourceLineNo">2274</span> * @param valueToFind the value to find<a name="line.2274"></a>
-<span class="sourceLineNo">2275</span> * @return {@code true} if the array contains the object<a name="line.2275"></a>
-<span class="sourceLineNo">2276</span> */<a name="line.2276"></a>
-<span class="sourceLineNo">2277</span> public static boolean contains(final short[] array, final short valueToFind) {<a name="line.2277"></a>
-<span class="sourceLineNo">2278</span> return indexOf(array, valueToFind) != INDEX_NOT_FOUND;<a name="line.2278"></a>
-<span class="sourceLineNo">2279</span> }<a name="line.2279"></a>
-<span class="sourceLineNo">2280</span><a name="line.2280"></a>
-<span class="sourceLineNo">2281</span> // char IndexOf<a name="line.2281"></a>
-<span class="sourceLineNo">2282</span> //-----------------------------------------------------------------------<a name="line.2282"></a>
-<span class="sourceLineNo">2283</span> /**<a name="line.2283"></a>
-<span class="sourceLineNo">2284</span> * <p>Finds the index of the given value in the array.</p><a name="line.2284"></a>
-<span class="sourceLineNo">2285</span> *<a name="line.2285"></a>
-<span class="sourceLineNo">2286</span> * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.</p><a name="line.2286"></a>
-<span class="sourceLineNo">2287</span> *<a name="line.2287"></a>
-<span class="sourceLineNo">2288</span> * @param array the array to search through for the object, may be {@code null}<a name="line.2288"></a>
-<span class="sourceLineNo">2289</span> * @param valueToFind the value to find<a name="line.2289"></a>
-<span class="sourceLineNo">2290</span> * @return the index of the value within the array,<a name="line.2290"></a>
-<span class="sourceLineNo">2291</span> * {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null} array input<a name="line.2291"></a>
-<span class="sourceLineNo">2292</span> * @since 2.1<a name="line.2292"></a>
-<span class="sourceLineNo">2293</span> */<a name="line.2293"></a>
-<span class="sourceLineNo">2294</span> public static int indexOf(final char[] array, final char valueToFind) {<a name="line.2294"></a>
-<span class="sourceLineNo">2295</span> return indexOf(array, valueToFind, 0);<a name="line.2295"></a>
-<span class="sourceLineNo">2296</span> }<a name="line.2296"></a>
-<span class="sourceLineNo">2297</span><a name="line.2297"></a>
-<span class="sourceLineNo">2298</span> /**<a name="line.2298"></a>
-<span class="sourceLineNo">2299</span> * <p>Finds the index of the given value in the array starting at the given index.</p><a name="line.2299"></a>
-<span class="sourceLineNo">2300</span> *<a name="line.2300"></a>
-<span class="sourceLineNo">2301</span> * <p>This method returns {@link #INDEX_NOT_FOUND} ({@code -1}) for a {@code null} input array.</p><a name="line.2301"></a>
-<span class="sourceLineNo">2302</span> *<a name="line.2302"></a>
-<span class="sourceLineNo">2303</span> * <p>A negative startIndex is treated as zero. A startIndex larger than the array<a name="line.2303"></a>
-<span class="sourceLineNo">2304</span> * length will return {@link #INDEX_NOT_FOUND} ({@code -1}).</p><a name="line.2304"></a>
-<span class="sourceLineNo">2305</span> *<a name="line.2305"></a>
-<span class="sourceLineNo">2306</span> * @param array the array to search through for the object, may be {@code null}<a name="line.2306"></a>
-<span class="sourceLineNo">2307</span> * @param valueToFind the value to find<a name="line.2307"></a>
-<span class="sourceLineNo">2308</span> * @param startIndex the index to start searching at<a name="line.2308"></a>
-<span class="sourceLineNo">2309</span> * @return the index of the value within the array,<a name="line.2309"></a>
-<span class="sourceLineNo">2310</span> * {@link #INDEX_NOT_FOUND} ({@code -1}) if not found or {@code null} array input<a name="line.2310"></a>
-<span class="sourceLineNo">2311</span> * @since 2.1<a name="line.2311"></a>
-<span class="sourceLineNo">2312</span> */<a name="line.2312"></a>
[... 9748 lines stripped ...]