Struct AttributeParser

pub struct AttributeParser<'sess> {
    tools: Vec<Symbol>,
    sess: &'sess Session,
    features: Option<&'sess Features>,
    parse_only: Option<Symbol>,
    pub(crate) limit_diagnostics: bool,
}

Context created once, for example as part of the ast lowering context, through which all attributes can be lowered.

Fields

tools: Vec<Symbol>

sess: &'sess Session

features: Option<&'sess Features>

parse_only: Option<Symbol>

only parse attributes with this symbol.

Used in cases where we want the lowering infrastructure for parse just a single attribute.

limit_diagnostics: bool

Can be used to instruct parsers to reduce the number of diagnostics it emits. Useful when using parse_limited and you know the attr will be reparsed later.

Implementations

impl<'sess> AttributeParser<'sess>

pub fn parse_limited( sess: &'sess Session, attrs: &[Attribute], sym: Symbol, target_span: Span, limit_diagnostics: bool, ) -> Option<Attribute>

This method allows you to parse attributes before you have access to features or tools. One example where this is necessary, is to parse feature attributes themselves for example.

Try to use this as little as possible. Attributes should be lowered during rustc_ast_lowering. Some attributes require access to features to parse, which would crash if you tried to do so through parse_limited.

To make sure use is limited, supply a Symbol you’d like to parse. Only attributes with that symbol are picked out of the list of instructions and parsed. Those are returned.

pub fn new( sess: &'sess Session, features: &'sess Features, tools: Vec<Symbol>, ) -> Self

pub(crate) fn sess(&self) -> &'sess Session

pub(crate) fn features(&self) -> &'sess Features

pub(crate) fn dcx(&self) -> DiagCtxtHandle<'sess>

pub fn parse_attribute_list<'a>( &'a self, attrs: &'a [Attribute], target_span: Span, omit_doc: OmitDoc, lower_span: impl Copy + Fn(Span) -> Span, ) -> Vec<Attribute>

Parse a list of attributes.

target_span is the span of the thing this list of attributes is applied to, and when omit_doc is set, doc attributes are filtered out.

fn lower_attr_args( &self, args: &AttrArgs, lower_span: impl Fn(Span) -> Span, ) -> AttrArgs

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 48 bytes