Enum InitError 

pub enum InitError {
    Ambiguous {
        symbol: &'static Symbol,
    },
    Circular {
        symbols: Vec<&'static Symbol>,
    },
}

Error type returned by init_static() when initialization fails.

This enum represents the various failure modes that can occur during the static initialization process.

Note on Execution Errors

Errors returned by initialization expressions (e.g., "42".parse()?) are NOT wrapped in this enum. Instead, init_static() returns anyhow::Result<()> directly, which preserves the original error’s backtrace for better debugging.

To distinguish between error types, use anyhow::Error::downcast or anyhow::Error::downcast_ref.

Variants

Ambiguous

A static symbol was defined multiple times.

This typically occurs when the same init_static! block is included multiple times, or when two statics in different modules have the exact same source location metadata (which should not happen in normal usage).

Fields

symbol: &'static Symbol

Circular

A circular dependency was detected among statics.

This occurs when static A depends on static B, and static B (directly or indirectly) depends on static A. The initialization system cannot determine a valid order to initialize such statics.

Example

use init_static::init_static;

init_static! {
    // This creates a circular dependency and will fail at runtime
    static A: u32 = *B + 1;
    static B: u32 = *A + 1;
}

Fields

symbols: Vec<&'static Symbol>

Trait Implementations

impl Debug for InitError

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

Formats the value using the given formatter.

impl Display for InitError

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

Formats the value using the given formatter.

impl Error for InitError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.