Skip to content

Update special types. #591

Open
Open

Description

@ehuss

I think there are some types missing from special-types-and-traits.md. In particular, I think Fn, FnMut, and FnOnce are special. What is the criteria for being special? Is there anything else missing from the list?

Things to consider adding:

  • cmp:
    • Eq
    • PartialEq
    • Ord
    • PartialOrd
  • ops:
    • Add
    • AddAssign
    • BitAnd
    • BitAndAssign
    • BitOr
    • BitOrAssign
    • BitXor
    • BitXorAssign
    • Div
    • DivAssign
    • Fn
    • FnMut
    • FnOnce
    • Index
    • IndexMut
    • Mul
    • MulAssign
    • Neg
    • Not
    • Rem
    • RemAssign
    • Shl
    • ShlAssign
    • Shr
    • ShrAssign
    • Sub
    • SubAssign
  • Misc:
    • Unpin — Automatically implemented on most types, but not otherwise "used" by the language?
    • Future
    • ManuallyDrop
    • IntoIterator
    • IntoFuture
  • Unstable but maybe exposed in some way?:
  • Unstable (not exposed?):
    • Generator, GeneratorState
    • Try
    • DispatchFromDyn ()
    • VaListImpl (va_list lang item)
    • Receiver (currently hard-coded in reference)
    • start
    • eh_personality
    • eh_catch_typeinfo
  • Panic stuff — From a language perspective, is there anything relevant here?
  • Relevance unknown:
    • Freeze
    • exchange_malloc
    • box_free
    • drop_in_place
    • oom
    • alloc_layout
    • MaybeUninit
    • align_offset — const eval?

Activity

  1. Havvy commented on Apr 22, 2019

    @Havvy
    Contributor

    And type or trait is special if it requires or is a dependency of compiler machinery. The types you think are missing are probably the operator traits and we should probably duplicate that list into the page.

  2. DanielEScherzer commented on Nov 19, 2026

    @DanielEScherzer
    Contributor

    As of 1.100.0

    cmp and ops are covered by lang-types.ops, #149
    UnsafeCell has lang-types.unsafe-cell, #149
    MaybeUninit has lang-types.maybe-uninit starting in the 1.101.0 docs, #2393
    Unpin is mentioned in lang-types.auto-traits.intro, #854
    VaListImpl was replaced with just VaList in rust-lang/rust#141980, and that is documented in lang-types.va-list, #2177

    ManuallyDrop is mentioned in destructors.manually-suppressing but not on the special types page, #128
    Unsize and CoerceUnsized mentioned in coerce.unsize.trait, again on a different page, #190
    Future mentioned in items.fn.async.desugar-brief on a different page, #635
    IntoIterator is mentioned in expr.loop.for.intro, on a different page, discussed since at least 4a2bdf8

    StructuralEq was removed in 1.77, rust-lang/rust#116167

    Still unstable: DispatchFromDyn, Receiver, Try, Freeze, StructuralPartialEq

    Generator renamed to Coroutine, rust-lang/rust#116958, still unstable
    GeneratorState renamed to CoroutineState, rust-lang/rust#116958, still unstable

    drop_in_place() is discussed in destructors.drop_in_place, #128, and isn't really a special type or trait, but rather a special function

    Not documented: IntoFuture
    Not sure what this is asking for: start, eh_personality, eh_catch_typeinfo, exchange_malloc, box_free, oom, alloc_layout, align_offset

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions