Struct Args

pub struct Args { /* private fields */ }

Holds all the command-line arguments given by the user.

Each argument is contained within a HashMap that can be index by the argument’s name.

Implementations

impl Args

pub fn is_set(&self, name: impl Into<String>) -> bool

Determines if an argument of a given name was set by the user in the command-line.

Example

use easy_args::arg_spec;

let args = arg_spec!(size: [u64; 2]).parse().unwrap();
if args.is_set("size") {
    // resize the window height
}

pub fn boolean(&self, name: impl Into<String>) -> Option<&bool>

Returns a reference to the boolean value that corresponds with the given argument name.

Example

use easy_args::arg_spec;

let args = arg_spec!(fullscreen: bool).parse().unwrap();
if args.boolean("fullscreen") == Some(&true) {
    // go fullscreen
}

pub fn integer(&self, name: impl Into<String>) -> Option<&i64>

Returns a reference to the i64 value that corresponds with the given argument name.

Example

use easy_args::arg_spec;

let args = arg_spec!(leaves: i64).parse().unwrap();
let num_leaves_in_pile = *args.integer("leaves").unwrap_or(&0);

pub fn uinteger(&self, name: impl Into<String>) -> Option<&u64>

Returns a reference to the u64 value that corresponds with the given argument name.

Example

use easy_args::arg_spec;

let args = arg_spec!(size: u64).parse().unwrap();
let size = *args.uinteger("size").unwrap_or(&0);

pub fn float(&self, name: impl Into<String>) -> Option<&f64>

Returns a reference to the f64 value that corresponds with the given argument name.

Example

use easy_args::arg_spec;

let args = arg_spec!(gravity: f64).parse().unwrap();
let size = *args.float("gravity").unwrap_or(&9.81);

pub fn string(&self, name: impl Into<String>) -> Option<&String>

Returns a reference to the String value that corresponds with the given argument name.

Exmaple

use easy_args::arg_spec;

let args = arg_spec!(username: String).parse().unwrap();
let username = args.string("username").unwrap_or(&"Guest".to_string());

pub fn boolean_array(&self, name: impl Into<String>) -> Option<&[bool]>

Returns a reference to the boolean slice that corresponds with the given argument name.

Example

use easy_args::arg_spec;

let args = arg_spec!(flags: [bool; 5]).parse().unwrap();
if let Some(flags) = args.boolean_array("flags") {
    // do something with flags
}

pub fn integer_array(&self, name: impl Into<String>) -> Option<&[i64]>

Returns a reference to the i64 slice that corresponds with the given argument name.

Example

use easy_args::arg_spec;

let args = arg_spec!(position: [i64; 3]).parse().unwrap();
if let Some([x, y, z]) = args.integer_array("position") {
    // do something with the position
}

pub fn uinteger_array(&self, name: impl Into<String>) -> Option<&[u64]>

Returns a reference to the u64 slice that corresponds with the given argument name.

Example

use easy_args::arg_spec;

let args = arg_spec!(size: [u64; 2]).parse().unwrap();
if let Some([width, height]) = args.uinteger_array("size") {
    // do something with screen size
}

pub fn float_array(&self, name: impl Into<String>) -> Option<&[f64]>

Returns a reference to the f64 slice that corresponds with the given argument name.

Example

use easy_args::arg_spec;

let args = arg_spec!(position: [f64; 3]).parse().unwrap();
if let Some([x, y, z]) = args.float_array("position") {
    // do something with position
}

pub fn string_array(&self, name: impl Into<String>) -> Option<&[String]>

Returns a reference to the String slice that corresponds with the given argument name.

Exmaple

use easy_args::arg_spec;

let args = arg_spec!(login_details: [String; 2]).parse().unwrap();
if let Some([username, password]) = args.string_array("login_details") {
    // do something with username and password
}

pub fn free_args(&self) -> &Vec<String>

A Vector of all strings passed as command-line arguments that weren’t arguments of the ArgSpec.

Example

use easy_args::arg_spec;

let args = arg_spec!().parse().unwrap();
for arg in args.free_args() {
    println!("What the heck is this? '{}'.", arg);
}

Trait Implementations

impl Debug for Args

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

Formats the value using the given formatter.