ByteArray

ByteArray[{b1,b2,}]

constructs a ByteArray object containing the byte values bi.

ByteArray["string"]

constructs a ByteArray object by extracting byte values from a Base64-encoded string.

Details

  • ByteArray stores data in a memory-efficient way, with the total number of bytes used being close to the length of the array.
  • When displayed in InputForm, a ByteArray object displays as ByteArray["string"], where "string" encodes the bytes in Base64 encoding.
  • In ByteArray[{b1,b2,}], all the byte values bi should be integers between 0 and 255.
  • Normal[ByteArray[]] yields the list of byte values in the byte array.
  • Functions such as Length and Equal work with ByteArray objects.
  • Functions such as First, Last, Min, and Max yield integer byte values.
  • Part works on ByteArray objects, yielding an integer byte value when it returns a single element, and a ByteArray object when it returns multiple elements.

Examples

open allclose all

Basic Examples  (2)

Create a ByteArray from a list of byte values:

Convert back to a list of byte values:

Create a ByteArray from a Base64-encoded string:

Convert to a list of byte values:

ByteArray uses Base64 in InputForm:

Scope  (6)

Get the length of a ByteArray:

Extract parts of a ByteArray:

Extract a sequence of bytes:

Convert to an ordinary array:

Reverse a byte array:

Read in a "WXF" file as a ByteArray:

Read it in 30 bytes at a time:

Close the incrementally read file:

Export an image as a ByteArray:

Interpret a ByteArray as a PNG image:

Properties & Relations  (4)

ByteArray uses Base64 encoding of its data in InputForm:

This string can be generated using BaseEncode:

Convert a ByteArray to an ordinary, one-dimensional list using Normal:

Convert a ByteArray to a string using ByteArrayToString:

Convert back to a ByteArray using StringToByteArray:

BinarySerialize converts expressions to a sequence of bytes returned as a ByteArray:

It can be reversed using BinaryDeserialize:

Introduced in 2015
 (10.1)