objc2-encode

Added

• Added Encoding::size, which computes the size of the encoded type for the current target.

Changed

• Equivalence comparisons now consider Encoding::Class, Encoding::Object and Encoding::Block as equivalent.

Fixed

• Fixed an issue with publishing using an older version of Cargo that didn't handle the lints.workspace = true Cargo setup properly.

Added

• Added Encoding::None, which represents encodings where the host compiler (i.e. clang) couldn't generate an encoding for a given type.

  This is useful when working with SIMD types.

Changed

• Build documentation on docs.rs on more Apple platforms.

Changed

• BREAKING: Changed the type of EncodingBox::Struct and EncodingBox::Union to no longer contain an Option.

Fixed

• Fixed encoding equivalence between empty structs and unions.
• Parse (and ignore) extended type information.

Fixed

• Bumped version number to ensure that this crate can be compiled together with code that depends on pre-releases of 2.0.0.

Added

• Improved documentation slightly.

Added

• Made the crate no_std compatible.
• Made the crate platform-agnostic.

Changed

• BREAKING: Moved the Encode, RefEncode, EncodeArguments, EncodeConvert, OptionEncode to objc2.
• BREAKING: Encoding::BitField now allows omitting the type using an Option.
• BREAKING: Changed length field in Encoding::Array from usize to u64 (to be platform-agnostic).

Fixed

• Fixed Encoding::BitField encoding parsing.

Added

• Added EncodingBox for dynamically parsing encodings and creating them on the heap.
• Added ParseError, a custom type that represents errors during encoding parsing.
• Added Encoding::equivalent_to_box for comparing Encoding and EncodingBox.
• Implemented Encode and RefEncode for NonNull<c_void>.
• Added OptionEncode to help with implementing Encode and RefEncode for Option.

Changed

• BREAKING: Verify that the name in Encoding::Struct and Encoding::Union is a valid C identifier.

Removed

• BREAKING: Encoding no longer implements Copy, though it is still Clone.
• BREAKING: Removed Encoding::equivalent_to_start_of_str, since it wasn't really useful.

Added

• Added EncodeConvert trait to help with correctly handling BOOL/bool.

Changed

• BREAKING: Remove the lifetime specifier from Encoding, since the non -'static version was essentially useless.

Fixed

• Fixed the encoding output and comparison of structs behind pointers.

Removed

• BREAKING: bool (and AtomicBool) no longer implements Encode, since that was difficult to use correctly. See the EncodeConvert trait, or use objc2::runtime::Bool instead.

Added

• Added Encoding::Atomic.
• Implement Encode and RefEncode for std::sync::atomic types.

Changed

• BREAKING: Renamed Encoding::C_U_LONG to Encoding::C_ULONG.

Added

• Added Encoding::C_LONG and Encoding::C_U_LONG to help with platform compatibility; use these instead of c_long::ENCODING and c_ulong::ENCODING.
• Implement Encode and RefEncode for MaybeUninit<T>, where T is properly bound.

Changed

• BREAKING: Sealed the EncodeArguments trait.
• BREAKING: Add type argument to Encoding::BitField.

Removed

• BREAKING: Removed PartialEq impl between str and Encoding since it was incorrect (it violated the trait requirements).
• BREAKING: Removed Encode and RefEncode implementations for Pin since it may not be sound.

Added

• Implement Hash for Encoding.

Changed

• Improved documentation.

Added

• Encoding::equivalent_to, Encoding::equivalent_to_str and Encoding::equivalent_to_start_of_str methods for more precise comparison semantics.
• Added Encode and RefEncode implementations for Option function pointers.

Changed

• Discourage comparing str with Encoding using PartialEq. This trait impl might get removed in a future version.

Added

• BREAKING: Add Encoding::LongDouble, Encoding::FloatComplex, Encoding::DoubleComplex and Encoding::LongDoubleComplex.
• Implement RefEncode for all number types that implement Encode (bool, i8, usize, f32, NonZeroU32, and so on).
• Implement RefEncode for *const c_void and *mut c_void (allowing void** in C).
• Implement Encode and RefEncode for Wrapping<T>, where T is properly bound.

Changed

• BREAKING: Make Encoding #[non_exhaustive]. This will help us in evolving the API while minimizing further breaking changes.
• Discourage using bool::ENCODING; use objc2::Bool::ENCODING instead.
• Discourage using ()::ENCODING for anything other than as a function return type.

Added

• Improved documentation.
• Add RefEncode trait, which represents types whose pointers has an encoding. This means you now only have to implement RefEncode, and not both &Encode and &mut Encode. Additionally, encodings of pointers to pointers (to pointers, and so on) are now supported.
• Implement Encode for NonZeroX and Option<NonZeroX> integer types.
• Implement RefEncode for arrays.
• Implement Encode and RefEncode for (where T is properly bound):
  • ManuallyDrop<T>
  • Pin<T>
  • NonNull<T>
  • Option<NonNull<T>>
• Add EncodeArguments trait, to represent an ordered group of functions arguments, where each argument has an Objective-C type-encoding. Previously in the objc crate.
• Implement Encode and RefEncode for some extern "C" fn pointers.

Removed

• BREAKING: Removed automatic *const T: Encode and *mut T: Encode impls when when &T: Encode and &mut T: Encode was implemented.

  Implement T: RefEncode instead!

Added

• Improved documentation.
• Support for targets with pointer-width 16
• Implement Encode for all array lengths using const-generics.
• Implement Encode for unsized pointer types as well.

Changed

• BREAKING: Forked the project, so it is now available under the name objc2-encode.
• BREAKING: Changed type in Encoding::BitField from u32 to u8.
• BREAKING: Changed type in Encoding::Array from u32 to usize.
• BREAKING: Loosen 'static bounds on references implementing Encode.

Added

• Implement Encode for arrays with up to 32 elements.

Changed

• Simplify internal encoding comparison.