Fonction string (XQuery)

Renvoie la valeur de $arg représenté sous la forme d'une chaîne.

Syntaxe

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

Arguments

  • $arg
    Nœud ou valeur atomique.

Notes

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

  • Si $arg est un nœud, la fonction renvoie la valeur de chaîne du nœud obtenu à l'aide de l'accesseur string-value. 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 convertie vers xs:string, $arg, sauf si spécifié autrement.

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

  • Dans cette implémentation, la fonction fn:string() ne peut être utilisée sans argument que dans le contexte d'un prédicat dépendant du contexte. En particulier, elle ne peut être utilisée qu'entre crochets ([ ]).

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 string

La requête suivante extrait le nœud d'élément enfant <Features> de l'élément <ProductDescription>.

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 indiqué.

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 years parts 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. Des requêtes sont spécifiées pour illustrer le résultat de l'application de la fonction 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