ListFind

リスト内の要素を検索します。

Synopsis

ListFind(list,value[,startafter])

引数

list	有効なリストとして評価される式。Caché list は、ListBuild、または ListFromString を使用して作成するか、List を使用して別のリストから抽出する必要があります。
value	検索の対象となる要素の値として評価される式。
startafter	オプション — リスト位置として翻訳される式。この位置の後の要素から検索が開始されます。

概要

ListFind 関数は、指定された list で、要求された value の最初のインスタンスを検索します。startafter 引数で指定された位置の次の要素から検索を開始します。startafter 引数を省略すると、ListFind は startafter 値を 0 と見なし、先頭要素から検索を開始します。値が見つかると、ListFind は一致する要素の位置を返します。値が見つからなければ、ListFind はゼロ (0) を返します。startafter 引数の値が、存在しないリスト・メンバを参照している場合も 0 が返されます。

ListFind 関数は、完全な要素のみを検出します。したがって、以下の例ではすべての要素に "B" が含まれているものの、リスト要素が文字列 "B" とは同じではないため、0 が返されます。

mylist = ListBuild("ABC","BCD","BBB")
Println ListFind(mylist,"B")

例

以下の例は ListFind 関数の使用法を示しています。

myList = ListBuild("Red", "Blue", "Green", "Yellow","Green")
Println ListFind(myList,"Green")   ' prints 3
Println ListFind(myList,"Green",3) ' prints 5
Println ListFind(myList,"Red")     ' prints 1
Println ListFind(myList,"Red",1)   ' prints 0 (not found)

ListFind

Synopsis

引数

概要

例

関連項目