Document

Struct Document 

Source
pub struct Document<'src> { /* private fields */ }
Expand description

A document represents the top-level block element in AsciiDoc. It consists of an optional document header and either a) one or more sections preceded by an optional preamble or b) a sequence of top-level blocks only.

The document can be configured using a document header. The header is not a block itself, but contributes metadata to the document, such as the document title and document attributes.

The Document structure is a self-contained package of the original content that was parsed and the data structures that describe that parsed content. The API functions on this struct can be used to understand the parse results.

Implementations§

Source§

impl<'src> Document<'src>

Source

pub fn header(&self) -> &Header<'_>

Return the document header.

Source

pub fn warnings(&self) -> Iter<'_, Warning<'_>>

Return an iterator over any warnings found during parsing.

Source

pub fn span(&self) -> Span<'_>

Return a Span describing the entire document source.

Source

pub fn source_map(&self) -> &SourceMap

Return the source map that tracks original file locations.

Source

pub fn catalog(&self) -> &Catalog

Return the document catalog for accessing referenceable elements.

Trait Implementations§

Source§

impl Debug for Document<'_>

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<'src> IsBlock<'src> for Document<'src>

Source§

fn content_model(&self) -> ContentModel

Returns the ContentModel for this block.
Source§

fn raw_context(&self) -> CowStr<'src>

Returns the raw (uninterpreted) context for this block. Read more
Source§

fn nested_blocks(&'src self) -> Iter<'src, Block<'src>>

Returns an iterator over the nested blocks contained within this block. Read more
Source§

fn title_source(&'src self) -> Option<Span<'src>>

Returns the source text for the title for this block, if present.
Source§

fn title(&self) -> Option<&str>

Returns the rendered title for this block, if present.
Source§

fn anchor(&'src self) -> Option<Span<'src>>

Returns the anchor for this block, if present.
Source§

fn anchor_reftext(&'src self) -> Option<Span<'src>>

Returns the reference text for this block’s anchor, if present.
Source§

fn attrlist(&'src self) -> Option<&'src Attrlist<'src>>

Returns the attribute list for this block, if present.
Source§

fn resolved_context(&'src self) -> CowStr<'src>

Returns the resolved context for this block. Read more
Source§

fn declared_style(&'src self) -> Option<&'src str>

Returns the declared (uninterpreted) style for this block. Read more
Source§

fn id(&'src self) -> Option<&'src str>

Returns the ID for this block, if present. Read more
Source§

fn roles(&'src self) -> Vec<&'src str>

Returns any role attributes that were found. Read more
Source§

fn options(&'src self) -> Vec<&'src str>

Returns any option attributes that were found. Read more
Source§

fn has_option<N: AsRef<str>>(&'src self, name: N) -> bool

Returns true if this block has the named option. Read more
Source§

fn substitution_group(&'src self) -> SubstitutionGroup

Returns the default substitution group that is applied unless you customize the substitutions for a particular element.
Source§

impl<'src> PartialEq for Document<'src>

Source§

fn eq(&self, other: &Document<'src>) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl<'src> Eq for Document<'src>

Source§

impl<'src> StructuralPartialEq for Document<'src>

Auto Trait Implementations§

§

impl<'src> Freeze for Document<'src>

§

impl<'src> RefUnwindSafe for Document<'src>

§

impl<'src> Send for Document<'src>

§

impl<'src> Sync for Document<'src>

§

impl<'src> Unpin for Document<'src>

§

impl<'src> UnwindSafe for Document<'src>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

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

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.