Article
09/27/2010

lower-case, fonction (XQuery)

La fonction lower-case convertit chaque caractère dans $arg en son équivalent en minuscules. La conversion de casse binaire de Microsoft Windows pour les points de code Unicode spécifie le mode de conversion des caractères en minuscules. Cette norme n'est pas identique au mappage de la norme des points de code Unicode.

Syntaxe

fn:lower-case($arg as xs:string?) as xs:string

Arguments

Terme	Définition
$arg	Valeur de chaîne à convertir en minuscule.

Notes

Si la valeur de $arg est vide, une chaîne nulle est retournée.

Exemples

A. Conversion d'une chaîne en majuscules.

L'exemple suivant convertit la chaîne d'entrée 'abcDEF!@ 4' en minuscules.

DECLARE @x xml = N'abcDEF!@4';
SELECT @x.value('fn:lower-case(/text()[1])', 'nvarchar(10)');

Voici l'ensemble des résultats.

abcdef!@4

B. Recherche d'une chaîne de caractères spécifique

Cet exemple montre comment utiliser la fonction lower-case pour effectuer une recherche non sensible à la casse.

USE AdventureWorks
GO
--WITH XMLNAMESPACES clause specifies the namespace prefix
--to use. 
WITH XMLNAMESPACES ('https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription' AS pd)
--The XQuery contains() function is used to determine whether
--any of the text nodes below the <Summary> element contain
--the word 'frame'. The lower-case() function makes the 
--case insensitive.

SELECT ProductModelID, CatalogDescription.query('
      <Prod>
         { /pd:ProductDescription/@ProductModelID }
         { /pd:ProductDescription/pd:Summary }
      </Prod>
 ') as Result
FROM Production.ProductModel
where CatalogDescription.exist('
/pd:ProductDescription/pd:Summary//text()[
          contains(lower-case(.), "FRAME")]')  = 1

Voici l'ensemble des résultats.

ProductModelID Result

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

19 <Prod ProductModelID="19">

<pd:Summary xmlns:pd="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription">

<p1:p xmlns:p1="http://www.w3.org/1999/xhtml">Our top-of-the-line competition mountain bike.

Performance-enhancing options include the innovative HL Frame,

super-smooth front suspension, and traction for all terrain.

</p1:p>

</pd:Summary>

</Prod>

25 <Prod ProductModelID="25">

<pd:Summary xmlns:pd="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription">

<p1:p xmlns:p1="http://www.w3.org/1999/xhtml">This bike is ridden by race winners. Developed with the

Adventure Works Cycles professional race team, it has a extremely light

heat-treated aluminum frame, and steering that allows precision control.