Struct Cc

pub struct Cc {
    cmd: Command,
}

A platform-specific C compiler invocation builder. The specific C compiler used is passed down from compiletest.

Fields

cmd: Command

Implementations

impl Cc

pub fn env<K, V>(&mut self, key: K, value: V) -> &mut Self

where K: AsRef<OsStr>, V: AsRef<OsStr>,

Specify an environment variable.

pub fn env_remove<K>(&mut self, key: K) -> &mut Self

where K: AsRef<OsStr>,

Remove an environmental variable.

pub fn arg<S>(&mut self, arg: S) -> &mut Self

where S: AsRef<OsStr>,

Generic command argument provider. Prefer specific helper methods if possible. Note that for some executables, arguments might be platform specific. For C/C++ compilers, arguments might be platform and compiler specific.

pub fn args<V, S>(&mut self, args: V) -> &mut Self

where V: AsRef<[S]>, S: AsRef<OsStr>,

Generic command arguments provider. Prefer specific helper methods if possible. Note that for some executables, arguments might be platform specific. For C/C++ compilers, arguments might be platform and compiler specific.

pub fn stdin<T: Into<Stdio>>(&mut self, cfg: T) -> &mut Self

Configuration for the child process’s standard input (stdin) handle.

See std::process::Command::stdin.

pub fn stdout<T: Into<Stdio>>(&mut self, cfg: T) -> &mut Self

Configuration for the child process’s standard output (stdout) handle.

See std::process::Command::stdout.

pub fn stderr<T: Into<Stdio>>(&mut self, cfg: T) -> &mut Self

Configuration for the child process’s standard error (stderr) handle.

See std::process::Command::stderr.

pub fn inspect<I>(&mut self, inspector: I) -> &mut Self

where I: FnOnce(&Command),

Inspect what the underlying Command is up to the current construction.

pub fn run(&mut self) -> CompletedProcess

Run the constructed command and assert that it is successfully run.

pub fn run_fail(&mut self) -> CompletedProcess

Run the constructed command and assert that it does not successfully run.

pub fn run_unchecked(&mut self) -> CompletedProcess

Run the command but do not check its exit status. Only use if you explicitly don’t care about the exit status. Prefer to use Self::run and Self::run_fail whenever possible.

pub fn current_dir<P: AsRef<Path>>(&mut self, path: P) -> &mut Self

Set the path where the command will be run.

impl Cc

pub fn new() -> Self

Construct a new platform-specific C compiler invocation.

WARNING: This means that what flags are accepted by the underlying C compile is platform- AND compiler-specific. Consult the relevant docs for gcc, clang and mvsc.

pub fn new_cxx() -> Self

Construct a new platform-specific CXX compiler invocation. CXX_DEFAULT_FLAGS is passed from compiletest.

pub fn input<P: AsRef<Path>>(&mut self, path: P) -> &mut Self

Specify path of the input file.

pub fn library_search_path<P: AsRef<Path>>(&mut self, path: P) -> &mut Self

Adds directories to the list that the linker searches for libraries. Equivalent to -L.

pub fn out_exe(&mut self, name: &str) -> &mut Self

Specify -o or -Fe/-Fo depending on platform/compiler.

pub fn output<P: AsRef<Path>>(&mut self, path: P) -> &mut Self

Specify path of the output binary.

pub fn optimize(&mut self) -> &mut Self

Optimize the output. Equivalent to -O3 for GNU-compatible linkers or -O2 for MSVC linkers.

Trait Implementations

impl Debug for Cc

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

Formats the value using the given formatter.

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: 312 bytes