Enum ExpansionModifier 

pub enum ExpansionModifier<'a> {
    Substring {
        offset: Cow<'a, str>,
        length: Option<Cow<'a, str>>,
    },
    StripShortestPrefix(Arc<BashPattern<'a>>),
    StripLongestPrefix(Arc<BashPattern<'a>>),
    StripShortestSuffix(Arc<BashPattern<'a>>),
    StripLongestSuffix(Arc<BashPattern<'a>>),
    ReplaceOnce {
        pattern: Arc<BashPattern<'a>>,
        string: Option<Arc<Text<'a>>>,
    },
    ReplaceAll {
        pattern: Arc<BashPattern<'a>>,
        string: Option<Arc<Text<'a>>>,
    },
    ReplacePrefix {
        pattern: Arc<BashPattern<'a>>,
        string: Option<Arc<Text<'a>>>,
    },
    ReplaceSuffix {
        pattern: Arc<BashPattern<'a>>,
        string: Option<Arc<Text<'a>>>,
    },
    UpperOnce(Arc<BashPattern<'a>>),
    UpperAll(Arc<BashPattern<'a>>),
    LowerOnce(Arc<BashPattern<'a>>),
    LowerAll(Arc<BashPattern<'a>>),
    ErrorOnUnset(Arc<Text<'a>>),
    Length,
    WhenUnset(Arc<Text<'a>>),
    WhenSet(Arc<Text<'a>>),
    ArrayElements,
    SingleWordElements,
}

A modifier in the braced variable expansion.

Variants

Substring

Reference to a substring (":offset" or ":offset:length").

The range is [offset, (offset+length)) (indexing from zero).

Fields

offset: Cow<'a, str>

Offset.

length: Option<Cow<'a, str>>

Length.

StripShortestPrefix(Arc<BashPattern<'a>>)

Stripping the shortest matching prefix ("#<pattern>").

StripLongestPrefix(Arc<BashPattern<'a>>)

Stripping the longest matching prefix ("##<pattern>").

StripShortestSuffix(Arc<BashPattern<'a>>)

Stripping the shortest matching suffix ("%<pattern>").

StripLongestSuffix(Arc<BashPattern<'a>>)

Stripping the longest matching suffix ("%%<pattern>").

ReplaceOnce

Replacing the first match of a pattern with a text ("/<pattern>[/<string>]").

string can be omitted, leaving "/<pattern>" structure, which removes the first match of the pattern.

Fields

pattern: Arc<BashPattern<'a>>

string: Option<Arc<Text<'a>>>

ReplaceAll

Replacing the all matches of a pattern with a text ("//<pattern>[/<string>]").

string can be omitted.

Fields

pattern: Arc<BashPattern<'a>>

string: Option<Arc<Text<'a>>>

ReplacePrefix

Replacing the prefix of a pattern with a text ("/#<pattern>[/<string>]").

string can be omitted.

Fields

pattern: Arc<BashPattern<'a>>

string: Option<Arc<Text<'a>>>

ReplaceSuffix

Replacing the suffix of a pattern with a text ("/%<pattern>[/<string>]").

string can be omitted.

Fields

pattern: Arc<BashPattern<'a>>

string: Option<Arc<Text<'a>>>

UpperOnce(Arc<BashPattern<'a>>)

Upper-casify the first match of a pattern ("^<pattern>").

UpperAll(Arc<BashPattern<'a>>)

Upper-casify the all matches of a pattern ("^^<pattern>").

LowerOnce(Arc<BashPattern<'a>>)

Lower-casify the first match of a pattern (",<pattern>").

LowerAll(Arc<BashPattern<'a>>)

Lower-casify the all matches of a pattern (",,<pattern>").

ErrorOnUnset(Arc<Text<'a>>)

Producing errors when the variable is unset or null (":?<text>").

Length

Returning the length of the variable.

Note that this modifier uses a special format, see BracedExpansion.

WhenUnset(Arc<Text<'a>>)

Returning a text when the variable is unset or null (":-<text>").

WhenSet(Arc<Text<'a>>)

Returning a text when the variable is set (":+<text>").

ArrayElements

Expands to array elements ("[@]").

SingleWordElements

Expands to a string of array elements concatenated with space ("[*]").

Trait Implementations

impl<'a> Clone for ExpansionModifier<'a>

fn clone(&self) -> ExpansionModifier<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for ExpansionModifier<'a>

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

Formats the value using the given formatter.

impl Display for ExpansionModifier<'_>

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

Formats the value using the given formatter.

impl<'a> Hash for ExpansionModifier<'a>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'a> PartialEq for ExpansionModifier<'a>

fn eq(&self, other: &ExpansionModifier<'a>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> Eq for ExpansionModifier<'a>

impl<'a> StructuralPartialEq for ExpansionModifier<'a>