contains:【条件式】単語がリストに入っているかをテスト

contains は VALUES に
KEY が含まれているかをテストします。

含まれていれば正常終了し、
含まれていなければ異常終了します。

以下のオプションを受け付けます。

-i / --index

単語のインデックスを表示する。

注意:GNUツールのように contains は
引数 -- に到達するまで
- から始まるすべての引数を
contains のオプションと解釈します。

以下の例を参照してください。

if 、 and 、 or といった
条件式とともに使われます。

contains はオプションを付けないと
何も表示しませんので、
$status で確認しています。

# bはa b cに含まれる
$ contains b a b c; echo $status
0

# xはa b cに含まれない
$ contains x a b c; echo $status
1

# bはa b cの2番目の要素
$ contains -i b a b c
2

# xはa b cに含まれないので何も表示せずに異常終了
$ contains -i x a b c

以下のコードは、
~/bin と /usr/local/bin が
PATH に含まれているかをテストし、
入っていなければ PATH に加えます。

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

以下のコードは引数リスト $argv に
-q が含まれるかをテストしています。

そのとき、
検索キーと contains へのオプションとの
境界として -- 引数を使っています。

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