[#14] Add skip methods; Still need to be tested

Author: Jin Kwon

docker.maven.sh

@@ -0,0 +1,24 @@
+#!/bin/sh
+if [ $# -lt 3 ]; then
+  echo "Usage: $0 <tag> <phases...>, e.g. $0 3-jdk-11-openj9 clean install"
+  echo "See https://hub.docker.com/_/maven for available tags"
+  exit 1
+fi
+groupId=$(mvn help:evaluate -Dexpression=project.groupId | grep -v '\[')
+artifactId=$(mvn help:evaluate -Dexpression=project.artifactId | grep -v '\[')
+version=$(mvn help:evaluate -Dexpression=project.version | grep -v '\[')
+echo $groupId:$artifactId:$version
+tag="$1"
+shift
+echo run -it --rm \
+  --name $artifactId \
+  -v "$HOME/.m2":/root/.m2 \
+  -v "$(pwd)":/usr/src/"$groupId"/"$artifactId"/"$version" \
+  -w /usr/src/"$groupId"/"$artifactId"/"$version" \
+  maven:"$tag" mvn "$@"
+docker run -it --rm \
+  --name $artifactId \
+  -v "$HOME/.m2":/root/.m2 \
+  -v "$(pwd)":/usr/src/"$groupId"/"$artifactId"/"$version" \
+  -w /usr/src/"$groupId"/"$artifactId"/"$version" \
+  maven:"$tag" mvn "$@"

src/main/java/com/github/jinahya/bit/io/AbstractBitInput.java

@@ -249,18 +249,34 @@ public char readChar16() throws IOException {
     }
 
     // -----------------------------------------------------------------------------------------------------------------
+    @Override
+    public void skip(final int bits) throws IOException {
+        if (bits <= 0) {
+            throw new IllegalArgumentException("bits(" + bits + ") <= 0");
+        }
+        final int q = bits / Byte.SIZE;
+        for (int i = 0; i < q; i++) {
+            readInt(true, Byte.SIZE);
+        }
+        final int r = bits % Byte.SIZE;
+        for (int i = 0; i < r; i++) {
+            readBoolean();
+        }
+    }
+
     @Override
     public long align(final int bytes) throws IOException {
         if (bytes <= 0) {
             throw new IllegalArgumentException("bytes(" + bytes + ") <= 0");
         }
-        long bits = 0; // number of bits discarded
+        // TODO: 2020/02/14 Use skip()!!!
+        long bits = 0; // number of bits to discard
         if (available > 0) {
             bits += available;
             readInt(true, available);
         }
         assert available == 0;
-        for (; count % bytes > 0L; bits += Byte.SIZE) {
+        for (; (count % bytes) > 0L; bits += Byte.SIZE) {
             readInt(true, Byte.SIZE);
         }
         assert count % bytes == 0L;

src/main/java/com/github/jinahya/bit/io/AbstractBitOutput.java

@@ -239,12 +239,28 @@ public void writeChar16(final char value) throws IOException {
     }
 
     // -----------------------------------------------------------------------------------------------------------------
+    @Override
+    public void skip(final int bits) throws IOException {
+        if (bits <= 0) {
+            throw new IllegalArgumentException("bits(" + bits + ") <= 0");
+        }
+        final int q = bits / Byte.SIZE;
+        for (int i = 0; i < q; i++) {
+            writeInt(true, Byte.SIZE, 0);
+        }
+        final int r = bits % Byte.SIZE;
+        for (int i = 0; i < r; i++) {
+            writeBoolean(false);
+        }
+    }
+
     @Override
     public long align(final int bytes) throws IOException {
         if (bytes <= 0) {
             throw new IllegalArgumentException("bytes(" + bytes + ") <= 0");
         }
-        long bits = 0; // the number of bits padded
+        // TODO: 2020/02/14 Use skip()!!!
+        long bits = 0; // the number of bits to pad
         if (available < Byte.SIZE) {
             bits += available;
             writeInt(true, available, 0x00);

src/main/java/com/github/jinahya/bit/io/BitInput.java

@@ -184,6 +184,14 @@ public interface BitInput {
 
     // -----------------------------------------------------------------------------------------------------------------
 
+    /**
+     * Skips specified number of bits by discarding bits.
+     *
+     * @param bits the number of bit to skip; must be positive.
+     * @throws IOException if an I/O error occurs.
+     */
+    void skip(int bits) throws IOException;
+
     /**
      * Aligns to specified number of bytes by discarding bits.
      *

src/main/java/com/github/jinahya/bit/io/BitOutput.java

@@ -186,6 +186,14 @@ public interface BitOutput {
 
     // -----------------------------------------------------------------------------------------------------------------
 
+    /**
+     * Skips specified number of bits by padding zero bits.
+     *
+     * @param bits the number of bit to skip; must be positive.
+     * @throws IOException if an I/O error occurs.
+     */
+    void skip(int bits) throws IOException;
+
     /**
      * Aligns to specified number of bytes by padding zero bits.
      *