4D v19

collection.indexOf( )

ホーム

 
4D v19
collection.indexOf( )

collection.indexOf( )  


 

説明  

collection.indexOf( ) ファンクションはtoSearch 引数で指定した式をコレクション要素の中から検索し、最初に見つかったオカレンスのインデックスを返します(見つからなかった場合には-1 を返します)。

注: このコマンドは元のコレクションを変更しません。

toSearch 引数には、コレクション内で検索する式を渡します。以下のものを渡すことができます:

  • スカラー値(テキスト、数値、ブール、日付)
  • null 値
  • オブジェクトあるいはコレクション参照

toSearch 引数は検索したい要素と完全に一致している必要があります(等号演算子と同じルールが適用されます。比較演算子参照)。

オプションとして、startFrom 引数を渡すことで検索を開始したいコレクションのインデックスを指定することができます。

  • startFrom がコレクションのlength より大きい場合、-1 が返されます。これはコレクションが検索されなかったことを意味します。
  • startFrom が負の値である場合、それはコレクションの終端からのオフセットであるとみなされます(startFrom:=startFrom+length)。
    注: startFrom が負の値であっても、コレクションは左から右へと検索されます。
  • startFrom が0 であった場合、コレクション全体が検索されます(デフォルト)

例題  

 C_COLLECTION($col)
 $col:=New collection(1;2;"Henry";5;3;"Albert";6;4;"Alan";5)
 $i:=$col.indexOf(3) //$i=4
 $i:=$col.indexOf(5;5) //$i=9
 $i:=$col.indexOf("al@") //$i=5
 $i:=$col.indexOf("Hello") //$i=-1



参照 

collection.lastIndexOf( )

 
プロパティ 

プロダクト: 4D
テーマ: コレクション

This command can be run in preemptive processes

 
ページの目次 
 
履歴 

 
ARTICLE USAGE

ランゲージリファレンス ( 4D v19)
ランゲージリファレンス ( 4D v19.1)