Fonctions d’accesseur de données : string (XQuery)

S’applique à :SQL Server

Retourne la valeur de $arg représentée sous forme de chaîne.

Syntaxe

  
fn:string() as xs:string  
fn:string($arg as item()?) as xs:string  

Arguments

$arg
Nœud ou valeur atomique.

Remarques

  • Si $arg est la séquence vide, la chaîne de longueur nulle est retournée.

  • Si $arg est un nœud, la fonction retourne la valeur de chaîne du nœud obtenue à l’aide de l’accesseur chaîne-valeur. Celui-ci est défini dans les spécifications W3C XQuery 1.0 et XPath 2.0 Data Model.

  • Si $arg est une valeur atomique, la fonction retourne la même chaîne que celle renvoyée par l’expression cast en tant que xs:string, $arg, sauf indication contraire.

  • Si le type de $arg est xs:anyURI, l’URI est converti en chaîne sans échappement de caractères spéciaux.

  • Dans cette implémentation, fn:string() sans argument ne peut être utilisé que dans le contexte d’un prédicat dépendant du contexte. Autrement dit, elle ne peut être utilisée qu'à l'intérieur de crochets ([ ]).

Exemples

Cette rubrique fournit des exemples XQuery par rapport aux instances XML stockées dans différentes colonnes de type XML dans la base de données AdventureWorks.

R. Utilisation de la fonction string

La requête suivante récupère le nœud d’élément enfant de l’élément><ProductDescription.<Features>

SELECT CatalogDescription.query('  
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";  
 /PD:ProductDescription/PD:Features  
')  
FROM Production.ProductModel  
WHERE ProductModelID=19  

Voici le résultat partiel :

<PD:Features xmlns:PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription">  
   These are the product highlights.   
   <p1:Warranty xmlns:p1="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain">  
    <p1:WarrantyPeriod>3 years</p1:WarrantyPeriod>  
    <p1:Description>parts and labor</p1:Description>  
   </p1:Warranty>  
       ...  
</PD:Features>  

Si vous spécifiez la fonction string(), vous recevez la valeur de chaîne du nœud spécifié.

SELECT CatalogDescription.query('  
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";  
 string(/PD:ProductDescription[1]/PD:Features[1])  
')  
FROM Production.ProductModel  
WHERE ProductModelID=19  

Le résultat partiel est le suivant.

These are the product highlights.   
3 yearsparts and labor...    

B. Utilisation de la fonction string sur différents nœuds

Dans l'exemple suivant, une instance XML est affectée à une variable de type xml. Les requêtes sont spécifiées pour illustrer le résultat de l’application de string() à différents nœuds.

declare @x xml  
set @x = '<?xml version="1.0" encoding="UTF-8" ?>  
<!--  This is a comment -->  
<root>  
  <a>10</a>  
just text  
  <b attr="x">20</b>  
</root>  
'  

La requête suivante extrait la valeur de chaîne du nœud de document. Cette valeur est le fruit de la concaténation de la valeur de chaîne de tous ses nœuds de texte descendants.

select @x.query('string(/)')  

Voici le résultat obtenu :

This is a comment 10  
just text  
 20  

La requête suivante essaie d'extraire la valeur de chaîne d'un nœud d'instruction de traitement. Le résultat est une séquence vide, car il ne contient pas de nœud de texte.

select @x.query('string(/processing-instruction()[1])')  

La requête suivante extrait la valeur de chaîne du nœud de commentaire et renvoie le nœud de texte.

select @x.query('string(/comment()[1])')  

Voici le résultat obtenu :

This is a comment   

Voir aussi

Fonctions XQuery impliquant le type de données xml