aDestinoArrayObrigatório
Array a redimensionar.
FUNçãOEm revisão
ASize
ASize( <aDestino>, <nTamanho> ) --> NilRedimensiona o array existente.
Visão geral
ASize altera a quantidade de elementos. Reduzir o tamanho descarta posições finais e seus conteúdos; aumentar não cria registros de negócio completos. A ficha consultada declara retorno Nil, portanto o exemplo chama a função como instrução e mantém o array na variável original. Não confundir quantidade de posições com o último índice válido após reduzir. (TOTVS, s.d., ref. 1)
Sintaxe
ASize( <aDestino>, <nTamanho> ) --> NilParâmetros
nTamanhoNuméricoObrigatório
Novo tamanho.
Retorno
Nil conforme a ficha consultada. O efeito ocorre no array recebido.
Exemplo comentado
#Include "Protheus.ch"
User Function EdAsize()
Local aItens := {10, 20, 30}
// Nao atribuir o retorno de ASize a aItens.
ASize(aItens, 2)
ConOut(cValToChar(Len(aItens)))
ConOut(cValToChar(aItens[2]))
Return NilResultado esperado
Resultados esperados: 2 e 20. O elemento 30 foi descartado. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
- Validar tamanho inteiro não negativo. Copiar com AClone antes de uma redução quando for necessário preservar a estrutura original.
- Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.