4D v17.4
collection.indexOf( )
- 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.indexOf( )
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)
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
Produto: 4D
Tema: Coleções
Manual de linguagem 4D ( 4D v17)
Manual de linguagem 4D ( 4D v17.1)
Manual de linguagem 4D ( 4D v17.2)
Manual de linguagem 4D ( 4D v17.3)
Manual de linguagem 4D ( 4D v17.4)
