Struct codespan_reporting::files::SimpleFile

pub struct SimpleFile<Name, Source> {
    name: Name,
    source: Source,
    line_starts: Vec<usize>,
}

A file database that contains a single source file.

Because there is only single file in this database we use () as a FileId.

This is useful for simple language tests, but it might be worth creating a custom implementation when a language scales beyond a certain size.

Fields

name: Name

The name of the file.

source: Source

The source code of the file.

line_starts: Vec<usize>

The starting byte indices in the source code.

Implementations

impl<Name, Source> SimpleFile<Name, Source>

where Name: Display, Source: AsRef<str>,

pub fn new(name: Name, source: Source) -> SimpleFile<Name, Source>

Create a new source file.

pub fn name(&self) -> &Name

Return the name of the file.

pub fn source(&self) -> &Source

Return the source of the file.

fn line_start(&self, line_index: usize) -> Result<usize, Error>

Return the starting byte index of the line with the specified line index. Convenience method that already generates errors if necessary.

Trait Implementations

impl<Name: Clone, Source: Clone> Clone for SimpleFile<Name, Source>

fn clone(&self) -> SimpleFile<Name, Source>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<Name: Debug, Source: Debug> Debug for SimpleFile<Name, Source>

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

Formats the value using the given formatter.

impl<'a, Name, Source> Files<'a> for SimpleFile<Name, Source>

where Name: 'a + Display + Clone, Source: 'a + AsRef<str>,

type FileId = ()

A unique identifier for files in the file provider. This will be used for rendering diagnostic::Labels in the corresponding source files.

type Name = Name

The user-facing name of a file, to be displayed in diagnostics.

type Source = &'a str

The source code of a file.

fn name(&self, (): ()) -> Result<Name, Error>

The user-facing name of a file.

fn source(&self, (): ()) -> Result<&str, Error>

The source code of a file.

fn line_index(&self, (): (), byte_index: usize) -> Result<usize, Error>

The index of the line at the given byte index. If the byte index is past the end of the file, returns the maximum line index in the file. This means that this function only fails if the file is not present.

fn line_range(&self, (): (), line_index: usize) -> Result<Range<usize>, Error>

The byte range of line in the source of the file.

fn line_number( &'a self, id: Self::FileId, line_index: usize, ) -> Result<usize, Error>

The user-facing line number at the given line index. It is not necessarily checked that the specified line index is actually in the file.

fn column_number( &'a self, id: Self::FileId, line_index: usize, byte_index: usize, ) -> Result<usize, Error>

The user-facing column number at the given line index and byte index.

fn location( &'a self, id: Self::FileId, byte_index: usize, ) -> Result<Location, Error>

Convenience method for returning line and column number at the given byte index in the file.