Enum rustdoc::clean::types::DocFragment

pub enum DocFragment {
    SugaredDoc(usize, Span, String),
    RawDoc(usize, Span, String),
    Include(usize, Span, String, String),
}

A portion of documentation, extracted from a #[doc] attribute.

Each variant contains the line number within the complete doc-comment where the fragment starts, as well as the Span where the corresponding doc comment or attribute is located.

Included files are kept separate from inline doc comments so that proper line-number information can be given when a doctest fails. Sugared doc comments and "raw" doc comments are kept separate because of issue #42760.

Variants

SugaredDoc(usize, Span, String)

A doc fragment created from a /// or //! doc comment.

RawDoc(usize, Span, String)

A doc fragment created from a "raw" #[doc=""] attribute.

Include(usize, Span, String, String)

A doc fragment created from a #[doc(include="filename")] attribute. Contains both the given filename and the file contents.

Implementations

impl DocFragment

pub fn as_str(&self) -> &str

pub fn span(&self) -> Span

impl DocFragment

fn kind(&self) -> DocFragmentKind

Trait Implementations

impl Clone for DocFragment

fn clone(&self) -> DocFragment

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DocFragment

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

Formats the value using the given formatter.

impl Eq for DocFragment

impl<'a> FromIterator<&'a DocFragment> for String

fn from_iter<T>(iter: T) -> Self where
    T: IntoIterator<Item = &'a DocFragment>, 

Creates a value from an iterator.

impl Hash for DocFragment

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl PartialEq<DocFragment> for DocFragment

fn eq(&self, other: &DocFragment) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl StructuralEq for DocFragment

impl StructuralPartialEq for DocFragment