STRING_isEmpty

Avalia se um conteúdo qualquer, que automaticamente é convertido pra CHAR no envio como parâmetro para esta função, está apenas com espaços em branco ou está com valor NULL.

Fazendo uso desta função se torna desnecessário realizar testes com condições como::

       IF <var> = " " OR <var> IS NULL THEN

Sintaxe

STRING_isEmpty( < l_value > ) => SMALLINT

Parâmetros

Nome

Tipo

Obrigatório?

Descrição

l_value

CHAR

Sim

Conteúdo qualquer que é convertido para tipo CHAR na função, para avaliar se o seu conteúdo possui algum conteúdo diferente de espaços em branco ou NULL.

Limite atual de 10.000 caracteres.

Retorno

Tipo

Descrição

SMALLINT

Indica se o conteúdo de L_VALUE está vazio ou não.

TRUE - Conteúdo vazio.

FALSE - Conteúdo não está vazio.

Exemplo

#---------------------------------------#
 FUNCTION STRING_isEmpty_test()
#---------------------------------------#
  DEFINE l_conteudo VARCHAR(1000)

  LET l_conteudo = NULL

  #Avaliar se L_CONTEUDO está vazio
  IF STRING_isEmpty(l_conteudo) THEN
     CALL conout("Conteudo 1 está vazio.")
  ELSE
      CALL conout("Conteudo 1 NÃO está vazio.")
  END IF

  LET l_conteudo = 'conteúdo preenchido'

  #Avaliar se L_CONTEUDO está vazio
  IF STRING_isEmpty(l_conteudo) THEN
     CALL conout("Conteudo 2 está vazio.")
  ELSE
      CALL conout("Conteudo 2 NÃO está vazio.")
  END IF


 END FUNCTION

Informações

Fontes: string.4gl

Disponível a partir do pacote Logix 12.1.27.

Veja também

4GL - Expressão IS NULL

Páginas filhas