use bytes

Byte array operations and endianness conversion. Provides functions for reading and writing multi-byte integers in big-endian and little-endian byte order.

Functions

fn compare

Compare two byte buffers.

Signature: (a:ptr a_off:i64 b:ptr b_off:i64 count:i64 -- result:i64)

Example:

buf1 0 buf2 0 10 bytes::compare  // result

fn contains

Check if a byte value exists in a buffer.

Signature: (ptr i64 i64 i64 -- i64)

Example:

buf 0 10 0x41 bytes::contains  // found

fn copy

Copy bytes from one buffer to another.

Signature: (dst:ptr dst_off:i64 src:ptr src_off:i64 count:i64 -- )

Example:

dst 0 src 0 10 bytes::copy

fn count

Count occurrences of a byte value in a buffer.

Signature: (buf:ptr offset:i64 len:i64 value:i64 -- result:i64)

Example:

buf 0 10 0x41 bytes::count  // n

fn equals

Check if two byte buffers are equal.

Signature: (ptr i64 ptr i64 i64 -- i64)

Example:

buf1 0 buf2 0 10 bytes::equals  // result

fn fill

Fill a buffer with a byte value.

Signature: (value:i64 buf:ptr offset:i64 count:i64 -- )

Example:

0 buf 0 10 bytes::fill

fn find

Find the first occurrence of a byte value in a buffer.

Signature: (buf:ptr offset:i64 count:i64 value:i64 -- result:i64)

Example:

buf 0 10 0x41 bytes::find  // idx

fn read_u16_be

Read a 16-bit unsigned integer from memory in big-endian order.

Signature: (buf:ptr offset:i64 -- value:i64)

Example:

buf 0 bytes::read_u16_be  // val

fn read_u16_le

Read a 16-bit unsigned integer from memory in little-endian order.

Signature: (buf:ptr offset:i64 -- value:i64)

Example:

buf 0 bytes::read_u16_le  // val

fn read_u32_be

Read a 32-bit unsigned integer from memory in big-endian order.

Signature: (buf:ptr offset:i64 -- value:i64)

Example:

buf 0 bytes::read_u32_be  // val

fn read_u32_le

Read a 32-bit unsigned integer from memory in little-endian order.

Signature: (buf:ptr offset:i64 -- value:i64)

Example:

buf 0 bytes::read_u32_le  // val

fn read_u64_be

Read a 64-bit unsigned integer from memory in big-endian order.

Signature: (buf:ptr offset:i64 -- value:i64)

Example:

buf 0 bytes::read_u64_be  // val

fn read_u64_le

Read a 64-bit unsigned integer from memory in little-endian order.

Signature: (buf:ptr offset:i64 -- value:i64)

Example:

buf 0 bytes::read_u64_le  // val

fn reverse

Reverse the byte order in a buffer region.

Signature: (buf:ptr offset:i64 count:i64 -- )

Example:

buf 0 10 bytes::reverse

fn swap16

Swap byte order of a 16-bit value.

Signature: (value:i64 -- result:i64)

Example:

0x1234 bytes::swap16  // result  // 0x3412

fn swap32

Swap byte order of a 32-bit value.

Signature: (value:i64 -- result:i64)

Example:

0x12345678 bytes::swap32  // result  // 0x78563412

fn swap64

Swap byte order of a 64-bit value.

Signature: (value:i64 -- result:i64)

Example:

0x0102030405060708 bytes::swap64  // result  // 0x0807060504030201

fn write_u16_be

Write a 16-bit unsigned integer to memory in big-endian order.

Signature: (buf:ptr offset:i64 value:i64 -- )

Example:

buf 0 0x1234 bytes::write_u16_be

fn write_u16_le

Write a 16-bit unsigned integer to memory in little-endian order.

Signature: (buf:ptr offset:i64 value:i64 -- )

Example:

buf 0 0x1234 bytes::write_u16_le

fn write_u32_be

Write a 32-bit unsigned integer to memory in big-endian order.

Signature: (buf:ptr offset:i64 value:i64 -- )

Example:

buf 0 0x12345678 bytes::write_u32_be

fn write_u32_le

Write a 32-bit unsigned integer to memory in little-endian order.

Signature: (buf:ptr offset:i64 value:i64 -- )

Example:

buf 0 0x12345678 bytes::write_u32_le

fn write_u64_be

Write a 64-bit unsigned integer to memory in big-endian order.

Signature: (buf:ptr offset:i64 value:i64 -- )

Example:

buf 0 0x123456789ABCDEF0 bytes::write_u64_be

fn write_u64_le

Write a 64-bit unsigned integer to memory in little-endian order.

Signature: (buf:ptr offset:i64 value:i64 -- )

Example:

buf 0 0x123456789ABCDEF0 bytes::write_u64_le

fn xor

XOR two byte buffers, storing result in first buffer.

Signature: (dst:ptr dst_off:i64 src:ptr src_off:i64 count:i64 -- )

Example:

dst 0 src 0 10 bytes::xor