CharacterCOpcional
Texto delimitado por aspas simples ou duplas.
FUNDAMENTOPublicado
Tipos de variáveis AdvPL
Local <variável> := <valor> · ValType(<variável>)Entenda como criar, nomear, inicializar e atribuir valores às variáveis AdvPL e como o tipo acompanha o conteúdo armazenado.
Visão geral
Uma variável é uma referência nomeada para um valor mantido em memória durante a execução. No AdvPL tradicional, o tipo é dinâmico: ele é determinado pelo valor atribuído e pode mudar durante a vida da variável. Isso é diferente do escopo, que controla visibilidade e duração, e da tipagem explícita com As <tipo>, que documenta e restringe o contrato esperado.
Sintaxe
Local <variável> := <valor> · ValType(<variável>)Parâmetros
NumericNOpcional
Número inteiro ou decimal armazenado em ponto flutuante.
DateDOpcional
Data criada por funções como Date(), CToD() ou SToD().
LogicalLOpcional
Valor verdadeiro (.T.) ou falso (.F.).
ArrayAOpcional
Coleção indexada, iniciada na posição 1, que pode reunir valores de tipos diferentes.
CodeBlockBOpcional
Bloco de expressões executável posteriormente com funções como Eval().
ObjectOOpcional
Instância de uma classe.
NILUOpcional
Ausência de valor; é o estado inicial usual de uma variável declarada sem inicialização.
Declaração e inicialização
User Function ExVariaveis()
Local cProduto := "Teclado"
Local nQuantidade := 2
Local nPreco := 150.50
Local lDisponivel := .T.
Local dCadastro := Date()
If lDisponivel
MsgInfo(cProduto + " - total: " + ;
CValToChar(nQuantidade * nPreco))
EndIf
ReturnResultado esperado
Cada variável recebe um valor inicial compatível com a intenção indicada pelo prefixo.
NIL antes da inicialização
User Function ExNil()
Local nPercentual
Local nResultado
If ValType(nPercentual) == "U"
nPercentual := 10
EndIf
nResultado := 250 * (1 + nPercentual / 100)
MsgInfo("Resultado: " + CValToChar(nResultado))
ReturnResultado esperado
ValType() retorna U enquanto a variável está sem valor. A inicialização evita utilizar NIL no cálculo.
Mudança dinâmica de tipo
User Function ExTipoDinamico()
Local xValor := "Pedido aberto"
ConOut("Tipo atual: " + ValType(xValor)) // C
xValor := 22
ConOut("Tipo atual: " + ValType(xValor)) // N
xValor := .T.
ConOut("Tipo atual: " + ValType(xValor)) // L
xValor := Date()
ConOut("Tipo atual: " + ValType(xValor)) // D
ReturnResultado esperado
A mesma variável assume tipos diferentes. A flexibilidade existe, mas deve ser usada com intenção explícita.
Conversão antes da concatenação
User Function ExConversao()
Local nQuantidade := 3
Local dHoje := Date()
Local lAtivo := .T.
ConOut("Quantidade: " + CValToChar(nQuantidade))
ConOut("Data: " + DToC(dHoje))
ConOut("Ativo: " + IIf(lAtivo, "sim", "não"))
ReturnResultado esperado
Cada conteúdo é convertido para caractere antes de ser unido ao texto.
Atribuição implícita que deve ser evitada
User Function ExErroDigitacao()
Local nQuantidade := 10
nQuantidad := 20 // nome incorreto: pode criar uma Private
MsgInfo("Quantidade: " + CValToChar(nQuantidade))
ReturnResultado esperado
A ausência da letra e pode criar outro identificador em vez de atualizar nQuantidade. A declaração explícita reduz esse risco.
- Declare e inicialize a variável na mesma instrução sempre que houver um valor inicial claro: Local nPercentual := 10.
- Prefira o operador := para atribuição. Ele diferencia visualmente a atribuição das comparações feitas com = ou ==.
- ValType(xValor) retorna uma letra que identifica o tipo atual. Como a tipagem é dinâmica, a resposta pode mudar depois de uma nova atribuição.
- Use prefixos coerentes como c, n, d, l, a, b, o e x para comunicar a intenção. O prefixo x é apropriado somente quando diferentes tipos fazem parte do desenho.
- A documentação consultada registra que somente os dez primeiros caracteres identificariam variáveis de memória. Trate essa regra como compatibilidade histórica e valide o comportamento na versão de AppServer utilizada antes de basear um projeto nela.
- Separe os conceitos: tipo descreve o valor; escopo define onde a variável é visível; tempo de vida define até quando ela existe.
- Declarar sem inicializar produz NIL. Usar NIL diretamente em cálculo ou concatenação pode provocar type mismatch.
- Atribuir um valor a um nome ainda não declarado pode criar implicitamente uma variável Private. Um erro de digitação pode, portanto, alterar a lógica sem o erro esperado.
- Mudar livremente o tipo de uma variável reduz a previsibilidade. Faça isso somente quando for intencional e valide com ValType() antes de operar.
- Não concatene números, datas, lógicos ou NIL diretamente com texto. Converta conscientemente com CValToChar(), DToC() ou outra função adequada.
- Não utilize palavra reservada, espaço ou caractere especial em identificadores. Comece o nome por letra ou sublinhado e utilize letras, números e sublinhado no restante.
- Store é mantido por compatibilidade histórica. Para código novo, prefira declaração explícita e atribuição com :=.