Issue 508
[zxing.git] / core / src / com / google / zxing / common / BitArray.java
index e5eead0..6c150bf 100644 (file)
@@ -19,17 +19,23 @@ package com.google.zxing.common;
 /**\r
  * <p>A simple, fast array of bits, represented compactly by an array of ints internally.</p>\r
  *\r
- * @author srowen@google.com (Sean Owen)\r
+ * @author Sean Owen\r
  */\r
 public final class BitArray {\r
 \r
-  private int[] bits;\r
-  private final int size;\r
+  // TODO: I have changed these members to be public so ProGuard can inline get() and set(). Ideally\r
+  // they'd be private and we'd use the -allowaccessmodification flag, but Dalvik rejects the\r
+  // resulting binary at runtime on Android. If we find a solution to this, these should be changed\r
+  // back to private.\r
+  public int[] bits;\r
+  public int size;\r
+\r
+  public BitArray() {\r
+    this.size = 0;\r
+    this.bits = new int[1];\r
+  }\r
 \r
   public BitArray(int size) {\r
-    if (size < 1) {\r
-      throw new IllegalArgumentException("size must be at least 1");\r
-    }\r
     this.size = size;\r
     this.bits = makeArray(size);\r
   }\r
@@ -38,6 +44,18 @@ public final class BitArray {
     return size;\r
   }\r
 \r
+  public int getSizeInBytes() {\r
+    return (size + 7) >> 3;\r
+  }\r
+\r
+  private void ensureCapacity(int size) {\r
+    if (size > bits.length << 5) {\r
+      int[] newBits = makeArray(size);\r
+      System.arraycopy(bits, 0, newBits, 0, bits.length);\r
+      this.bits = newBits;\r
+    }\r
+  }\r
+\r
   /**\r
    * @param i bit to get\r
    * @return true iff bit i is set\r
@@ -55,6 +73,15 @@ public final class BitArray {
     bits[i >> 5] |= 1 << (i & 0x1F);\r
   }\r
 \r
+  /**\r
+   * Flips bit i.\r
+   *\r
+   * @param i bit to set\r
+   */\r
+  public void flip(int i) {\r
+    bits[i >> 5] ^= 1 << (i & 0x1F);\r
+  }\r
+\r
   /**\r
    * Sets a block of 32 bits, starting at bit i.\r
    *\r
@@ -107,19 +134,79 @@ public final class BitArray {
           mask |= 1 << j;\r
         }\r
       }\r
-      if (value) {\r
-        if ((bits[i] & mask) != mask) {\r
-          return false;\r
-        }\r
-      } else {\r
-        if ((bits[i] & mask) != 0) {\r
-          return false;\r
-        }\r
+\r
+      // Return false if we're looking for 1s and the masked bits[i] isn't all 1s (that is,\r
+      // equals the mask, or we're looking for 0s and the masked portion is not all 0s\r
+      if ((bits[i] & mask) != (value ? mask : 0)) {\r
+        return false;\r
       }\r
     }\r
     return true;\r
   }\r
 \r
+  public void appendBit(boolean bit) {\r
+    ensureCapacity(size + 1);\r
+    if (bit) {\r
+      bits[size >> 5] |= (1 << (size & 0x1F));\r
+    }\r
+    size++;\r
+  }\r
+\r
+  /**\r
+   * Appends the least-significant bits, from value, in order from most-significant to\r
+   * least-significant. For example, appending 6 bits from 0x000001E will append the bits\r
+   * 0, 1, 1, 1, 1, 0 in that order.\r
+   */\r
+  public void appendBits(int value, int numBits) {\r
+    if (numBits < 0 || numBits > 32) {\r
+      throw new IllegalArgumentException("Num bits must be between 0 and 32");\r
+    }\r
+    ensureCapacity(size + numBits);\r
+    for (int numBitsLeft = numBits; numBitsLeft > 0; numBitsLeft--) {\r
+      appendBit(((value >> (numBitsLeft - 1)) & 0x01) == 1);\r
+    }\r
+  }\r
+\r
+  public void appendBitArray(BitArray other) {\r
+    int otherSize = other.getSize();\r
+    ensureCapacity(size + otherSize);\r
+    for (int i = 0; i < otherSize; i++) {\r
+      appendBit(other.get(i));\r
+    }\r
+  }\r
+\r
+  public void xor(BitArray other) {\r
+    if (bits.length != other.bits.length) {\r
+      throw new IllegalArgumentException("Sizes don't match");\r
+    }\r
+    for (int i = 0; i < bits.length; i++) {\r
+      // The last byte could be incomplete (i.e. not have 8 bits in\r
+      // it) but there is no problem since 0 XOR 0 == 0.\r
+      bits[i] ^= other.bits[i];\r
+    }\r
+  }\r
+\r
+  /**\r
+   *\r
+   * @param bitOffset first bit to start writing\r
+   * @param array array to write into. Bytes are written most-significant byte first. This is the opposite\r
+   *  of the internal representation, which is exposed by {@link #getBitArray()}\r
+   * @param offset position in array to start writing\r
+   * @param numBytes how many bytes to write\r
+   */\r
+  public void toBytes(int bitOffset, byte[] array, int offset, int numBytes) {\r
+    for (int i = 0; i < numBytes; i++) {\r
+      int theByte = 0;\r
+      for (int j = 0; j < 8; j++) {\r
+        if (get(bitOffset)) {\r
+          theByte |= 1 << (7 - j);\r
+        }\r
+        bitOffset++;\r
+      }\r
+      array[offset + i] = (byte) theByte;\r
+    }\r
+  }\r
+\r
   /**\r
    * @return underlying array of ints. The first element holds the first 32 bits, and the least\r
    *         significant bit is bit 0.\r
@@ -132,11 +219,7 @@ public final class BitArray {
    * Reverses all bits in the array.\r
    */\r
   public void reverse() {\r
-    int[] newBits = makeArray(size);\r
-    int max = newBits.length;\r
-    for (int i = 0; i < max; i++) {\r
-      newBits[i] = 0;\r
-    }\r
+    int[] newBits = new int[bits.length];\r
     int size = this.size;\r
     for (int i = 0; i < size; i++) {\r
       if (get(size - i - 1)) {\r
@@ -147,17 +230,13 @@ public final class BitArray {
   }\r
 \r
   private static int[] makeArray(int size) {\r
-    int arraySize = size >> 5;\r
-    if ((size & 0x1F) != 0) {\r
-      arraySize++;\r
-    }\r
-    return new int[arraySize];\r
+    return new int[(size + 31) >> 5];\r
   }\r
   \r
   public String toString() {\r
     StringBuffer result = new StringBuffer(size);\r
     for (int i = 0; i < size; i++) {\r
-      if (i % 8 == 0) {\r
+      if ((i & 0x07) == 0) {\r
         result.append(' ');\r
       }\r
       result.append(get(i) ? 'X' : '.');\r