Struct Source

pub struct Source<'a> { /* private fields */ }

A Source owns or refers to a text string with an optional name denoting the origin.

The name and text are both Cow<'a, str> allowing a Source to either own or refer to these.

Implementations

impl<'a> Source<'a>

pub fn new<N, T>(optname: Option<N>, text: T) -> Self

where Cow<'a, str>: From<N> + From<T>,

Create a new Source with an optional origin name. Example: Source::new(Some("<built-in>"), "my text")

pub fn new_named<N, T>(name: N, text: T) -> Self

where Cow<'a, str>: From<N> + From<T>,

Create a new Source with a given origin name. Example: Source::new_named("<built-in>", "my text")

pub fn new_unnamed<T>(text: T) -> Self

where Cow<'a, str>: From<T>,

Create a new Source without an origin name. Example: Source::new_unnamed("my text")

pub fn name(&self) -> &str

Borrow the name of this Source, which if absent defaults to "<string>".

pub fn text(&self) -> &str

Borrow the text of this Source.

Trait Implementations

impl<'a> Debug for Source<'a>

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

Formats the value using the given formatter.

impl<'a> From<OwnedSource> for Source<'a>

fn from(s: OwnedSource) -> Source<'a>

Converts to this type from the input type.

impl<'a> From<Source<'a>> for OwnedSource

fn from(s: Source<'a>) -> OwnedSource

Converts to this type from the input type.