clj-uuid.bitmop — danlentz/clj-uuid 0.2.5

Unsigned Long and ByteBuffer-based bitwise operation primitives for UUID manipulation.

Provides the same mask/ldb/dpb fundamentals as in the past, plus a 16-byte ByteBuffer abstraction for direct UUID byte manipulation.

The ByteBuffer approach has two key advantages:

1. Performance: ByteBuffer provides direct typed access at byte offsets via single native operations (getLong, getInt, etc.) rather than manual shift/mask loops.
2. Portability: The buffer abstraction maps naturally to JavaScript's DataView/ArrayBuffer, enabling a future cljc implementation.

assemble-bytes clj

(assemble-bytes v)

Assemble a sequence of 8 bytes (big-endian) into a long.

bit-count clj

(bit-count x)

Count the number of set bits in x.

buf->bytes clj

(buf->bytes buf)

Extract the contents of a 16-byte UUID buffer as a byte array.

buf->uuid clj

(buf->uuid buf)

Convert a 16-byte UUID buffer to a java.util.UUID.

buf-compare clj

(buf-compare a b)

Lexicographic unsigned comparison of two 16-byte UUID buffers. Returns negative if a < b, zero if equal, positive if a > b. Comparison is unsigned (treats bytes as 0-255) which matches UUID canonical string ordering.

buf-hex clj

(buf-hex buf)

Convert a 16-byte UUID buffer to a 32-character hex string.

buf-str clj

(buf-str buf)

Convert a 16-byte UUID buffer to the canonical 36-character UUID string: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Byte ranges correspond to UUID fields: bytes 0-3: time-low bytes 4-5: time-mid bytes 6-7: time-high-and-version bytes 8-9: clock-seq bytes 10-15: node

buffer clj

(buffer)

(buffer msb lsb)

Create a 16-byte big-endian ByteBuffer.

0-arity: zeroed buffer 2-arity: from msb and lsb longs The buffer uses absolute (position-independent) get/put operations.

buffer-from-bytes clj

(buffer-from-bytes arr)

Create a 16-byte ByteBuffer from a byte array (at least 16 bytes).

bytes->long clj

(bytes->long arr i)

Read 8 bytes from arr starting at offset i, returning a long.

dpb clj

(dpb bitmask num value)

Deposit Byte -- insert value into the bit field defined by bitmask within num.

dpb-buf clj

(dpb-buf buf word-offset bitmask value)

Deposit bit field: insert value into the bits defined by bitmask within the 64-bit word at word-offset in the buffer. Mutates and returns the buffer.

duplicate clj

(duplicate buf)

Create an independent copy of a UUID buffer.

expt2 clj

(expt2 pow)

Compute 2^pow using bit-set.

get-byte clj

(get-byte buf offset)

Read an unsigned byte (0-255) at byte offset from buffer.

get-int clj

(get-int buf offset)

Read an unsigned 32-bit value at byte offset from buffer.

get-long clj

(get-long buf offset)

Read a 64-bit long at byte offset from buffer.

get-lsb clj

(get-lsb buf)

Read the least significant 64 bits (bytes 8-15) of a UUID buffer.

get-msb clj

(get-msb buf)

Read the most significant 64 bits (bytes 0-7) of a UUID buffer.

get-short clj

(get-short buf offset)

Read an unsigned 16-bit value at byte offset from buffer.

hex clj

(hex thing)

Convert a long or byte sequence to a hex string. For a long, produces a 16-character zero-padded hex string.

hex->buf clj

(hex->buf s)

Parse a 32-character hex string into a 16-byte UUID buffer.

ldb clj

(ldb bitmask num)

Load Byte -- extract the bit field defined by bitmask from num.

ldb-buf clj

(ldb-buf buf word-offset bitmask)

Load bit field: extract bits defined by bitmask from the 64-bit word at word-offset in the buffer.

long->bytes clj

(long->bytes x)

(long->bytes x arr i)

Write x as 8 big-endian bytes. With one argument returns a new byte array. With three arguments writes into arr at offset i.

mask clj

(mask width offset)

Create a bitmask of width bits starting at bit offset.

mask-offset clj

(mask-offset m)

Return the bit offset (position of least significant set bit) of a mask.

mask-width clj

(mask-width m)

Return the number of set bits in a contiguous bitmask.

octet-hex clj

(octet-hex num)

Convert a single byte value to a two-character uppercase hex string.

pphex clj

(pphex x)

Pretty-print a long value in both hexadecimal and binary.

put-byte clj

(put-byte buf offset val)

Write a byte value at byte offset in buffer. Returns the buffer.

put-int clj

(put-int buf offset val)

Write a 32-bit value at byte offset in buffer. Returns the buffer.

put-long clj

(put-long buf offset val)

Write a 64-bit long at byte offset in buffer. Returns the buffer.

put-short clj

(put-short buf offset val)

Write a 16-bit value at byte offset in buffer. Returns the buffer.

sb16 clj

(sb16 num)

sb32 clj

(sb32 num)

sb64 clj

(sb64 num)

sb8 clj

(sb8 num)

set-lsb clj

(set-lsb buf val)

Set the least significant 64 bits (bytes 8-15) of a UUID buffer. Returns the buffer.

set-msb clj

(set-msb buf val)

Set the most significant 64 bits (bytes 0-7) of a UUID buffer. Returns the buffer.

ub16 clj

(ub16 num)

ub24 clj

(ub24 num)

ub32 clj

(ub32 num)

ub4 clj

(ub4 num)

ub48 clj

(ub48 num)

ub56 clj

(ub56 num)

ub8 clj

(ub8 num)

uuid->buf clj

(uuid->buf uuid)

Convert a java.util.UUID to a 16-byte ByteBuffer.