Enum clap::ArgSettings[][src]

#[non_exhaustive]
pub enum ArgSettings {
Show 25 variants Required, MultipleValues, MultipleOccurrences, Multiple, ForbidEmptyValues, Global, Hidden, TakesValue, UseValueDelimiter, NextLineHelp, RequireDelimiter, HidePossibleValues, AllowHyphenValues, AllowLeadingHyphen, RequireEquals, Last, HideDefaultValue, IgnoreCase, CaseInsensitive, HideEnv, HideEnvValues, HiddenShortHelp, HiddenLongHelp, AllowInvalidUtf8, Exclusive,
}
Expand description

Various settings that apply to arguments and may be set, unset, and checked via getter/setter methods Arg::setting, Arg::unset_setting, and Arg::is_set. This is what the Arg methods which accept a bool use internally.

Variants (Non-exhaustive)

This enum is marked as non-exhaustive
Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Required

Specifies that an arg must be used

MultipleValues

Allows an arg to accept multiple values

MultipleOccurrences

Allows an arg to appear multiple times

Multiple

👎 Deprecated since 3.0.0:

Split into ArgSettings::MultipleOccurrences (most likely what you want) and ArgSettings::MultipleValues

Deprecated, see ArgSettings::MultipleOccurrences (most likely what you want) and ArgSettings::MultipleValues

ForbidEmptyValues

Forbids an arg from accepting empty values such as ""

Global

Sets an arg to be global (i.e. exist in all subcommands)

Hidden

Hides an arg from the help message

TakesValue

Allows an argument to take a value (such as --option value)

UseValueDelimiter

Enables a delimiter to break up arguments --option val1,val2,val3 becomes three values (val1, val2, and val3) instead of the default one (val1,val2,val3)

NextLineHelp

Tells an arg to display it’s help on the line below the arg itself in the help message

RequireDelimiter

Says that arg must use a delimiter to separate values

HidePossibleValues

Hides the possible values from the help message

AllowHyphenValues

Allows values that start with a hyphen

AllowLeadingHyphen

👎 Deprecated since 3.0.0:

Replaced with ArgSettings::AllowHyphenValues

Deprecated, replaced with ArgSettings::AllowHyphenValues

RequireEquals

Requires that an equals be used to provide a value to an option such as --option=value

Last

Says that a positional arg will be the last positional, and requires -- to be accessed. It can also be accessed early (i.e. before other positionals) by providing --

HideDefaultValue

Hides the default value from the help message

IgnoreCase

Possible values become case insensitive

CaseInsensitive

👎 Deprecated since 3.0.0:

Replaced with ArgSettings::IgnoreCase

Deprecated, replaced with ArgSettings::IgnoreCase

HideEnv

Hides environment variable arguments from the help message

HideEnvValues

Hides any values currently assigned to ENV variables in the help message (good for sensitive information)

HiddenShortHelp

The argument should not be shown in short help text

HiddenLongHelp

The argument should not be shown in long help text

AllowInvalidUtf8

Specifies that option values that are invalid UTF-8 should not be treated as an error.

Exclusive

Specifies that option should exist on its own. Having any other arguments present at runtime is an error.

Trait Implementations

The resulting type after applying the | operator.

Performs the | operation. Read more

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

Formats the value using the given formatter. Read more

Deprecated in Issue #3087, maybe clap::Parser would fit your use case?

The associated error which can be returned from parsing.

Parses a string s to return a value of this type. Read more

This method tests for self and other values to be equal, and is used by ==. Read more

This method tests for !=.

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more

Immutably borrows from an owned value. Read more

Mutably borrows from an owned value. Read more

Performs the conversion.

Performs the conversion.

The resulting type after obtaining ownership.

Creates owned data from borrowed data, usually by cloning. Read more

🔬 This is a nightly-only experimental API. (toowned_clone_into)

Uses borrowed data to replace owned data, usually by cloning. Read more

The type returned in the event of a conversion error.

Performs the conversion.

The type returned in the event of a conversion error.

Performs the conversion.