Enum objc2_encode::Encoding

#[non_exhaustive]
pub enum Encoding {
    Char,
    Short,
    Int,
    Long,
    LongLong,
    UChar,
    UShort,
    UInt,
    ULong,
    ULongLong,
    Float,
    Double,
    LongDouble,
    FloatComplex,
    DoubleComplex,
    LongDoubleComplex,
    Bool,
    Void,
    String,
    Object,
    Block,
    Class,
    Sel,
    Unknown,
    BitField(u8, &'static Encoding),
    Pointer(&'static Encoding),
    Atomic(&'static Encoding),
    Array(usize, &'static Encoding),
    Struct(&'static str, &'static [Encoding]),
    Union(&'static str, &'static [Encoding]),
}

An Objective-C type-encoding.

Can be retrieved in Objective-C for a type T using the @encode(T) directive.

NSLog(@"Encoding of NSException: %s", @encode(NSException));

The Display implementation converts the Encoding into its string representation, that the the @encode directive would return. This can be used conveniently through the to_string method:

use objc2_encode::Encoding;
assert_eq!(Encoding::Int.to_string(), "i");

For more information on the string value of an encoding, see Apple’s documentation.

Examples

Comparing an encoding to a string from the Objective-C runtime:

use objc2_encode::Encoding;
assert!(Encoding::Array(10, &Encoding::FloatComplex).equivalent_to_str("[10jf]"));

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Char

A C char. Corresponds to the c code.

Short

A C short. Corresponds to the s code.

Int

A C int. Corresponds to the i code.

Long

A C long. Corresponds to the l code.

This is treated as a 32-bit quantity in 64-bit programs.

LongLong

A C long long. Corresponds to the q code.

UChar

A C unsigned char. Corresponds to the C code.

UShort

A C unsigned short. Corresponds to the S code.

UInt

A C unsigned int. Corresponds to the I code.

ULong

A C unsigned long. Corresponds to the L code.

ULongLong

A C unsigned long long. Corresponds to the Q code.

Float

A C float. Corresponds to the f code.

Double

A C double. Corresponds to the d code.

LongDouble

A C long double. Corresponds to the D code.

FloatComplex

A C float _Complex. Corresponds to the jf code.

DoubleComplex

A C _Complex or double _Complex. Corresponds to the jd code.

LongDoubleComplex

A C long double _Complex. Corresponds to the jD code.

Bool

A C++ bool / C99 _Bool. Corresponds to the B code.

Void

A C void. Corresponds to the v code.

String

A C char *. Corresponds to the * code.

Object

An Objective-C object (id). Corresponds to the @ code.

Block

An Objective-C block. Corresponds to the @? code.

Class

An Objective-C class (Class). Corresponds to the # code.

Sel

An Objective-C selector (SEL). Corresponds to the : code.

Unknown

An unknown type. Corresponds to the ? code.

This is usually used to encode functions.

BitField(u8, &'static Encoding)

A bitfield with the given number of bits, and the given type.

The type is not currently used, but may be in the future for better compatibility with Objective-C runtimes.

Corresponds to the b num code.

Pointer(&'static Encoding)

A pointer to the given type.

Corresponds to the ^ type code.

Atomic(&'static Encoding)

A C11 _Atomic type.

Corresponds to the A type code. Not all encodings are possible in this.

Array(usize, &'static Encoding)

An array with the given length and type.

Corresponds to the [len type] code.

Struct(&'static str, &'static [Encoding])

A struct with the given name and fields.

The order of the fields must match the order of the order in this.

It is not uncommon for the name to be "?".

Corresponds to the {name=fields...} code.

Union(&'static str, &'static [Encoding])

A union with the given name and fields.

The order of the fields must match the order of the order in this.

Corresponds to the (name=fields...) code.

Implementations

impl Encoding

pub const C_LONG: Self = _

The encoding of c_long.

Ideally the encoding of long would just be the same as int when it’s 32 bits wide and the same as long long when it is 64 bits wide; then c_long::ENCODING would just work.

Unfortunately, long have a different encoding than int when it is 32 bits wide; the l encoding.

pub const C_ULONG: Self = _

The encoding of c_ulong.

See Encoding::C_LONG for explanation.

pub fn equivalent_to(&self, other: &Self) -> bool

Check if one encoding is equivalent to another.

Currently, equivalence testing mostly requires that the encodings are equal, except for:

• Any leading qualifiers that the encoding may have.
• Structs or unions behind multiple pointers are considered equivalent, since Objective-C compilers strip this information to avoid unnecessary nesting.

The comparison may be changed in the future to e.g. ignore struct names or similar changes that may be required because of limitations in Objective-C compiler implementations.

For example, you should not rely on two equivalent encodings to have the same size or ABI - that is provided on a best-effort basis.

pub fn equivalent_to_str(&self, s: &str) -> bool

Check if an encoding is equivalent to the given string representation.

See Encoding::equivalent_to for details about the meaning of “equivalence”.

Examples found in repository

examples/opaque_type.rs (line 31)

fn main() {
    assert!(NSDecimal::ENCODING_REF.equivalent_to_str("^{?=cCCC[38C]}"));
    // Does not compile:
    // println!("{:?}", NSDecimal::ENCODING);
}

examples/ns_uinteger.rs (line 29)

fn main() {
    assert!(NSUInteger::ENCODING.equivalent_to_str("Q"));
    assert!(<&NSUInteger>::ENCODING.equivalent_to_str("^Q"));
    assert!(<&NSUInteger>::ENCODING.equivalent_to_str("r^Q"));
}

pub fn equivalent_to_box(&self, other: &EncodingBox) -> bool

Check if an encoding is equivalent to a boxed encoding.

See Encoding::equivalent_to for details about the meaning of “equivalence”.

Trait Implementations

impl Clone for Encoding

fn clone(&self) -> Encoding

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Encoding

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for Encoding

Formats this Encoding in a similar way that the @encode directive would ordinarily do.

You should not rely on the output of this to be stable across versions. It may change if found to be required to be compatible with exisiting Objective-C compilers.

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Hash for Encoding

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where
    H: Hasher,
    Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq<Encoding> for Encoding

fn eq(&self, other: &Encoding) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<Encoding> for EncodingBox

fn eq(&self, other: &Encoding) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<EncodingBox> for Encoding

fn eq(&self, other: &EncodingBox) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Encoding

impl StructuralEq for Encoding

impl StructuralPartialEq for Encoding