BitUtils

Utils for binary operation. Main contains two utils: BitBuffer and BinStringHelper.

License	The Apache Software License, Version 2.0
Categories	Net
GroupId	net.sunyijun
ArtifactId	bit-utils
Last Version	1.1.0
Release Date	May 15, 2015
Type	jar
Description	BitUtils Utils for binary operation. Main contains two utils: BitBuffer and BinStringHelper.
Project URL	https://github.com/xiaosunzhu/bit_utils
Source Code Management	https://github.com/xiaosunzhu/bit_utils.git

Download bit-utils

Filename	Size
bit-utils-1.1.0.pom
bit-utils-1.1.0.jar	14 KB
bit-utils-1.1.0-sources.jar	11 KB
bit-utils-1.1.0-javadoc.jar	53 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/net.sunyijun/bit-utils/ -->
<dependency>
    <groupId>net.sunyijun</groupId>
    <artifactId>bit-utils</artifactId>
    <version>1.1.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/net.sunyijun/bit-utils/
implementation 'net.sunyijun:bit-utils:1.1.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/net.sunyijun/bit-utils/
implementation ("net.sunyijun:bit-utils:1.1.0")

Apache Buildr

'net.sunyijun:bit-utils:jar:1.1.0'

Apache Ivy

<dependency org="net.sunyijun" name="bit-utils" rev="1.1.0">
  <artifact name="bit-utils" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='net.sunyijun', module='bit-utils', version='1.1.0')
)

Scala SBT

libraryDependencies += "net.sunyijun" % "bit-utils" % "1.1.0"

Leiningen

[net.sunyijun/bit-utils "1.1.0"]

Dependencies

test (2)

Group / Artifact	Type	Version
junit : junit	jar	4.10
org.easytesting : fest-assert-core	jar	2.0M10

Project Modules

There are no modules declared in this project.

bit_utils

Utils for binary operation. Main contains two utils: BitBuffer and BinStringHelper.

---

BitBuffer

A buffer wrapped java.nio.ByteBuffer, provide operate a buffer in bit unit. Functions like ByteBuffer.

• You can use wrap a byte array to create BitBuffer. Then you can get some bits from it. Simplified usage like below:

  byte[] data = { (byte)210, 50 }; // 11010010  00110010
  BitBuffer buffer = BitBuffer.wrapBytes(data);
  
  System.out.println(buffer.remainingBits()); // 16
  
  byte bit = buffer.getByte(2); // get 2 bits, return in a byte.
  // This bit is 3.
  
  System.out.println(buffer.remainingBits()); // 14
  
  bit = buffer.getByte(7,8); // This means get 8 bits from 7 position, return in a bytes.
  // This bit is 25(00011001).
  
  System.out.println(buffer.remainingBits()); // 14, not change.
  
  // or  byte[] bits = buffer.getBytes(12); // This means get 12 bits, return in 2 bytes.
  // This bits is {210, 3}
  

• You can use allocate fix capacity to create empty BitBuffer. Then you can put some bits in it. Simplified usage like below:

  byte data = (byte)9; // 1001
  BitBuffer buffer = BitBuffer.allocate(20);
  buffer.put(data, 4); // now buffer is 1001
  
  System.out.println(buffer.remainingBits()); // 16
  
  byte[] datas = new byte[]{ (byte)210, 89 }; // 11010010 01011001
  buffer.put(datas, 15); // This means put 15 bits into buffer, buffer is 10011101 00100101 100
  
  System.out.println(buffer.remainingBits()); // 1
  
  buffer.put(data, 2, 4); // This means put 4 bits into buffer, start position is 2
  // now buffer is 10100101 00100101 100
  
  System.out.println(buffer.remainingBits()); // 1, not change.
  
  buffer.flip();
  
  System.out.println(buffer.remainingBits()); // 19
  

More usage in doc and test.

---

PickBitsHelper

A simple tool to pick some bits from number.

Example: pickBitsPartOfByte(data, 2, 5); If data is 10010011(binary), will pick bits 01001(binary), return byte is 0x09.

---

BinStringHelper

A simple tool, provide some static function to change number(byte,byte[],int,short,long) to a binary string. Usually used to print for debug.

Example:

• byte 210 -> "11010010 "
• int -1 -> "11111111 11111111 11111111 11111111 "

Versions

Version
1.1.0 May 15, 2015