Struct CppBuild 

pub struct CppBuild {
    pub compiler: String,
    pub compiler_version: Option<String>,
    pub linker: Option<String>,
    pub macros: Vec<String>,
    pub include_paths: Vec<String>,
    pub flags: Vec<String>,
    pub database_hash: Option<String>,
    pub post_processing_tools: Vec<String>,
}

What a C or C++ translation unit was compiled with.

Fields

compiler: String

The compiler as the database spells it.

compiler_version: Option<String>

Its version, which only something that ran it can know.

linker: Option<String>

The linker, for the variants that reach a link step.

macros: Vec<String>

One entry per macro, in the flag form its last mention left it in (-DNAME=value or -UNAME), sorted by macro name.

include_paths: Vec<String>

Include directories in search order, without the -I.

flags: Vec<String>

Everything else that was passed, in the order it was passed.

database_hash: Option<String>

A hash of the compilation database this came from.

post_processing_tools: Vec<String>

Post-processing tools declared for this build, in invocation order.

This is deliberately declarative. Source analysis never runs a tool in this list; artifact analysis may consume the recorded fact later.

Implementations

impl CppBuild

pub fn from_command(arguments: &[String], file: &Path) -> Self

The identity of one entry of a compilation database.

file is the translation unit’s own source, which is dropped: it says which unit this is, not which variant it belongs to.

pub fn from_command_in_directory( arguments: &[String], file: &Path, directory: Option<&Path>, ) -> Self

The identity of one entry of a compilation database whose command ran from directory.

Relative input arguments are resolved from that directory before they are compared with file, so translation-unit paths do not accidentally become variant settings.

pub fn defines(&self) -> Vec<&str>

The macros left defined, without the -D.

pub fn settings(&self) -> Vec<Setting>

Everything this build was told, in the order the identity encodes it.

Trait Implementations

impl Clone for CppBuild

fn clone(&self) -> CppBuild

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CppBuild

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

Formats the value using the given formatter.

impl Default for CppBuild

fn default() -> CppBuild

Returns the “default value” for a type.

impl Eq for CppBuild

impl PartialEq for CppBuild

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for CppBuild