Add append() method supporting multiple byte arrays

fixes #26

Author: patrickfav

CHANGELOG

@@ -1,5 +1,9 @@
 # Releases
 
+## v1.0.0
+
+* add `append()` method supporting multiple byte arrays #26
+
 ## v0.8.0
 
 * add radix encoding/parsing and fix radix tests #6, #20

src/main/java/at/favre/lib/bytes/Bytes.java

@@ -21,29 +21,14 @@
 
 package at.favre.lib.bytes;
 
-import java.io.ByteArrayInputStream;
-import java.io.DataInput;
-import java.io.File;
-import java.io.InputStream;
-import java.io.Serializable;
+import java.io.*;
 import java.math.BigInteger;
-import java.nio.ByteBuffer;
-import java.nio.ByteOrder;
-import java.nio.CharBuffer;
-import java.nio.IntBuffer;
-import java.nio.ReadOnlyBufferException;
+import java.nio.*;
 import java.nio.charset.Charset;
 import java.nio.charset.StandardCharsets;
 import java.security.SecureRandom;
 import java.text.Normalizer;
-import java.util.Arrays;
-import java.util.BitSet;
-import java.util.Collection;
-import java.util.Iterator;
-import java.util.List;
-import java.util.Objects;
-import java.util.Random;
-import java.util.UUID;
+import java.util.*;
 
 /**
  * Bytes is wrapper class for an byte-array that allows a lot of convenience operations on it:
@@ -777,6 +762,18 @@ public Bytes append(long long8Bytes) {
         return append(Bytes.from(long8Bytes));
     }
 
+    /**
+     * Creates a new instance with the current array appended to the provided data (ie. append at the end).
+     * You may use this to append multiple byte arrays without the need for chaining the {@link #append(byte[])} call
+     * and therefore generating intermediate copies of the byte array, making this approach use less memory.
+     *
+     * @param arrays to append
+     * @return appended instance
+     */
+    public Bytes append(byte[]... arrays) {
+        return append(Bytes.from(arrays));
+    }
+
     /**
      * Creates a new instance with the current array appended to the provided data (ie. append at the end)
      *

src/test/java/at/favre/lib/bytes/BytesTransformTest.java

@@ -47,6 +47,16 @@ public void append() {
         assertArrayEquals(Util.concat(example_bytes_eight, example_bytes_sixteen), Bytes.from(example_bytes_eight).append(Bytes.from(example_bytes_sixteen)).array());
     }
 
+    @Test
+    public void appendMultipleByteArrays() {
+        assertArrayEquals(new byte[0], Bytes.from(new byte[0]).append(new byte[0], new byte[0]).array());
+        assertArrayEquals(new byte[]{0x0, 0x01, 0x02, 0x03}, Bytes.from(new byte[]{0x0}).append(new byte[]{0x1}, new byte[]{0x2}, new byte[]{0x3}).array());
+        assertArrayEquals(Util.concat(example_bytes_seven, example_bytes_one, example_bytes_sixteen), Bytes.from(example_bytes_seven).append(example_bytes_one, example_bytes_sixteen).array());
+        assertArrayEquals(Util.concat(example_bytes_sixteen, example_bytes_sixteen, example_bytes_sixteen), Bytes.from(example_bytes_sixteen).append(example_bytes_sixteen, example_bytes_sixteen).array());
+        assertArrayEquals(Util.concat(example_bytes_two, example_bytes_seven, example_bytes_twentyfour, example_bytes_eight), Bytes.from(example_bytes_two).append(example_bytes_seven, example_bytes_twentyfour, example_bytes_eight).array());
+        assertArrayEquals(Util.concat(example_bytes_two, example_bytes_seven, example_bytes_twentyfour, example_bytes_one, example_bytes_sixteen), Bytes.from(example_bytes_two).append(example_bytes_seven, example_bytes_twentyfour).append(example_bytes_one, example_bytes_sixteen).array());
+    }
+
     @Test
     public void appendNullSafe() {
         assertArrayEquals(new byte[0], Bytes.from(new byte[0]).appendNullSafe(new byte[0]).array());