Null
Null -> Résultat
| Paramètre | Type | Description | |
|---|---|---|---|
| Résultat | Null | 🡐 | Valeur Null |
Description
Null retourne la valeur null, de type Null.
Cette fonction vous permet d'affecter ou de comparer la valeur null aux élements du langage 4D suivants :
| Eléments du langage 4D | Commentaire |
|---|---|
| Valeurs de propriétés d'objets | La comparaison de Null avec une propriété d'objet vaut Vrai si la valeur de la propriété est null et Faux dans les autres cas. Par soucis de simplicité, comparer Null sera également Vrai si la propriété n'existe pas dans l'objet (i.e. est Undefined), voir exemple 4. |
| Eléments de collections | Lorsqu'une collection est étendue automatiquement par l'ajout d'éléments non adjacents, tous les éléments intermédiaires ajoutés prennent la valeur null par défaut. |
| Variables de type objet (C_OBJECT) | Voir (*) ci-dessous |
| Variables de type collection (C_COLLECTION) | Voir (*) ci-dessous |
| Variables de type pointeur (C_POINTER) | Voir (*) ci-dessous |
| Variables de type image (C_PICTURE) | (*) Affecter la valeur null à une variable de ce type efface son contenu. Cela a le même effet qu'appeler la commande CLEAR VARIABLE |
| variables variant (C_VARIANT) |
Note : Cette commande ne peut pas être utilisée avec les champs scalaires de la base de données. Les valeurs Null dans les champs de la base sont prises en charge par le moteur SQL, et sont gérés via les commandes Is field value Null et SET FIELD VALUE NULL,
Exemple 1
Exemples d'affectation et de test de la valeur null avec des propriétés d'objets :
var vEmp : Object
vEmp:=New object
vEmp.name:="Smith"
vEmp.children:=Null
If(vEmp.children=Null) //vrai
End if
If(vEmp.name=Null) //faux
End if
If(vEmp.parent=Null) //vrai
End if
Note : Cet exemple requiert que la notation objet soit activée dans la base.
Exemple 2
Exemple d'affectation et de test de la valeur null avec une collection d'éléments :
var myCol : Collection
myCol:=New collection(10;20;Null)
...
If(myCol[2]=Null)
// si le 3e élément est null
...
End if
Note : Cet exemple requiert que la notation objet soit activée dans la base.
Exemple 3
Ces exemples illustrent les diverses manières d'affecter ou de comparer la valeur null à des variables :
//Variable objet
var $o : Object
$o:=New object
$o:=Null //équivaut à EFFACER VARIABLE($o)
If($o#Null) //équivaut à If(OB Est defini($o))
End if
//Variable collection
var $c : Collection
$c:=New collection
$c:=Null //équivaut à EFFACER VARIABLE($c)
If($c#Null)
End if
//Variable pointeur
var $p : Pointer
$p:=->$v
$p:=Null //équivaut à EFFACER VARIABLE($p)
If($p=Null) //équivaut à If(Pointeur nil($p))
End if
//Variable image
var $i : Picture
$i:=$vpicture
$i:=Null //équivaut à EFFACER VARIABLE($i)
If($i#Null) //équivaut à If(Taille image($i)#0)
End if
Exemple 4
Cet exemple compare les différents résultats de la commande Undefined et de la commande Null appliquées aux propriétés d'objets, en fonction du contexte :
var vEmp : Object
vEmp:=New object
vEmp.name:="Smith"
vEmp.children:=Null
$undefined:=Undefined(vEmp.name) // Faux
$null:=(vEmp.name=Null) // Faux
$undefined:=Undefined(vEmp.children) // Faux
$null:=(vEmp.children=Null) // Vrai
$undefined:=Undefined(vEmp.parent) // Vrai
$null:=(vEmp.parent=Null) // Vrai