Saltar para o conteúdo principal
Versão: 20 R6 BETA

Null e indefinido

Nulo e Indefinido são tipos de dados que tratam de casos em que o valor de uma expressão não é conhecido.

Null

Null é um tipo de dados especial com apenas um valor possível: null. Este valor é devolvido por uma expressão que não contém nenhum valor. Tentar ler uma propriedade de um valor null retorna um erro.

Na linguagem 4D e para atributos do campo objeto, valores nulos são gerenciados através da função Null. Esta função pode ser usada com as expressões abaixo para definir ou comparar o valor nulo:

  • atributos de objetos
  • elementos da coleção
  • variáveis do tipo objeto, coleção, ponteiro, imagem ou variante (consulte também [Null as default value] (data-types.md#null-as-default-value).

Indefinido

Indefinido não é realmente um tipo de dados. Denota uma variável que ainda não foi definida. Evaluating an object property can also produce an undefined value. Lendo uma propriedade de um valor indefinido retorna indefinido.

Uma variável variante tem undefined como valor padrão.

Um campo não pode ser indefinido (o comando Undefined sempre retorna False para um campo).

Typically when trying to read or assign undefined expressions, 4D will generate errors, except in the following cases:

  • Atribuindo um valor indefinido para variáveis (exceto arrays) tem o mesmo efeito que chamar CLEAR VARIABLE com eles:
     C_OBJECT($o)
C_LONGINT($val)
$val:=10 //$val=10
$val:=$o. //$o.a é indefinido (sem erro), e atribuir este valor limpa a variável
//$val=0
  • A atribuição de um valor indefinido a um objecto existente reinicia ou limpa o seu valor, dependendo do seu tipo:
    • Objecto, colecção, ponteiro: Null
    • Imagem: Imagem vazia
    • Booleano: Falso
    • String: ""
    • Número: 0
    • Data: !00-00-00-00! se a configuração "Usar tipo de data em vez de formato de data ISO nos objetos" estiver habilitada, caso contrário ""
    • Hora: 0 (número de ms)
    • Indefinido, Null: sem mudança
     C_OBJECT($o)
$o:=New object("a";2)
$o.a:=$o.b //$o.a=0
  • Atribuir um valor indefinido a uma propriedade objecto não existente não faz nada.

  • Um valor indefinido passado como parâmetro para um método de projecto é automaticamente convertido em 0 ou "" de acordo com o tipo de parâmetro declarado.

     C_OBJECT($o)
meumétodo($o. ) //passa um parâmetro indefinido

//In mymethod
C_TEXT($1) //parameter type é texto
// $1 contém ""
  • Uma expressão de condição é automaticamente convertida em falsa quando se avalia para indefinida com as palavras-chave If e Case:
     C_OBJECT($o)
If($o.a) // false
End if
Case of
:($o.a) // false
End case
tip

Quando expressões de um determinado tipo são esperadas em seu código 4D, você pode garantir que elas tenham o tipo correto, mesmo quando avaliadas como indefinidas, cercando-as com o comando 4D cast apropriado: String, Num, Date, Time, Bool. Estes comandos devolvem um valor vazio de tipo especificado quando a expressão é avaliada como indefinida. Por exemplo:

 $myString:=Caixa minúscula(String($o.a.b))) // certifique-se de obter um valor de string mesmo que não esteja definido
// para evitar erros no código

Operadores Null

OperaçãoSintaxeRetornaExpressionValor
IgualNull = NullParâmetrosa.nullProp = b.nullPropTrue
Null = UndefinedParâmetrosa.nullProp = b.undefinedPropTrue
Null = scalar valueParâmetrosa.nullProp = 42False
DesigualdadeNull # NullParâmetrosa.nullProp # b.nullPropFalse
Null # UndefinedParâmetrosa.nullProp # b.undefinedPropFalse
Null # scalar valueParâmetrosa.nullProp # 42True

*Os valores escalares são valores do tipo string, Date, Time, Boolean, number, ou Blob. Quando declarado, seu [valor padrão] (data-types.md#default-values) não é indefinido nem nulo. Outros tipos (Ponteiro, Imagem, Objecto, Colecção) têm valor por defeito indefinido ou nulo. Ex:

var $object : Object
var $text : Text

//$object = null
//$text = ""
info

As comparações com os operadores Maior que (>), Menor que (<), Greater than or equal to (>=) e Menor que ou igual a (<=) não são compatíveis com valores nulos e retornam um erro.

Operadores indefinidos

OperaçãoSintaxeRetornaExpressionValor
IgualUndefined = UndefinedParâmetrosa.undefinedProp = b.undefinedPropTrue
Undefined = NullParâmetrosa.undefinedProp = c.nullPropTrue
Undefined = outros valoresParâmetrosa.undefinedProp = 42False
DesigualdadeUndefined # UndefinedParâmetrosa.undefinedProp # b.undefinedPropFalse
Undefined # NullParâmetrosa.undefinedProp # b.nullPropFalse
Undefined # outros valoresParâmetrosa.undefinedProp # 42True
Maior queUndefined > string, Date, Time, Boolean, numberParâmetrosa.undefinedProp > "abc"False
Menor queUndefined < string, Date, Time, Boolean, numberParâmetrosa.undefinedProp < "abc"False
Maior ou igual aUndefined >= string, Date, Time, Boolean, numberParâmetrosa.undefinedProp >= "abc"False
Menor que ou igual aUndefined <= string, Date, Time, Boolean, numberParâmetrosa.undefinedProp <= "abc"False

*outros valores são expressões de qualquer tipo com um valor nem Indefinido nem Null.

info

As comparações de valores indefinidos com valores de ponteiro, imagem, blob, objeto, coleção, indefinidos ou nulos usando os operadores maior que (>), menor que (<), Greater than or equal to (>=) e menor ou igual a (<=) não são suportadas e retornam um erro.

Exemplos

Aqui estão os diferentes resultados do comando Undefined e do comando Null com propriedades de objeto, dependendo do contexto:

var $vEmp : Object
var $result : Boolean
$vEmp:=New object
$vEmp.name:="Smith"

$vEmp.children:=Null

$result:=Undefined($vEmp.name) //False
$result:=($vEmp.name=Null) //False

$result:=Undefined($vEmp.children) //False
$result:=($vEmp.children=Null) //True

$result:=Undefined($vEmp.parent) //True
$result:=($vEmp.parent=Null) //True

Exemplos de resultados de comparação com valores indefinidos e nulos:

var $result : Boolean
var $vObj : Object
var $vVar : Variant

$vObj:=New object
$vObj.null:=Null
//note that $vVar is not assigned

$result:=($vObj.undefined=42) //False
$result:=($vObj.undefined=$vObj.null) //True
$result:=($vObj.undefined=$vVar) //True

$result:=($vObj.undefined#$vObj.null) //False
$result:=($vObj.undefined#42) //True
$result:=($vObj.undefined#$vVar) //False

$result:=($vObj.undefined>"hello") //False
$result:=($vObj.undefined>$vVar) //Error
$result:=($vObj.undefined>$vObj.null) //Error
$result:=($vVar < 42) //False