Linha Logix

Páginas filhas
  • _ADVPL_InitToValue


Atribui um conteúdo para um ou todos os atributos de uma variável 4GL do tipo RECORD ou ARRAY OF RECORD.

Sintaxe

_ADVPL_initToValue( < uRec > , < cAttr > , < uValue >, < nStart >, < nEnd > )

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.

(seleção) Para considerar todos os elementos do RECORD 4GL, informe NULL.

uValue

ANY

Sim

Valor que será atribuido para um ou todos elementos do RECORD 4GL.

(aviso) ATENÇÃO! Quando informar o parâmetro cAttr para considerar TODOS os atributos (cAttr = NULL), o valor a ser informado aqui deverá respeitar o tipo de dado para todos os atributos do RECORD 4GL. O valor NULL é válido para qualquer tipo de dado entre os elementos de um RECORD 4GL.

nStart

INTEGER

Não

Em caso de variável ARRAY OF RECORD, informe a linha inicial que terá seu conteúdo inicializado. Quando não informado, considera automaticamente como linha 1.

(seleção) Para considerar todas as linhas de um ARRAY OF RECORD 4GL, informe NULL ou informe apenas os primeiros 3 parâmetros.

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

nEnd

INTEGER

Não

Em caso de variável ARRAY OF RECORD, informe a linha final que terá seu conteúdo inicializado. Quando não informado, considera automaticamente como a última linha do array.

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

Exemplo

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

#----------------------------#
 FUNCTION initToValue_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_initToValue(ma_dados,NULL,2)

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

  #As linhas do array 1 até a 2 tiveram o valor do elemento "texto" inicializado para "INICIAL"
  CALL _ADVPL_initToNull(ma_dados,"texto","INICIAL",1,2)
END FUNCTION

Informações

Fontes: funcoes_genericas.prw


Observações

Disponível a partir do pacote Logix 12.1.2403.