Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Incluir Página
tec:Empty
tec:Empty

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.