Struct syn::Path

pub struct Path {
    pub leading_colon: Option<PathSep>,
    pub segments: Punctuated<PathSegment, PathSep>,
}

A path at which a named item is exported (e.g. std::collections::HashMap).

Fields

leading_colon: Option<PathSep>

segments: Punctuated<PathSegment, PathSep>

Implementations

impl Path

pub fn is_ident<I: ?Sized>(&self, ident: &I) -> boolwhere
    Ident: PartialEq<I>,

Determines whether this is a path of length 1 equal to the given ident.

For them to compare equal, it must be the case that:

• the path has no leading colon,
• the number of path segments is 1,
• the first path segment has no angle bracketed or parenthesized path arguments, and
• the ident of the first path segment is equal to the given one.

Example

use proc_macro2::TokenStream;
use syn::{Attribute, Error, Meta, Result};

fn get_serde_meta_item(attr: &Attribute) -> Result<Option<&TokenStream>> {
    if attr.path().is_ident("serde") {
        match &attr.meta {
            Meta::List(meta) => Ok(Some(&meta.tokens)),
            bad => Err(Error::new_spanned(bad, "unrecognized attribute")),
        }
    } else {
        Ok(None)
    }
}

pub fn get_ident(&self) -> Option<&Ident>

If this path consists of a single ident, returns the ident.

A path is considered an ident if:

• the path has no leading colon,
• the number of path segments is 1, and
• the first path segment has no angle bracketed or parenthesized path arguments.

Trait Implementations

impl From<Path> for Meta

fn from(e: Path) -> Meta

Converts to this type from the input type.

impl<T> From<T> for Pathwhere
    T: Into<PathSegment>,

fn from(segment: T) -> Self

Converts to this type from the input type.