collection.indexOf( )

4D v19.8


collection.indexOf ( aBuscar {; posicInic} ) -> Resultado

Parâmetro	Tipo	Descrição
aBuscar	Expression	elemento a pesquisar na coleção
posicInic	Inteiro longo	Número do elemento a partir do qual vai começar a pesquisa
Resultado	Inteiro longo	Número da primeira ocorrência de aBuscar na coleção, -1 se não encontrado

Descrição

O método collection.indexOf( ) busca a expressão aBuscar entre os elementos da coleção e devolve o número de elemento da primeira ocorrência encontrada, ou -1 se não for encontrado.

Nota: este método não modifica a coleção original.

Em aBuscar, passe a expressão a buscar na coleção. Pode passar:

um valor escalar (texto, número, booleano, data),
o valor null,
um objeto ou uma referência de coleção.

aBuscar deve coincidir exatamente com o elemento a buscar (são aplicadas as mesmas regras que para o operador de igualdade, ver Operadores de Comparação).

Opcionalmente, pode passar o número de elemento desde o qual iniciar a pesquisa em posicIni.

Se posicIni >= longitude da coleção, se devolve -1, o que significa que não se busca na coleção.
Se posicIni < 0, o fim da coleção se considera como ponto de inicio de cálculo da posição (posicIni :=posicIni +length).
Nota: mesmo se posicIni for negativo, a coleção continua sendo buscada de esquerda para direita.
Se posicIni = 0, se busca em toda a coleção (pré-determinado)

Exemplo

 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

Ver também

collection.lastIndexOf( )