Struct rustc_metadata::rmeta::CrateRoot

pub(crate) struct CrateRoot<'tcx> {
    name: Symbol,
    triple: TargetTriple,
    extra_filename: String,
    hash: Svh,
    disambiguator: CrateDisambiguator,
    panic_strategy: PanicStrategy,
    edition: Edition,
    has_global_allocator: bool,
    has_panic_handler: bool,
    has_default_lib_allocator: bool,
    plugin_registrar_fn: Option<DefIndex>,
    crate_deps: Lazy<[CrateDep]>,
    dylib_dependency_formats: Lazy<[Option<LinkagePreference>]>,
    lib_features: Lazy<[(Symbol, Option<Symbol>)]>,
    lang_items: Lazy<[(DefIndex, usize)]>,
    lang_items_missing: Lazy<[LangItem]>,
    diagnostic_items: Lazy<[(Symbol, DefIndex)]>,
    native_libraries: Lazy<[NativeLib]>,
    foreign_modules: Lazy<[ForeignModule]>,
    impls: Lazy<[TraitImpls]>,
    interpret_alloc_index: Lazy<[u32]>,
    proc_macro_data: Option<ProcMacroData>,
    tables: LazyTables<'tcx>,
    exported_symbols: Lazy<[(ExportedSymbol<'tcx>, SymbolExportLevel)], usize>,
    syntax_contexts: Lazy<Table<u32, Lazy<SyntaxContextData>>>,
    expn_data: Lazy<Table<u32, Lazy<ExpnData>>>,
    source_map: Lazy<[SourceFile]>,
    compiler_builtins: bool,
    needs_allocator: bool,
    needs_panic_runtime: bool,
    no_builtins: bool,
    panic_runtime: bool,
    profiler_runtime: bool,
    symbol_mangling_version: SymbolManglingVersion,
}

Serialized metadata for a crate. When compiling a proc-macro crate, we encode many of the Lazy<[T]> fields as Lazy::empty(). This serves two purposes:

1. We avoid performing unnecessary work. Proc-macro crates can only export proc-macros functions, which are compiled into a shared library. As a result, a large amount of the information we normally store (e.g. optimized MIR) is unneeded by downstream crates.
2. We avoid serializing invalid CrateNums. When we deserialize a proc-macro crate, we don't load any of its dependencies (since we just need to invoke a native function from the shared library). This means that any foreign CrateNums that we serialize cannot be deserialized, since we will not know how to map them into the current compilation session. If we were to serialize a proc-macro crate like a normal crate, much of what we serialized would be unusable in addition to being unused.

Fields

name: Symbol

triple: TargetTriple

extra_filename: String

hash: Svh

disambiguator: CrateDisambiguator

panic_strategy: PanicStrategy

edition: Edition

has_global_allocator: bool

has_panic_handler: bool

has_default_lib_allocator: bool

plugin_registrar_fn: Option<DefIndex>

crate_deps: Lazy<[CrateDep]>

dylib_dependency_formats: Lazy<[Option<LinkagePreference>]>

lib_features: Lazy<[(Symbol, Option<Symbol>)]>

lang_items: Lazy<[(DefIndex, usize)]>

lang_items_missing: Lazy<[LangItem]>

diagnostic_items: Lazy<[(Symbol, DefIndex)]>

native_libraries: Lazy<[NativeLib]>

foreign_modules: Lazy<[ForeignModule]>

impls: Lazy<[TraitImpls]>

interpret_alloc_index: Lazy<[u32]>

proc_macro_data: Option<ProcMacroData>

tables: LazyTables<'tcx>

exported_symbols: Lazy<[(ExportedSymbol<'tcx>, SymbolExportLevel)], usize>

syntax_contexts: Lazy<Table<u32, Lazy<SyntaxContextData>>>

expn_data: Lazy<Table<u32, Lazy<ExpnData>>>

source_map: Lazy<[SourceFile]>

compiler_builtins: bool

needs_allocator: bool

needs_panic_runtime: bool

no_builtins: bool

panic_runtime: bool

profiler_runtime: bool

symbol_mangling_version: SymbolManglingVersion

Implementations

impl<'_> CrateRoot<'_>

pub(crate) fn is_proc_macro_crate(&self) -> bool

pub(crate) fn name(&self) -> Symbol

pub(crate) fn disambiguator(&self) -> CrateDisambiguator

pub(crate) fn hash(&self) -> Svh

pub(crate) fn triple(&self) -> &TargetTriple

pub(crate) fn decode_crate_deps<'a>(
    &self,
    metadata: &'a MetadataBlob
) -> impl ExactSizeIterator<Item = CrateDep> + Captures<'a>

Trait Implementations

impl<'tcx, '__a> Decodable<DecodeContext<'__a, 'tcx>> for CrateRoot<'tcx>

pub fn decode(
    __decoder: &mut DecodeContext<'__a, 'tcx>
) -> Result<Self, <DecodeContext<'__a, 'tcx> as Decoder>::Error>

impl<'tcx, '__a> Encodable<EncodeContext<'__a, 'tcx>> for CrateRoot<'tcx>

pub fn encode(
    &self,
    __encoder: &mut EncodeContext<'__a, 'tcx>
) -> Result<(), <EncodeContext<'__a, 'tcx> as Encoder>::Error>