fish-shell/share/functions/__fish_nth_token.fish

function __fish_nth_token --description 'Prints the Nth token (ignoring command and switches/flags)' --argument-names n
    set -l tokens (commandline -po | string replace -r --filter '^([^-].*)' '$1')
    # Increment $n by one to account for ignoring the command
    if test (count $tokens) -ge (math "$n" + 1)
        echo $tokens[(math $n + 1)]
    else
        return 1
    end
end
Make __fish_is_nth_token and __fish_nth_token private again Their names are not perfect, so let's keep them as internal functions, until we figure out how/if we want to expose this. This reverts 0445126c2 (Undunder __fish_is_nth_token, 2021-06-29) (but I did it without "git revert"). Closes #8008 2022-02-09 08:46:07 +00:00			`function __fish_nth_token --description 'Prints the Nth token (ignoring command and switches/flags)' --argument-names n`
Add public function fish_nth_token to mirror fish_is_nth_token Completions may benefit from using these in tandem to dynamically generate completions predicated on the value of an earlier token in a cleaner fashion. (Currently, most of called completion helper functions introspect the command line to get the value of an earlier argument, making them less reusable for different expressions that need completions of the same type. This way, the completion can provide the function with the argument value explicitly.) 2022-02-07 19:16:02 +00:00			`set -l tokens (commandline -po \| string replace -r --filter '^([^-].*)' '$1')`
			`# Increment $n by one to account for ignoring the command`
			`if test (count $tokens) -ge (math "$n" + 1)`
			`echo $tokens[(math $n + 1)]`
			`else`
			`return 1`
			`end`
			`end`