Aller au contenu principal
Version: Next

Null

Null : Null

ParamètreTypeDescription
RésultatNullValeur 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 4DCommentaire
Valeurs de propriétés d'objetsLa 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 collectionsLorsqu'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

Voir aussi

Is field value Null
OB SET NULL
SET FIELD VALUE NULL