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
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ção | Sintaxe | Retorna | Expression | Valor |
---|---|---|---|---|
Igual | Null = Null | Parâmetros | a.nullProp = b.nullProp | True |
Null = Undefined | Parâmetros | a.nullProp = b.undefinedProp | True | |
Null = scalar value | Parâmetros | a.nullProp = 42 | False | |
Desigualdade | Null # Null | Parâmetros | a.nullProp # b.nullProp | False |
Null # Undefined | Parâmetros | a.nullProp # b.undefinedProp | False | |
Null # scalar value | Parâmetros | a.nullProp # 42 | True |
*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 = ""
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ção | Sintaxe | Retorna | Expression | Valor |
---|---|---|---|---|
Igual | Undefined = Undefined | Parâmetros | a.undefinedProp = b.undefinedProp | True |
Undefined = Null | Parâmetros | a.undefinedProp = c.nullProp | True | |
Undefined = outros valores | Parâmetros | a.undefinedProp = 42 | False | |
Desigualdade | Undefined # Undefined | Parâmetros | a.undefinedProp # b.undefinedProp | False |
Undefined # Null | Parâmetros | a.undefinedProp # b.nullProp | False | |
Undefined # outros valores | Parâmetros | a.undefinedProp # 42 | True | |
Maior que | Undefined > string, Date, Time, Boolean, number | Parâmetros | a.undefinedProp > "abc" | False |
Menor que | Undefined < string, Date, Time, Boolean, number | Parâmetros | a.undefinedProp < "abc" | False |
Maior ou igual a | Undefined >= string, Date, Time, Boolean, number | Parâmetros | a.undefinedProp >= "abc" | False |
Menor que ou igual a | Undefined <= string, Date, Time, Boolean, number | Parâmetros | a.undefinedProp <= "abc" | False |
*outros valores são expressões de qualquer tipo com um valor nem Indefinido nem Null.
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