fish-shell/doc_src/contains.txt

\section contains contains - test if a word is present in a list

\subsection contains-synopsis Synopsis
\fish{synopsis}
contains [OPTIONS] KEY [VALUES...]
\endfish

\subsection contains-description Description

`contains` tests whether the set `VALUES` contains the string `KEY`. If so, `contains` exits with status 0; if not, it exits with status 1.

The following options are available:

- `-i` or `--index` print the word index

Note that, like GNU tools, `contains` interprets all arguments starting with a `-` as options to contains, until it reaches an argument that is `--` (two dashes). See the examples below.

\subsection contains-example Example

\fish
for i in ~/bin /usr/local/bin
    if not contains $i $PATH
        set PATH $PATH $i
    end
end
\endfish

The above code tests if `~/bin` and `/usr/local/bin` are in the path and adds them if not.

\fish
function hasargs
    if contains -- -q $argv
        echo '$argv contains a -q option'
    end
end
\endfish

The above code checks for `-q` in the argument list, using the `--` argument to demarcate options to `contains` from the key to search for.
Fix casing and other minor issues in documentation darcs-hash:20061031152316-ac50b-e68db9853d6e9461a0c054f1ea290704ccfc0a31.gz 2006-10-31 15:23:16 +00:00			`\section contains contains - test if a word is present in a list`
shellscript functions should use the help command to display help darcs-hash:20060126173437-ac50b-69c03761554180467f741a9597205fab6c823378.gz 2006-01-26 17:34:37 +00:00
			`\subsection contains-synopsis Synopsis`
Simplify styling 2014-08-01 12:25:41 +00:00			`\fish{synopsis}`
Documentation update Rework for Doxygen >1.8. Moved large parts of the documentation to a simplified format, making use of Markdown enhancements and fixing bad long options. 2014-08-01 02:37:32 +00:00			`contains [OPTIONS] KEY [VALUES...]`
			`\endfish`
shellscript functions should use the help command to display help darcs-hash:20060126173437-ac50b-69c03761554180467f741a9597205fab6c823378.gz 2006-01-26 17:34:37 +00:00
			`\subsection contains-description Description`

Make line length, wrapping and spacing consistent 2014-08-19 12:41:23 +00:00			`contains` tests whether the set `VALUES` contains the string `KEY`. If so, `contains` exits with status 0; if not, it exits with status 1.
shellscript functions should use the help command to display help darcs-hash:20060126173437-ac50b-69c03761554180467f741a9597205fab6c823378.gz 2006-01-26 17:34:37 +00:00
Help cleanup Large list of changes, including formatting and typos for most commands. More substantive changes have been made to alias, bind, block, break, builtin, case, cd, commandline, count, else, emit, fish_config, funced, function, functions, history, math, mimedb, nextd, not, popd, prevd, pushd, pwd, random, read, set, set_color, switch, test, trap, type, ulimit, umask, and while. 2013-05-12 07:56:01 +00:00			`The following options are available:`
shellscript functions should use the help command to display help darcs-hash:20060126173437-ac50b-69c03761554180467f741a9597205fab6c823378.gz 2006-01-26 17:34:37 +00:00
Documentation update Rework for Doxygen >1.8. Moved large parts of the documentation to a simplified format, making use of Markdown enhancements and fixing bad long options. 2014-08-01 02:37:32 +00:00			- `-i` or `--index` print the word index
shellscript functions should use the help command to display help darcs-hash:20060126173437-ac50b-69c03761554180467f741a9597205fab6c823378.gz 2006-01-26 17:34:37 +00:00
contains: add documentation regarding the use of `--` Closes #1194. [skip ci] 2014-10-26 11:01:22 +00:00			Note that, like GNU tools, `contains` interprets all arguments starting with a `-` as options to contains, until it reaches an argument that is `--` (two dashes). See the examples below.
Make line length, wrapping and spacing consistent 2014-08-19 12:41:23 +00:00
shellscript functions should use the help command to display help darcs-hash:20060126173437-ac50b-69c03761554180467f741a9597205fab6c823378.gz 2006-01-26 17:34:37 +00:00			`\subsection contains-example Example`
Documentation update Rework for Doxygen >1.8. Moved large parts of the documentation to a simplified format, making use of Markdown enhancements and fixing bad long options. 2014-08-01 02:37:32 +00:00
			`\fish`
shellscript functions should use the help command to display help darcs-hash:20060126173437-ac50b-69c03761554180467f741a9597205fab6c823378.gz 2006-01-26 17:34:37 +00:00			`for i in ~/bin /usr/local/bin`
Documentation update Rework for Doxygen >1.8. Moved large parts of the documentation to a simplified format, making use of Markdown enhancements and fixing bad long options. 2014-08-01 02:37:32 +00:00			`if not contains $i $PATH`
			`set PATH $PATH $i`
			`end`
shellscript functions should use the help command to display help darcs-hash:20060126173437-ac50b-69c03761554180467f741a9597205fab6c823378.gz 2006-01-26 17:34:37 +00:00			`end`
Documentation update Rework for Doxygen >1.8. Moved large parts of the documentation to a simplified format, making use of Markdown enhancements and fixing bad long options. 2014-08-01 02:37:32 +00:00			`\endfish`
shellscript functions should use the help command to display help darcs-hash:20060126173437-ac50b-69c03761554180467f741a9597205fab6c823378.gz 2006-01-26 17:34:37 +00:00
Documentation update Rework for Doxygen >1.8. Moved large parts of the documentation to a simplified format, making use of Markdown enhancements and fixing bad long options. 2014-08-01 02:37:32 +00:00			The above code tests if `~/bin` and `/usr/local/bin` are in the path and adds them if not.
contains: add documentation regarding the use of `--` Closes #1194. [skip ci] 2014-10-26 11:01:22 +00:00
			`\fish`
			`function hasargs`
			`if contains -- -q $argv`
			`echo '$argv contains a -q option'`
			`end`
			`end`
			`\endfish`

			The above code checks for `-q` in the argument list, using the `--` argument to demarcate options to `contains` from the key to search for.