Struct DirectiveLine 

pub(crate) struct DirectiveLine<'a> {
    pub(crate) file_path: &'a Utf8Path,
    pub(crate) line_number: usize,
    pub(crate) revision: Option<&'a str>,
    raw_directive: &'a str,
    pub(crate) name: &'a str,
}

The (partly) broken-down contents of a line containing a test directive, which iter_directives passes to its callback function.

For example:

//@ compile-flags: -O
    ^^^^^^^^^^^^^^^^^ raw_directive
    ^^^^^^^^^^^^^     name

//@ [foo] compile-flags: -O
     ^^^                    revision
          ^^^^^^^^^^^^^^^^^ raw_directive
          ^^^^^^^^^^^^^     name

Fields

file_path: &'a Utf8Path

Path of the file containing this line.

Mostly used for diagnostics, but some directives (e.g. //@ pp-exact) also use it to compute a value based on the filename.

line_number: usize

revision: Option<&'a str>

Some test directives start with a revision name in square brackets (e.g. [foo]), and only apply to that revision of the test. If present, this field contains the revision name (e.g. foo).

raw_directive: &'a str

The main part of the directive, after removing the comment prefix and the optional revision specifier.

This is “raw” because the directive’s name and colon-separated value (if present) have not yet been extracted or checked.

name: &'a str

Name of the directive.

Invariant: self.raw_directive.starts_with(self.name)

Implementations

impl<'ln> DirectiveLine<'ln>

pub(crate) fn applies_to_test_revision( &self, test_revision: Option<&str>, ) -> bool

fn rest_after_separator(&self, separator: u8) -> Option<&'ln str>

Helper method used by value_after_colon and remark_after_space. Don’t call this directly.

pub(crate) fn value_after_colon(&self) -> Option<&'ln str>

If this directive uses name: value syntax, returns the part after the colon character.

pub(crate) fn remark_after_space(&self) -> Option<&'ln str>

If this directive uses name remark syntax, returns the part after the separating space.

pub(crate) fn display(&self) -> impl Display

Allows callers to print raw_directive if necessary, without accessing the field directly.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 72 bytes