Article
03/31/2012

Fonction empty (XQuery)

Renvoie la valeur True si la valeur de $arg est une séquence vide. Sinon, cette fonction renvoie la valeur False.

Syntaxe

fn:empty($arg as item()*) as xs:boolean

Argument

$arg
Séquence d'éléments. Si la séquence est vide, la fonction renvoie la valeur True. Sinon, cette fonction renvoie la valeur False.

Notes

La fonction fn:exists() n'est pas prise en charge. Vous pouvez utiliser la fonction not() comme alternative.

Exemples

Cette rubrique propose des exemples de XQuery relatifs à des instances XML stockés dans différentes colonnes de type xml tirées de la base de données AdventureWorks2008R2. Pour obtenir une vue d'ensemble de chacune de ces colonnes, consultez Représentation du type de données xml dans la base de données AdventureWorks2008R2.

A. Utilisation de la fonction XQuery empty() pour déterminer la présence d'un attribut

Dans le processus de fabrication du modèle de produit 7, cette requête renvoie tous les postes de travail sans attribut MachineHours.

SELECT ProductModelID, Instructions.query('
declare namespace AWMI="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
     for $i in /AWMI:root/AWMI:Location[empty(@MachineHours)]
     return
       <Location
            LocationID="{ ($i/@LocationID) }"
            LaborHrs="{ ($i/@LaborHours) }" >
            { 
              $i/@MachineHours
            }  
       </Location>
') as Result
FROM Production.ProductModel
where ProductModelID=7;

Voici le résultat obtenu :

ProductModelID Result

-------------- ------------------------------------------

7 <Location LocationID="30" LaborHrs="1"/>

La requête suivante, légèrement modifiée, renvoie « NotFound » en cas d'absence de l'attribut MachineHours :

SELECT ProductModelID, Instructions.query('
declare namespace p14="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelManuInstructions";
     for $i in /p14:root/p14:Location
     return
       <Location
            LocationID="{ ($i/@LocationID) }"
            LaborHrs="{ ($i/@LaborHours) }" >
            { 
                 if (empty($i/@MachineHours)) then
                    attribute MachineHours { "NotFound" }
                 else
                    attribute MachineHours { data($i/@MachineHours) }
            }  
       </Location>
') as Result
FROM Production.ProductModel
where ProductModelID=7;

Voici le résultat obtenu :

ProductModelID Result

-------------- -----------------------------------

Voir aussi

Référence

Fonctions XQuery impliquant le type de données xml

Méthode exist() (type de données xml)