Struct SourceFile

pub struct SourceFile {
    pub name: FileName,
    pub src: Arc<String>,
    pub src_hash: SourceFileHash,
    pub start_pos: BytePos,
    pub source_len: RelativeBytePos,
    pub lines: Vec<RelativeBytePos>,
    pub multibyte_chars: Vec<MultiByteChar>,
    pub stable_id: StableSourceFileId,
}

A single source in the SourceMap.

Fields

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., <stdin>).

src: Arc<String>

The complete source code.

src_hash: SourceFileHash

The source code’s hash.

start_pos: BytePos

The start position of this source in the SourceMap.

source_len: RelativeBytePos

The byte length of this source.

lines: Vec<RelativeBytePos>

Locations of lines beginnings in the source code.

multibyte_chars: Vec<MultiByteChar>

Locations of multi-byte characters in the source code.

stable_id: StableSourceFileId

A hash of the filename & crate-id, used for uniquely identifying source files within the crate graph and for speeding up hashing in incremental compilation.

Implementations

impl SourceFile

pub fn new( name: FileName, src: String, hash_kind: SourceFileHashAlgorithm, ) -> Result<Self, OffsetOverflowError>

pub fn lines(&self) -> &[RelativeBytePos]

pub fn count_lines(&self) -> usize

pub fn absolute_position(&self, pos: RelativeBytePos) -> BytePos

pub fn relative_position(&self, pos: BytePos) -> RelativeBytePos

pub fn end_position(&self) -> BytePos

pub fn lookup_line(&self, pos: RelativeBytePos) -> Option<usize>

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.

pub fn line_position(&self, line_number: usize) -> Option<usize>

Returns the relative byte position of the start of the line at the given 0-based line index.

pub fn lookup_file_pos_with_col_display( &self, pos: BytePos, ) -> (usize, CharPos, usize)

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.

pub fn get_line(&self, line_number: usize) -> Option<&str>

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

pub fn get_lines(&self, range: RangeInclusive<usize>) -> Option<&str>

Gets a slice of the source text between two lines, including the terminator of the second line (if any).

pub fn contains(&self, byte_pos: BytePos) -> bool

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.

pub fn is_empty(&self) -> bool

pub fn original_relative_byte_pos(&self, pos: BytePos) -> RelativeBytePos

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

Trait Implementations

impl Clone for SourceFile

fn clone(&self) -> SourceFile

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for SourceFile

fn fmt(&self, __derive_more_f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.