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 |
Descrição
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).
Exemplo
$mySharedCol:=New shared collection("alpha";"omega")
Use($mySharedCol)
$mySharedCol[1]:="beta"
End use
Ver também
New collection
New shared object
Objetos compartidos e Coleções compartidas