5 releases (2 stable)

1.1.0 Oct 16, 2019
1.0.0 Mar 25, 2019
0.0.3 Apr 30, 2017
0.0.2 Feb 20, 2017
0.0.1 Feb 19, 2017

#198 in macOS and iOS APIs

Download history 25/week @ 2024-05-16 24/week @ 2024-05-23 18/week @ 2024-05-30 18/week @ 2024-06-06 15/week @ 2024-06-13 65/week @ 2024-06-20 309/week @ 2024-06-27 1499/week @ 2024-07-04 520/week @ 2024-07-11 628/week @ 2024-07-18 239/week @ 2024-07-25 345/week @ 2024-08-01 273/week @ 2024-08-08 544/week @ 2024-08-15 1066/week @ 2024-08-22 630/week @ 2024-08-29

2,541 downloads per month

MIT license

16KB
358 lines

Objective-C type encoding creation and parsing in Rust.

The Objective-C compiler encodes types as strings for usage in the runtime. This crate aims to provide a strongly-typed (rather than stringly-typed) way to create and describe these type encodings without memory allocation in Rust.

Implementing Encode

This crate declares an Encode trait that can be implemented for types that the Objective-C compiler can encode. Implementing this trait looks like:

unsafe impl Encode for CGPoint {
    const ENCODING: Encoding<'static> =
        Encoding::Struct("CGPoint", &[CGFloat::ENCODING, CGFLOAT::ENCODING]);
}

For an example of how this works with more complex types, like structs containing structs, see the core_graphics example.

Comparing with encoding strings

An Encoding can be compared with an encoding string from the Objective-C runtime:

assert!(&i32::ENCODING == "i");

Generating encoding strings

Every Encoding implements Display as its string representation. This can be generated conveniently through the to_string method:

assert_eq!(i32::ENCODING.to_string(), "i");

No runtime deps