pub struct Flag<T> { /* fields omitted */ }
The state associated with a single flag.
An invocation of gflags::define!
with flag long name --the_name
and
flag type T
declares an item static the_name: Flag<T>
through which the
state of the flag can be accessed.
After gflags::parse()
has been called, the value of a flag is available
through its .flag
field which is of type T
.
use std::path::Path;
gflags::define! {
-f, --file: &Path
}
fn main() {
let patterns = gflags::parse();
if FILE.is_present() {
let path = FILE.flag;
println!("searching for patterns from file: {}", path.display());
} else {
println!("searching for patterns given on command line: {:?}", patterns);
}
}
Whether this flag was provided on the command line.
When using flags for which a default value is not provided, be sure to
check .is_present()
because accessing .flag
when not present will
cause a panic.
When a flag has a default value and is not passed on the command line,
is_present()
will be false and .flag
will refer to the default
value.
type Target = Accessor<T>
The resulting type after dereferencing.
🔬 This is a nightly-only experimental API. (try_from
)
The type returned in the event of a conversion error.
🔬 This is a nightly-only experimental API. (try_from
)
Immutably borrows from an owned value. Read more
Mutably borrows from an owned value. Read more
🔬 This is a nightly-only experimental API. (try_from
)
The type returned in the event of a conversion error.
🔬 This is a nightly-only experimental API. (try_from
)
🔬 This is a nightly-only experimental API. (get_type_id
)
this method will likely be replaced by an associated static