Struct syn::File

[+] Show declaration

pub struct File {
    pub shebang: Option<String>,
    pub attrs: Vec<Attribute>,
    pub items: Vec<Item>,
}

[−] Expand description

A complete file of Rust source code.

This type is available if Syn is built with the "full" feature.

Example

Parse a Rust source file into a syn::File and print out a debug representation of the syntax tree.

use std::env;
use std::fs::File;
use std::io::Read;
use std::process;

fn main() {
# }
#
# fn fake_main() {
    let mut args = env::args();
    let _ = args.next(); // executable name

    let filename = match (args.next(), args.next()) {
        (Some(filename), None) => filename,
        _ => {
            eprintln!("Usage: dump-syntax path/to/filename.rs");
            process::exit(1);
        }
    };

    let mut file = File::open(&filename).expect("Unable to open file");

    let mut src = String::new();
    file.read_to_string(&mut src).expect("Unable to read file");

    let syntax = syn::parse_file(&src).expect("Unable to parse file");
    println!("{:#?}", syntax);
}

Running with its own source code as input, this program prints output that begins with:

File {
    shebang: None,
    attrs: [],
    items: [
        ExternCrate(
            ItemExternCrate {
                attrs: [],
                vis: Inherited,
                extern_token: Extern,
                crate_token: Crate,
                ident: Ident {
                    term: Term(
                        "syn"
                    ),
                    span: Span
                },
                rename: None,
                semi_token: Semi
            }
        ),
...

Fields

shebang: Option<String>

attrs: Vec<Attribute>

items: Vec<Item>

Trait Implementations

impl Parse for File

[+]

[+] Show hidden undocumented items

fn parse(input: ParseStream) -> Result<Self>

impl PartialEq<File> for File

[+]

[+] Show hidden undocumented items

fn eq(&self, other: &File) -> bool

[−]

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &File) -> bool

[−]

This method tests for !=.

impl Clone for File

[+]

[+] Show hidden undocumented items

fn clone(&self) -> File

[−]

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

[−]

Performs copy-assignment from source.

impl Eq for File

impl Debug for File

[+]

[+] Show hidden undocumented items

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

[−]

Formats the value using the given formatter.

impl Hash for File

[+]

[+] Show hidden undocumented items

fn hash<__H: Hasher>(&self, state: &mut __H)

[−]

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where     H: Hasher,

[−]

Feeds a slice of this type into the given [Hasher].

impl ToTokens for File

[+]

[+] Show hidden undocumented items

fn to_tokens(&self, tokens: &mut TokenStream)

[−]

Write self to the given TokenStream.

fn into_token_stream(self) -> TokenStream

[−]

Convert self directly into a TokenStream object.