Struct rustc_span::SourceFile

source ·
pub struct SourceFile {
    pub name: FileName,
    pub src: Option<Lrc<String>>,
    pub src_hash: SourceFileHash,
    pub external_src: Lock<ExternalSource>,
    pub start_pos: BytePos,
    pub end_pos: BytePos,
    pub lines: Lock<SourceFileLines>,
    pub multibyte_chars: Vec<MultiByteChar>,
    pub non_narrow_chars: Vec<NonNarrowChar>,
    pub normalized_pos: Vec<NormalizedPos>,
    pub name_hash: u128,
    pub cnum: CrateNum,
Expand description

A single source in the SourceMap.


§name: FileName

The name of the file that the source came from. Source that doesn’t originate from files has names between angle brackets by convention (e.g., <anon>).

§src: Option<Lrc<String>>

The complete source code.

§src_hash: SourceFileHash

The source code’s hash.

§external_src: Lock<ExternalSource>

The external source code (used for external crates, which will have a None value as self.src.

§start_pos: BytePos

The start position of this source in the SourceMap.

§end_pos: BytePos

The end position of this source in the SourceMap.

§lines: Lock<SourceFileLines>

Locations of lines beginnings in the source code.

§multibyte_chars: Vec<MultiByteChar>

Locations of multi-byte characters in the source code.

§non_narrow_chars: Vec<NonNarrowChar>

Width of characters that are not narrow in the source code.

§normalized_pos: Vec<NormalizedPos>

Locations of characters removed during normalization.

§name_hash: u128

A hash of the filename, used for speeding up hashing in incremental compilation.

§cnum: CrateNum

Indicates which crate this SourceFile was imported from.


Returns the BytePos of the beginning of the current line.

Add externally loaded source. If the hash of the input doesn’t match or no input is supplied via None, it is interpreted as an error and the corresponding enum variant is set. The return value signifies whether some kind of source is present.

Gets a line from the list of pre-computed line-beginnings. The line number here is 0-based.

Finds the line containing the given position. The return value is the index into the lines array of this SourceFile, not the 1-based line number. If the source_file is empty or the position is located before the first line, None is returned.

Returns whether or not the file contains the given SourceMap byte position. The position one past the end of the file is considered to be contained by the file. This implies that files for which is_empty returns true still contain one byte position according to this function.

Calculates the original byte position relative to the start of the file based on the given byte position.

Converts an absolute BytePos to a CharPos relative to the SourceFile.

Looks up the file’s (1-based) line number and (0-based CharPos) column offset, for a given BytePos.

Looks up the file’s (1-based) line number, (0-based CharPos) column offset, and (0-based) column offset when displayed, for a given BytePos.

Trait Implementations§

Returns a copy of the value. Read more
Performs copy-assignment from source. Read more
Formats the value using the given formatter. Read more

Auto Trait Implementations§

Blanket Implementations§

Gets the TypeId of self. Read more
Immutably borrows from an owned value. Read more
Mutably borrows from an owned value. Read more

Returns the argument unchanged.

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

The resulting type after obtaining ownership.
Creates owned data from borrowed data, usually by cloning. Read more
Uses borrowed data to replace owned data, usually by cloning. Read more
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.


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: 288 bytes