4D v19
collection.findIndex( )
- Manual de linguagem 4D
-
- Coleções
-
- Sobre coleções
- Conversões de Tipo entre coleções e arrays 4D
- collection.length
- collection.push( )
- collection.insert( )
- collection.countValues( )
- collection.remove( )
- collection.clear( )
- collection.sort( )
- collection.sum( )
- collection.average( )
- collection.pop( )
- collection.indexOf( )
- collection.find( )
- collection.filter( )
- collection.count( )
- collection.min( )
- collection.max( )
- collection.copy( )
- collection.query( )
- collection.shift( )
- collection.unshift( )
- collection.join( )
- collection.orderBy( )
- collection.orderByMethod( )
- collection.extract( )
- collection.indices( )
- collection.concat( )
- collection.combine( )
- collection.reverse( )
- collection.map( )
- collection.every( )
- collection.some( )
- collection.findIndex( )
- collection.lastIndexOf( )
- collection.resize( )
- collection.fill( )
- collection.slice( )
- collection.distinct( )
- collection.equal( )
- collection.reduce( )
- ARRAY TO COLLECTION
- COLLECTION TO ARRAY
- New collection
- New shared collection
collection.findIndex( )
O método collection.findIndex( ) devolve o índice, na coleção, do primeiro valor para o qual nomMet, aplicado em cada elemento, devolve true. O método devolve -1 se nenhum elemento da coleção for avaliado como true.
Nota: este método não modifica a coleção original.
De forma pré-determinada, collection.findIndex( ) busca em toda a coleção. Opcionalmente, pode passar em posicIni o índice do elemento desde o qual começar a pesquisa.
- Se posicIni >= longitude da coleção, se devolve Undefined, o que significa que não se realiza a pesquisa.
- Se posicIni < 0, o fim da coleção se considera como o ponto de início de cálculo da posição (posicIni :=posicIni +length).
Nota: mesmo se posicIni for negativo, a coleção continua buscando de esquerda para direita. - Se posicIni = 0, se busca em toda a coleção (como padrão).
Em nomMet, passe o nome de método a usar para avaliar os elementos da coleção, junto com seus parâmetros em param (opcional). nomMet pode realizar qualquer prova, usando ou não os parâmetros. Este método recebe um parâmetro Object em $1 e deve estabelecer $1.result como true para o primeiro elemento que cumpra a condição.
nomMet recebe os parâmetros abaixo:
- em $1.value: valor do elemento a avaliar
- em $2: param
- em $N...: param2...paramN
nomMet define os parâmetros abaixo:
- $1.result (booleano): true se o valor do elemento coincidir com a condição de pesquisa.
- $1.stop (booleano, opcional): true para deter a retrochamada do método. O valor devolvido é o último calculado.
Se quiser encontrar a posição do primeiro nome da cidade dentro de uma coleção:
C_COLLECTION($c)
C_LONGINT($val2;$val3)
$c:=New collection
$c.push(New object("name";"Cleveland";"zc";35049))
$c.push(New object("name";"Blountsville";"zc";35031))
$c.push(New object("name";"Adger";"zc";35006))
$c.push(New object("name";"Clanton";"zc";35046))
$c.push(New object("name";"Clanton";"zc";35045))
$val2:=$c.findIndex("FindCity";"Clanton") // $val2=3
$val3:=$c.findIndex($val2+1;"FindCity";"Clanton") //$val3=4O código para o método é FindCity:
C_OBJECT($1)
C_TEXT($2)
$1.result:=$1.value.name=$2
Produto: 4D
Tema: Coleções
Manual de linguagem 4D ( 4D v19)
Manual de linguagem 4D ( 4D v19.1)
