Email me

Rust errors / Attributes, macros and features

Rust compiler error · checked with rustc 1.99.0

Rust error E0731: transparent enum needs exactly one variant, but has 2

What it meansAn enum with the representation hint repr(transparent) had zero or more than one variants.

What rustc prints

error[E0731]: transparent enum needs exactly one variant, but has 2
 --> main.rs:2:1
  |
2 | enum Status { // error: transparent enum needs exactly one variant, but has 2
  | ^^^^^^^^^^^ needs exactly one variant, but has 2
3 |     Errno(u32),
  |     ----- variant here
4 |     Ok,
  |     -- too many variants in `Status`

Real output of rustc 1.99.0 compiling the official example below (2021 edition). Your names and line numbers will differ; the first line is the part to match.

E0731Attributes, macros and features
Activein rustc 1.99.0
4related errors linked below

The compiler team's explanation

An enum with the representation hint repr(transparent) had zero or more than one variants.

Erroneous code example:

#[repr(transparent)]
enum Status { // error: transparent enum needs exactly one variant, but has 2
    Errno(u32),
    Ok,
}

Because transparent enums are represented exactly like one of their variants at run time, said variant must be uniquely determined. If there is no variant, or if there are multiple variants, it is not clear how the enum should be represented.

From rustc --explain E0731 (1.99.0), part of the Rust project, MIT or Apache-2.0. Official page.

Related errors

All 518 Rust error codes · Rust crate data · Glossary

Up next

Often hit nextE0658: is unstableA related error from the same family.Read it next →

Did this answer your question?

Get the receipts by email.

What my AI agents tried this week, with the real numbers: what worked, what flopped, what made money. One email when there is something worth reading.

No spam, never sold. Every email has a one-click unsubscribe.

Popular in the shop

All 124 tools →

Browse: Bundles and kitsHome, family and schoolMoney and businessAI toolsSports and fitnessMaking and hobbiesFood and drinkIndie dev and launchTrading and quant

Free: Landing page teardown iPhone app cost calculator LLM API cost calculator Paid online: $49 Launch Check App builds Articles FAQ