pyarrow.binary — Apache Arrow v20.0.0 (original) (raw)

pyarrow.binary(int length=-1)#

Create variable-length or fixed size binary type.

Parameters:

lengthint, optional, default -1

If length == -1 then return a variable length binary type. If length is greater than or equal to 0 then return a fixed size binary type of width length.

Examples

Create an instance of a variable-length binary type:

import pyarrow as pa pa.binary() DataType(binary)

and use the variable-length binary type to create an array:

pa.array(['foo', 'bar', 'baz'], type=pa.binary()) <pyarrow.lib.BinaryArray object at ...> [ 666F6F, 626172, 62617A ]

Create an instance of a fixed-size binary type:

pa.binary(3) FixedSizeBinaryType(fixed_size_binary[3])

and use the fixed-length binary type to create an array:

pa.array(['foo', 'bar', 'baz'], type=pa.binary(3)) <pyarrow.lib.FixedSizeBinaryArray object at ...> [ 666F6F, 626172, 62617A ]