share/functions/__fish_nth_token.fish

# localization: skip(private)
function __fish_nth_token --description 'Prints the Nth token (ignoring command and switches/flags)' --argument-names n
    set -l tokens (commandline -px | 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
Mark private functions that don't need localization See the next commit. Part of #11833 2025-09-29 09:30:35 +02:00			`# localization: skip(private)`
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 09:46:07 +01:00			`function __fish_nth_token --description 'Prints the Nth token (ignoring command and switches/flags)' --argument-names n`
completion: adopt commandline -x replacing deprecated -o This gives us more accurate completions because completion scripts get expanded paths 2024-01-22 07:42:45 +01:00			`set -l tokens (commandline -px \| string replace -r --filter '^([^-].*)' '$1')`
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 13:16:02 -06:00			`# 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`