#[unsafe(no_mangle)]pub unsafe extern "C" fn hurray_descriptor_field_u64_array(
handle: *const HurrayDescriptor,
field: HurrayDescriptorField,
level: u32,
out_values: *mut u64,
out_len: *mut usize,
) -> HurrayStatusExpand description
Reads an unsigned array field of the descriptor.
Uses the capacity/length in-out pattern
hurray_descriptor_shape uses:
- Set
*out_lento the capacity ofout_valuesin elements, or0ifout_valuesis null. - On return
*out_lenalways holds the field’s true length. - A null
out_valuesor an insufficient capacity returnsHURRAY_ERR_BUFFER_TOO_SMALL, so the caller can allocate and retry.
§Errors
As hurray_descriptor_field_u64, plus HURRAY_ERR_BUFFER_TOO_SMALL per
the protocol above.
§Safety
handleandout_lenMUST be valid, non-null pointers.- If
out_valuesis non-null it MUST be writable forcapacity× 8 bytes, wherecapacityis the value at*out_lenon entry.