blob: 992ee102fbf1613b21245364da09d74858eb2640 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- NewPage -->
<html lang="en">
<head>
<!-- Generated by javadoc -->
<title>ArrayUtil</title>
<link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style">
<script type="text/javascript" src="../../../../script.js"></script>
</head>
<body>
<script type="text/javascript"><!--
try {
if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="ArrayUtil";
}
}
catch(err) {
}
//-->
var methods = {"i0":9,"i1":9,"i2":9,"i3":9,"i4":9,"i5":9,"i6":9,"i7":9,"i8":9,"i9":9,"i10":9,"i11":9};
var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],8:["t4","Concrete Methods"]};
var altColor = "altColor";
var rowColor = "rowColor";
var tableTab = "tableTab";
var activeTableTab = "activeTableTab";
</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
<!-- ========= START OF TOP NAVBAR ======= -->
<div class="topNav"><a name="navbar.top">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
<a name="navbar.top.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../../overview-summary.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../../index-all.html">Index</a></li>
<li><a href="../../../../help-doc.html">Help</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList">
<li>Prev&nbsp;Class</li>
<li><a href="../../../../org/apache/iceberg/util/BinaryUtil.html" title="class in org.apache.iceberg.util"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../../index.html?org/apache/iceberg/util/ArrayUtil.html" target="_top">Frames</a></li>
<li><a href="ArrayUtil.html" target="_top">No&nbsp;Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_top">
<li><a href="../../../../allclasses-noframe.html">All&nbsp;Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_top");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li><a href="#field.summary">Field</a>&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li><a href="#field.detail">Field</a>&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method.detail">Method</a></li>
</ul>
</div>
<a name="skip.navbar.top">
<!-- -->
</a></div>
<!-- ========= END OF TOP NAVBAR ========= -->
<!-- ======== START OF CLASS DATA ======== -->
<div class="header">
<div class="subTitle">org.apache.iceberg.util</div>
<h2 title="Class ArrayUtil" class="title">Class ArrayUtil</h2>
</div>
<div class="contentContainer">
<ul class="inheritance">
<li>java.lang.Object</li>
<li>
<ul class="inheritance">
<li>org.apache.iceberg.util.ArrayUtil</li>
</ul>
</li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr>
<br>
<pre>public class <span class="typeNameLabel">ArrayUtil</span>
extends java.lang.Object</pre>
</li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== FIELD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.summary">
<!-- -->
</a>
<h3>Field Summary</h3>
<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Field Summary table, listing fields, and an explanation">
<caption><span>Fields</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Field and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static boolean[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/iceberg/util/ArrayUtil.html#EMPTY_BOOLEAN_ARRAY">EMPTY_BOOLEAN_ARRAY</a></span></code>&nbsp;</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static byte[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/iceberg/util/ArrayUtil.html#EMPTY_BYTE_ARRAY">EMPTY_BYTE_ARRAY</a></span></code>&nbsp;</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static double[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/iceberg/util/ArrayUtil.html#EMPTY_DOUBLE_ARRAY">EMPTY_DOUBLE_ARRAY</a></span></code>&nbsp;</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static float[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/iceberg/util/ArrayUtil.html#EMPTY_FLOAT_ARRAY">EMPTY_FLOAT_ARRAY</a></span></code>&nbsp;</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static int[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/iceberg/util/ArrayUtil.html#EMPTY_INT_ARRAY">EMPTY_INT_ARRAY</a></span></code>&nbsp;</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static long[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/iceberg/util/ArrayUtil.html#EMPTY_LONG_ARRAY">EMPTY_LONG_ARRAY</a></span></code>&nbsp;</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static short[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/iceberg/util/ArrayUtil.html#EMPTY_SHORT_ARRAY">EMPTY_SHORT_ARRAY</a></span></code>&nbsp;</td>
</tr>
</table>
</li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- -->
</a>
<h3>Method Summary</h3>
<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
<caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd">&nbsp;</span></span><span id="t1" class="tableTab"><span><a href="javascript:show(1);">Static Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd">&nbsp;</span></span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr id="i0" class="altColor">
<td class="colFirst"><code>static &lt;T&gt;&nbsp;T[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/iceberg/util/ArrayUtil.html#add-T:A-T-">add</a></span>(T[]&nbsp;array,
T&nbsp;element)</code>
<div class="block">Copies the given array and adds the given element at the end of the new array.</div>
</td>
</tr>
<tr id="i1" class="rowColor">
<td class="colFirst"><code>static int[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/iceberg/util/ArrayUtil.html#toIntArray-java.util.List-">toIntArray</a></span>(java.util.List&lt;java.lang.Integer&gt;&nbsp;ints)</code>&nbsp;</td>
</tr>
<tr id="i2" class="altColor">
<td class="colFirst"><code>static java.util.List&lt;java.lang.Integer&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/iceberg/util/ArrayUtil.html#toIntList-int:A-">toIntList</a></span>(int[]&nbsp;ints)</code>&nbsp;</td>
</tr>
<tr id="i3" class="rowColor">
<td class="colFirst"><code>static long[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/iceberg/util/ArrayUtil.html#toLongArray-java.util.List-">toLongArray</a></span>(java.util.List&lt;java.lang.Long&gt;&nbsp;longs)</code>&nbsp;</td>
</tr>
<tr id="i4" class="altColor">
<td class="colFirst"><code>static java.util.List&lt;java.lang.Long&gt;</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/iceberg/util/ArrayUtil.html#toLongList-long:A-">toLongList</a></span>(long[]&nbsp;longs)</code>&nbsp;</td>
</tr>
<tr id="i5" class="rowColor">
<td class="colFirst"><code>static boolean[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/iceberg/util/ArrayUtil.html#toPrimitive-java.lang.Boolean:A-">toPrimitive</a></span>(java.lang.Boolean[]&nbsp;array)</code>
<div class="block">Converts an array of object Booleans to primitives.</div>
</td>
</tr>
<tr id="i6" class="altColor">
<td class="colFirst"><code>static byte[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/iceberg/util/ArrayUtil.html#toPrimitive-java.lang.Byte:A-">toPrimitive</a></span>(java.lang.Byte[]&nbsp;array)</code>
<div class="block">Converts an array of object Bytes to primitives.</div>
</td>
</tr>
<tr id="i7" class="rowColor">
<td class="colFirst"><code>static double[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/iceberg/util/ArrayUtil.html#toPrimitive-java.lang.Double:A-">toPrimitive</a></span>(java.lang.Double[]&nbsp;array)</code>
<div class="block">Converts an array of object Doubles to primitives.</div>
</td>
</tr>
<tr id="i8" class="altColor">
<td class="colFirst"><code>static float[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/iceberg/util/ArrayUtil.html#toPrimitive-java.lang.Float:A-">toPrimitive</a></span>(java.lang.Float[]&nbsp;array)</code>
<div class="block">Converts an array of object Floats to primitives.</div>
</td>
</tr>
<tr id="i9" class="rowColor">
<td class="colFirst"><code>static int[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/iceberg/util/ArrayUtil.html#toPrimitive-java.lang.Integer:A-">toPrimitive</a></span>(java.lang.Integer[]&nbsp;array)</code>
<div class="block">Converts an array of object Integers to primitives.</div>
</td>
</tr>
<tr id="i10" class="altColor">
<td class="colFirst"><code>static long[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/iceberg/util/ArrayUtil.html#toPrimitive-java.lang.Long:A-">toPrimitive</a></span>(java.lang.Long[]&nbsp;array)</code>
<div class="block">Converts an array of object Longs to primitives.</div>
</td>
</tr>
<tr id="i11" class="rowColor">
<td class="colFirst"><code>static short[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../org/apache/iceberg/util/ArrayUtil.html#toPrimitive-java.lang.Short:A-">toPrimitive</a></span>(java.lang.Short[]&nbsp;array)</code>
<div class="block">Converts an array of object Shorts to primitives.</div>
</td>
</tr>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;java.lang.Object</h3>
<code>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</code></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ FIELD DETAIL =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.detail">
<!-- -->
</a>
<h3>Field Detail</h3>
<a name="EMPTY_BOOLEAN_ARRAY">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>EMPTY_BOOLEAN_ARRAY</h4>
<pre>public static final&nbsp;boolean[] EMPTY_BOOLEAN_ARRAY</pre>
</li>
</ul>
<a name="EMPTY_BYTE_ARRAY">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>EMPTY_BYTE_ARRAY</h4>
<pre>public static final&nbsp;byte[] EMPTY_BYTE_ARRAY</pre>
</li>
</ul>
<a name="EMPTY_SHORT_ARRAY">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>EMPTY_SHORT_ARRAY</h4>
<pre>public static final&nbsp;short[] EMPTY_SHORT_ARRAY</pre>
</li>
</ul>
<a name="EMPTY_INT_ARRAY">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>EMPTY_INT_ARRAY</h4>
<pre>public static final&nbsp;int[] EMPTY_INT_ARRAY</pre>
</li>
</ul>
<a name="EMPTY_LONG_ARRAY">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>EMPTY_LONG_ARRAY</h4>
<pre>public static final&nbsp;long[] EMPTY_LONG_ARRAY</pre>
</li>
</ul>
<a name="EMPTY_FLOAT_ARRAY">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>EMPTY_FLOAT_ARRAY</h4>
<pre>public static final&nbsp;float[] EMPTY_FLOAT_ARRAY</pre>
</li>
</ul>
<a name="EMPTY_DOUBLE_ARRAY">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>EMPTY_DOUBLE_ARRAY</h4>
<pre>public static final&nbsp;double[] EMPTY_DOUBLE_ARRAY</pre>
</li>
</ul>
</li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- -->
</a>
<h3>Method Detail</h3>
<a name="toIntList-int:A-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>toIntList</h4>
<pre>public static&nbsp;java.util.List&lt;java.lang.Integer&gt;&nbsp;toIntList(int[]&nbsp;ints)</pre>
</li>
</ul>
<a name="toIntArray-java.util.List-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>toIntArray</h4>
<pre>public static&nbsp;int[]&nbsp;toIntArray(java.util.List&lt;java.lang.Integer&gt;&nbsp;ints)</pre>
</li>
</ul>
<a name="toLongList-long:A-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>toLongList</h4>
<pre>public static&nbsp;java.util.List&lt;java.lang.Long&gt;&nbsp;toLongList(long[]&nbsp;longs)</pre>
</li>
</ul>
<a name="toLongArray-java.util.List-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>toLongArray</h4>
<pre>public static&nbsp;long[]&nbsp;toLongArray(java.util.List&lt;java.lang.Long&gt;&nbsp;longs)</pre>
</li>
</ul>
<a name="toPrimitive-java.lang.Boolean:A-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>toPrimitive</h4>
<pre>public static&nbsp;boolean[]&nbsp;toPrimitive(java.lang.Boolean[]&nbsp;array)</pre>
<div class="block">Converts an array of object Booleans to primitives.
<p>This method returns <code>null</code> for a <code>null</code> input array.
<p>This code is borrowed from `org.apache.commons:commons-lang3`.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>array</code> - a <code>Boolean</code> array, may be <code>null</code></dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>a <code>boolean</code> array, <code>null</code> if null array input</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code>java.lang.NullPointerException</code> - if array content is <code>null</code></dd>
</dl>
</li>
</ul>
<a name="toPrimitive-java.lang.Byte:A-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>toPrimitive</h4>
<pre>public static&nbsp;byte[]&nbsp;toPrimitive(java.lang.Byte[]&nbsp;array)</pre>
<div class="block">Converts an array of object Bytes to primitives.
<p>This method returns <code>null</code> for a <code>null</code> input array.
<p>This code is borrowed from `org.apache.commons:commons-lang3`.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>array</code> - a <code>Byte</code> array, may be <code>null</code></dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>a <code>byte</code> array, <code>null</code> if null array input</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code>java.lang.NullPointerException</code> - if array content is <code>null</code></dd>
</dl>
</li>
</ul>
<a name="toPrimitive-java.lang.Short:A-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>toPrimitive</h4>
<pre>public static&nbsp;short[]&nbsp;toPrimitive(java.lang.Short[]&nbsp;array)</pre>
<div class="block">Converts an array of object Shorts to primitives.
<p>This method returns <code>null</code> for a <code>null</code> input array.
<p>This code is borrowed from `org.apache.commons:commons-lang3`.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>array</code> - a <code>Short</code> array, may be <code>null</code></dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>a <code>byte</code> array, <code>null</code> if null array input</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code>java.lang.NullPointerException</code> - if array content is <code>null</code></dd>
</dl>
</li>
</ul>
<a name="toPrimitive-java.lang.Integer:A-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>toPrimitive</h4>
<pre>public static&nbsp;int[]&nbsp;toPrimitive(java.lang.Integer[]&nbsp;array)</pre>
<div class="block">Converts an array of object Integers to primitives.
<p>This method returns <code>null</code> for a <code>null</code> input array.
<p>This code is borrowed from `org.apache.commons:commons-lang3`.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>array</code> - a <code>Integer</code> array, may be <code>null</code></dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>an <code>int</code> array, <code>null</code> if null array input</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code>java.lang.NullPointerException</code> - if array content is <code>null</code></dd>
</dl>
</li>
</ul>
<a name="toPrimitive-java.lang.Long:A-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>toPrimitive</h4>
<pre>public static&nbsp;long[]&nbsp;toPrimitive(java.lang.Long[]&nbsp;array)</pre>
<div class="block">Converts an array of object Longs to primitives.
<p>This method returns <code>null</code> for a <code>null</code> input array.
<p>This code is borrowed from `org.apache.commons:commons-lang3`.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>array</code> - a <code>Long</code> array, may be <code>null</code></dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>a <code>long</code> array, <code>null</code> if null array input</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code>java.lang.NullPointerException</code> - if array content is <code>null</code></dd>
</dl>
</li>
</ul>
<a name="toPrimitive-java.lang.Float:A-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>toPrimitive</h4>
<pre>public static&nbsp;float[]&nbsp;toPrimitive(java.lang.Float[]&nbsp;array)</pre>
<div class="block">Converts an array of object Floats to primitives.
<p>This method returns <code>null</code> for a <code>null</code> input array.
<p>This code is borrowed from `org.apache.commons:commons-lang3`.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>array</code> - a <code>Float</code> array, may be <code>null</code></dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>a <code>float</code> array, <code>null</code> if null array input</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code>java.lang.NullPointerException</code> - if array content is <code>null</code></dd>
</dl>
</li>
</ul>
<a name="toPrimitive-java.lang.Double:A-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>toPrimitive</h4>
<pre>public static&nbsp;double[]&nbsp;toPrimitive(java.lang.Double[]&nbsp;array)</pre>
<div class="block">Converts an array of object Doubles to primitives.
<p>This method returns <code>null</code> for a <code>null</code> input array.
<p>This code is borrowed from `org.apache.commons:commons-lang3`.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>array</code> - a <code>Double</code> array, may be <code>null</code></dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>a <code>double</code> array, <code>null</code> if null array input</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code>java.lang.NullPointerException</code> - if array content is <code>null</code></dd>
</dl>
</li>
</ul>
<a name="add-java.lang.Object:A-java.lang.Object-">
<!-- -->
</a><a name="add-T:A-T-">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>add</h4>
<pre>public static&nbsp;&lt;T&gt;&nbsp;T[]&nbsp;add(T[]&nbsp;array,
T&nbsp;element)</pre>
<div class="block">Copies the given array and adds the given element at the end of the new array.
<p>The new array contains the same elements of the input array plus the given element in the
last position. The component type of the new array is the same as that of the input array.
<p>If the input array is <code>null</code>, a new one element array is returned whose component type
is the same as the element, unless the element itself is null, in which case the return type is
Object[]
<pre>
ArrayUtils.add(null, null) = IllegalArgumentException
ArrayUtils.add(null, "a") = ["a"]
ArrayUtils.add(["a"], null) = ["a", null]
ArrayUtils.add(["a"], "b") = ["a", "b"]
ArrayUtils.add(["a", "b"], "c") = ["a", "b", "c"]
</pre>
This code is borrowed from `org.apache.commons:commons-lang3`.</div>
<dl>
<dt><span class="paramLabel">Type Parameters:</span></dt>
<dd><code>T</code> - the component type of the array</dd>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>array</code> - the array to "add" the element to, may be <code>null</code></dd>
<dd><code>element</code> - the object to add, may be <code>null</code></dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>A new array containing the existing elements plus the new element The returned array
type will be that of the input array (unless null), in which case it will have the same
type as the element. If both are null, an IllegalArgumentException is thrown</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code>java.lang.IllegalArgumentException</code> - if both arguments are null</dd>
<dt><span class="simpleTagLabel">Since:</span></dt>
<dd>2.1</dd>
</dl>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
</div>
<!-- ========= END OF CLASS DATA ========= -->
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<div class="bottomNav"><a name="navbar.bottom">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
<a name="navbar.bottom.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../../overview-summary.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../../index-all.html">Index</a></li>
<li><a href="../../../../help-doc.html">Help</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList">
<li>Prev&nbsp;Class</li>
<li><a href="../../../../org/apache/iceberg/util/BinaryUtil.html" title="class in org.apache.iceberg.util"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../../index.html?org/apache/iceberg/util/ArrayUtil.html" target="_top">Frames</a></li>
<li><a href="ArrayUtil.html" target="_top">No&nbsp;Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_bottom">
<li><a href="../../../../allclasses-noframe.html">All&nbsp;Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_bottom");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li><a href="#field.summary">Field</a>&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li><a href="#field.detail">Field</a>&nbsp;|&nbsp;</li>
<li>Constr&nbsp;|&nbsp;</li>
<li><a href="#method.detail">Method</a></li>
</ul>
</div>
<a name="skip.navbar.bottom">
<!-- -->
</a></div>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
</body>
</html>