_ADVPL_InitToNull

Inicializa um ou todos os atributos de uma variável 4GL do tipo RECORD ou ARRAY OF RECORD.

Sintaxe

_ADVPL_initToNull( < uRec > , < cAttr > , < nRow > )

Parâmetros

Nome

Tipo

Obrigatório?

Descrição

uRec

RECORD

ou

ARRAY OF RECORD

Sim

Variável 4GL do tipo RECORD ou ARRAY OF RECORD onde será feita a inicialização de valores para NULL.

cAttr

CHAR

Não

Nome do elemento do RECORD 4GL que terá seu valor ajustado para NULL.

Para considerar todos os elementos do RECORD 4GL, informe NULL.

nRow

INTEGER

Não

Em caso de variável ARRAY OF RECORD, informe a linha que terá seu conteúdo inicializado para NULL.

Para considerar todas as linhas de um ARRAY OF RECORD 4GL, informe NULL ou informe apenas os primeiros 2 parâmetros.

Para variável do tipo RECORD, este parâmetro não deverá ser informado, ou seja, somente acione esta função informando os primeiros dois parâmetros.

Exemplo

DEFINE ma_dados ARRAY[3] OF RECORD
                            codigo SMALLINT,
                            texto  CHAR(10)
                            END RECORD

#----------------------------#
 FUNCTION initToNull_test()
#----------------------------#
  DEFINE l_index SMALLINT

  LET ma_dados[1].codigo = 49
  LET ma_dados[1].texto  = 'linha 01'

  LET ma_dados[2].codigo = 27
  LET ma_dados[2].texto  = 'linha 03'

  LET ma_dados[3].codigo = 5
  LET ma_dados[3].texto  = 'linha 02'     

  #Todos os elementos da linha 2 do array foram inicializados para NULL
  CALL _ADVPL_initToNull(ma_dados,NULL,2)

   #Todos as linhas do array tiveram o valor do elemento "texto" inicializado para NULL
   CALL _ADVPL_initToNull(ma_dados,"texto")
END FUNCTION

Informações

Fontes: funcoes_genericas.prw

Observações

Disponível a partir do pacote Logix 12.1.2403.

Páginas filhas