Skip to main content

PIO_ABI_VERSION

Constant PIO_ABI_VERSION 

Source
pub const PIO_ABI_VERSION: u32 = 5;
Expand description

ABI version of this C interface. Bump on any breaking change to an existing pio_* signature or documented behavior, including removing a supported format token from the C API. New additive symbols do not require a bump. A consumer compares pio_abi_version against the value it was built against (the PIO_ABI_VERSION macro in powerio.h) and refuses a mismatched library before calling another function.

New data uses new symbols or versioned Arrow, .pio.json, or format specific JSON schemas. Existing signatures do not change without an ABI version increment.

5 is the current version. It bumped because every ABI visible JSON document changed shape: pio_schema_versions_json dropped four keys, pio_dist_capabilities_json renamed schema_version to powerio_version, and the Arrow metadata key became powerio.version. A binding built against 4 would pass a handshake it should fail and read null for keys it mirrors.