Add appending with strings

Author: patrickfav

CHANGELOG

@@ -1,5 +1,9 @@
 # Releases
 
+## v0.4.6
+
+* add appending with strings
+
 ## v0.4.5
 
 * add nullSafe wrapper

README.md

@@ -185,6 +185,7 @@ For **appending** byte arrays or primitive integer types to current instances.
 Bytes result = Bytes.wrap(array1).append(array2);
 Bytes result = Bytes.wrap(array1).append(1341);
 Bytes result = Bytes.wrap(array1).append((byte) 3);
+Bytes result = Bytes.wrap(array1).append("some string");
 ```
 
 **Bitwise operations**: XOR, OR, AND, NOT as well as left and right shifts and switching bits:

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>at.favre.lib</groupId>
     <artifactId>bytes</artifactId>
-    <version>0.4.5</version>
+    <version>0.4.6</version>
     <packaging>jar</packaging>
 
     <name>Bytes Utility Library</name>

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

@@ -593,6 +593,17 @@ public Bytes append(byte[] secondArray) {
         return transform(new BytesTransformer.ConcatTransformer(secondArray));
     }
 
+    /**
+     * Creates a new instance with the current array appended to the provided utf-8 encoded representation of this string
+     *
+     * @param string string used to get utf-8 bytes from
+     * @return appended instance
+     */
+    public Bytes append(CharSequence string) {
+        Objects.requireNonNull(string);
+        return transform(new BytesTransformer.ConcatTransformer(string.toString().getBytes(StandardCharsets.UTF_8)));
+    }
+
     /**
      * Bitwise XOR operation on the whole internal byte array.
      * See the considerations about possible in-place operation in {@link #transform(BytesTransformer)}.

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

@@ -55,6 +55,14 @@ public void appendPrimitives() throws Exception {
         assertArrayEquals(Util.concat(example_bytes_eight, ByteBuffer.allocate(8).putLong(0x6762173671L).array()), Bytes.from(example_bytes_eight).append(0x6762173671L).array());
     }
 
+    @Test
+    public void appendString() throws Exception {
+        assertArrayEquals(new byte[]{0, 0, 48}, Bytes.from(new byte[2]).append("0").array());
+        assertArrayEquals(new byte[]{48}, Bytes.from(new byte[0]).append("0").array());
+        assertArrayEquals(new byte[]{71, 117, 116}, Bytes.from(new byte[0]).append("Gut").array());
+        assertArrayEquals(new byte[]{71, -30, -99, -92}, Bytes.from(new byte[0]).append("G❤").array());
+    }
+
     @Test
     public void appendMulti() throws Exception {
         Bytes b = Bytes.random(2);