Enum SortBy 

pub enum SortBy {
    Name,
    Size,
    Modified,
    Extension,
}

Which property the listing is ordered by.

Parsed from [navigation] sort_by, :sort <key> and :set sort_by <key>; spelled back with SortBy::as_str so the config, the command and the status-bar notice all use one vocabulary.

Variants

Name

File name, case-insensitive. The default, and Trail’s only order before v1.8.0.

Size

Size in bytes, largest first.

Modified

Modification time, most recent first.

Extension

File extension, case-insensitive, then name.

Implementations

impl SortBy

pub fn parse(value: &str) -> Option<Self>

Parses the spelling used in config and commands, or None if it names no known key.

Case-insensitive, and time is accepted as an alias for modified because that is what the st binding is named after.

pub fn as_str(self) -> &'static str

The canonical spelling of this key, as [navigation] sort_by takes it.

pub fn short_label(self) -> &'static str

A short spelling for the navigation panel’s sort badge.

Four characters at most, because the badge shares the panel’s top border with the directory name.

pub fn descends_by_default(self) -> bool

Whether this key reads best from its high end down.

Size and time do: you went looking for the biggest or the newest, so that end belongs at the top, which is what ls -S and ls -t do. Name and extension run A–Z.

This is the single definition of the natural direction — sort_entries orders by it and the badge reports it, so the two cannot come to disagree about which way a listing runs.

Trait Implementations

impl Clone for SortBy

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 SortBy

impl Debug for SortBy

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

Formats the value using the given formatter.

impl Default for SortBy

fn default() -> Self

Returns the “default value” for a type.

impl Eq for SortBy

impl PartialEq for SortBy

fn eq(&self, other: &Self) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SortBy