4D v18
New shared collection
- 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
New shared collection
| New shared collection {( value {; value2 ; ... ; valueN} )} -> Resultado | ||||||||
| Parâmetro | Tipo | Descrição | ||||||
| value |
|
Shared collection's value(s) | ||||||
| Resultado | Collection |
|
New shared collection | |||||
O comando New shared collection cria uma nova coleção compartida vazia ou preenchida e devolve sua referência. Agregar um elemento a esta coleção deve estar rodeado pela estrutura Use...End use, do contrário, se devolve um erro. Entretanto, é possível ler umelemento fora de uma estrutura Use...End use.
Nota: para saber mais sobre coleções compartidas, consulte a página Objetos compartidos e Coleções compartidas.
Se não passar nenhum parâmetro, New shared collection cria uma coleção compartida vazia e devolve sua refêrencia.
Deve assignar a referência deolvida a uma varável 4D declarada com o comando C_COLLECTION.
Nota: lembre que C_COLLECTION declara uma variável de tipo Collection, mas não cria uma coleção.
Opcionalmente, pode preencher previamente a nova coleção compartida passando um ou vários valores como parâmetro(s). Do contrário, pode agregar ou modificar elementos posteriormente através da assignação de notação de objeto (ver exemplo).
Se o índice de novo elemento for além do último elemento existente da coleção compartida, a coleção se redimensionará automaticamente e todos os novos elementos intermediarios obterão o valor null.
- Pode número (real, intero longo...). Os valores numéricos sempre são armazenados como reais.
- texto
- booleano
- data
- hora (armacenado como número de milissegundos - real)
- nulo
- objeto compartido(*)
- coleção compartida(*)
Nota: diferente das coleções padrão (não compartidas), as coleções compartidas não admitem imagens, ponteiros e objetos o u coleções que não são comparti9das.
(*)Quando um objeto compartido ou coleção se agrega a uma coleção compartida, compartem o mesmo identificador de bloqueio. Para saber mais sobre este ponto, consulte a seção Identificador de bloqueio (Locking identifier).
$mySharedCol:=New shared collection("alpha";"omega")
Use($mySharedCol)
$mySharedCol[1]:="beta"
End use
New collection
New shared object
Objetos compartidos e Coleções compartidas
Produto: 4D
Tema: Coleções
Número
1527
Criado por: 4D v16 R6
Manual de linguagem 4D ( 4D v18)
