Histórico da Página
| Composition Setup |
|---|
import.css=/download/attachments/3279126062824/newLayouttecnologia.css |
| Portuguese |
| Pagetitle | ||||
|---|---|---|---|---|
|
Função: Empty
Determina se o resultado de uma expressão é vazio.
Sintaxe
| Bloco de código | ||
|---|---|---|
| ||
Empty( <xExp> ) --> lRet xExp > )
|
Parâmetros
Nome | Tipo | Descrição | Obrigatório | Referência |
|---|---|---|---|---|
xExp |
...
qualquer | Indica uma expressão ou variável de qualquer tipo de dado. | X |
|
Retorno
Nome |
|---|
...
Tipo |
|---|
...
Descrição |
|---|
lRet |
...
lógico | Retorna verdadeiro (.T.), se a expressão resultar em um valor vazio; caso contrário, falso (.F.) |
...
Observações
...
Em builds anteriores ao Protheus, uma string tabém era considerada vazia mesmo se ela tivesse caracteres como "TAB" ( tabulação, ASCII 9 ) e/ou quebra de linha ( ASCII 13 + ASCII 10. No Protheus, a string somente é considerada vazia caso ela tenha comprimento vazio ( len() = 0 ) ou apenas espaços em branco ( ASCII 32 ) em seu conteúdo.
- Os critérios para determinar se o
...
- valor será considerado vazio, no parâmetro <lRet>, dependem do tipo de dado, no parâmetro <xExp>, e das regras de retorno,
...
- conforme a
...
- tabela Regras de retorno.
...
- Determinar se o usuário entrou com um valor em um objeto GET antes de enviar as alterações para um arquivo de banco de dados.
- Determinar se um parâmetro formal é Nil ou não foi informado.
- Testa um array para verificar se tem tamanho zero.
Regras de retorno
...
Tipo de dado | Conteúdo |
Array | Retorna verdadeiro caso o tamanho do array seja 0 (zero). |
Caractere | Retorna verdadeiro caso a string seja vazia ('') ou possua apenas um ou mais espaços em branco. |
Numérico | Retorna verdadeiro caso o número seja 0 (zero) |
Data | Retorna verdadeiro caso a data seja vazia |
...
Lógico | Retorna verdadeiro caso o parâmetro seja falso (.F.) |
Memo | Mesma regra do tipo Caractere. |
Nil | Sempre retorna verdadeiro ( .T. ) |
...
Bloco de |
...
código | Sempre retorna verdadeiro ( .T. ) |
- Essa função, pode ser utilizada para:
- Determinar se o usuário entrou com um valor em um objeto GET antes de enviar as alterações para um arquivo de banco de dados.
- Determinar se um parâmetro formal é Nil ou não foi informado.
- Testa um array para verificar se tem tamanho zero.
Exemplos
| Bloco de código | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
User Function Exemplo()
ObservaçãoEm builds anteriores ao Protheus, uma string tabém era considerada vazia mesmo se ela tivesse caracteres como "TAB" ( tabulação, ASCII 9 ) e/ou quebra de linha ( ASCII 13 + ASCII 10. No Protheus, a string somente é considerada vazia caso ela tenha comprimento vazio ( len() = 0 ) ou apenas espaços em branco ( ASCII 32 ) em seu conteúdo.
cValue := "AAA"Empty( cValue ) // Resultado: .F. cValue := "" Empty( cValue ) // Resultado: .T. Return |
Abrangência
Advanced Protheus 6.09 , Advanced Protheus 7.10 , Microsiga Protheus 8.11 , Protheus 10
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas