4D v17.4
collection.sort( )
- 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.sort( )
O método collection.sort( ) ordena os elementos da coleção e devolve uma nova coleção ordenada. Este método devolve uma cópia superficial, o que significa que os objetos ou coleções em ambas coleções compartem a mesma referência.
Nota: este método modifica a coleção original.
Se for chamada a collection.sort( ) sem parâmetros, só são classificados os valores escalares (número, texto, data, booleanos). Os elementos são ordenados como padrão em ordem ascendente, de acordo com seu tipo.
Se quiser ordenar os elementos da coleção em outra ordem ou ordenar qualquer tipo de elemento, deve oferecer em nomMet um método de comparação que compare dois valores e devolva true em $1.result se o primeiro valor for menor que o segundo valor. Pode oferecer parâmetros adicionais a nomMet se for necessário.
- nomMet receberá os parâmetros abaixo:
- $1 (objeto), onde:
- $1.value (todo tipo): valor do primeiro elemento a ser comparado
- $1.value2 (todo tipo): valor do segundo elemento a ser comparado
- $2...$N (todo tipo): parâmetros adicionais
- $1 (objeto), onde:
- nomMet define o parâmetro abaixo:
- $1.result (booleano): true se $1.value < $1.value2, do contrário false
Se a coleção contiver elementos de diferentes tipos, primeiro são agrupados por tipo e são ordenados depois. Os tipos são devolvidos na ordem abaixo:
- null
- booleanos
- strings
- números
- objetos
- coleções
- datas
C_COLLECTION($col)
$col:=New collection("Tom";5;"Mary";3;"Henry";1;"Jane";4;"Artie";6;"Chip";2)
$col2:=$col.sort() // $col2=["Artie","Chip","Henry","Jane","Mary","Tom",1,2,3,4,5,6]
// $col=["Artie","Chip","Henry","Jane","Mary","Tom",1,2,3,4,5,6] C_COLLECTION($col)
$col:=New collection(10;20)
$col2:=$col.push(5;3;1;4;6;2).sort() //$col2=[1,2,3,4,5,6,10,20] C_COLLECTION($col)
$col:=New collection(33;4;66;1111;222)
$col2:=$col.sort() //ordem numérica: [4,33,66,222,1111]
$col3:=$col.sort("numberOrder") //ordem alfabética: [1111,222,33,4,66] //Método projeto numberOrder
C_OBJECT($1)
$1.result:=String($1.value)<String($1.value2)
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)
