Histórico da Página
Incluir Página | ||||
---|---|---|---|---|
|
Sintaxe
EMPTY( <expressão> )
Propósito
Determina se o resultado de uma expressão é vazia.
Argumentos
< expressão >
Define uma expressão, de qualquer tipo de dado, para ser verificada se está vazia.
Utilização
A função EMPTY() retorna verdadeiro (.T.) se a expressão, conteúdo de variável ou campo de arquivo de dados estiver vazia, de acordo com os critérios relacionados na tabela abaixo:
Tipo de Dado | Conteúdo vazio |
Matriz | Tamanho zero (sem elementos) |
Caracter | Apenas espaços em branco, tabulações ou NIL (“”) |
Numérico | 0 (zero) |
Data | CTOD(SPACE(8)), CTOD(“”) ou CTOD(“ / / “) |
Lógico | Falso (.F.) |
Memo | Idem ao caracter |
NIL | O próprio valor NIL |
A função EMPTY() pode ser utilizada em qualquer situação na qual seja necessário verificar se um determinado valor está vazio ou não. Por exemplo, se o usuário digitou uma informação, se um parâmetro foi passado, etc.
Exemplos
Neste exemplo, mostraremos o conteúdo de algumas variáveis e o resultado da função EMPTY() em cada uma destas situações.
cNome := “”
EMPTY(cNome) // Resulta verdadeiro (.T.). Ou seja, a variável está vazia.
cNome := “PROTHEUS 10”
EMPTY(cNome) // Resulta falso (.F.). Ou seja, a variável não está vazia.
cNome := “ ”
EMPTY(cNome) // Resulta verdadeiro (.T.). Ou seja, a variável está vazia.
nValor := 14000
EMPTY(nValor) // Resulta falso (.F.). Ou seja, a variável não está vazia.
nValor := 0
EMPTY(nValor) // Resulta verdadeiro (.T.). Ou seja, a variável está vazia.
nValor := -7
EMPTY(nValor) // Resulta falso (.F.). Ou seja, a variável não está vazia.