Este é o site histórico da documentação 4D. As documentações estão sendo movidas progressivamente para developer.4d.com |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v19.8
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.
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 v19)
Manual de linguagem 4D ( 4D v19.1)
Manual de linguagem 4D ( 4D v19.4)
Manual de linguagem 4D ( 4D v19.5)
Manual de linguagem 4D ( 4D v19.6)
Manual de linguagem 4D ( 4D v19.7)
Manual de linguagem 4D ( 4D v19.8)