Struct EnvVar 

pub struct EnvVar {
    pub name: &'static str,
    pub kind: EnvKind,
    pub owner: Owner,
    pub default: &'static str,
    pub summary: &'static str,
}

One environment variable this crate reads.

Fields

name: &'static str

The variable name as it appears in the environment.

kind: EnvKind

What the value means and how it is parsed.

owner: Owner

Who owns the value space.

default: &'static str

What happens when the variable is unset.

summary: &'static str

One line an embedder can read to know whether they care.

Implementations

impl EnvVar

pub fn is_set(&self) -> bool

Read this variable as a boolean, using the semantics it declares.

Panics

If the variable is not declared as a flag. That is a programming error in this crate, caught by an_unset_flag_matches_its_declared_default, not something a value in the environment can cause.

impl EnvVar

pub fn count_or(&self, default: usize) -> usize

Read this variable as a count, falling back to default.

A value that is not a number is not a smaller number: it is a mistake, and the default is a better answer than a silently-wrong one.

pub fn millis_or(&self, default: Duration) -> Duration

Read this variable as a millisecond duration, falling back to default.

pub fn port(&self) -> Option<u16>

Read this variable as a port number, if it names one.

pub fn text(&self) -> Option<String>

Read this variable as text, if it is set to anything.

pub fn path(&self) -> Option<PathBuf>

Read this variable as a path, if it is set to anything.

Takes the value as the host wrote it: a path that is not valid Unicode is still a path, and lossily repairing it would point somewhere else.

Trait Implementations

impl Clone for EnvVar

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for EnvVar

impl Debug for EnvVar

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

Formats the value using the given formatter.