Fonctions sur des valeurs de chaîne - en minusculesFunctions on String Values - lower-case

CETTE RUBRIQUE S’APPLIQUE À : ouiSQL Server (à partir de la version 2012)nonAzure SQL DatabasenonAzure SQL Data WarehousenonParallel Data Warehouse THIS TOPIC APPLIES TO: yesSQL Server (starting with 2012)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

La fonction LOWER-case convertit chaque caractère dans $arg à son équivalent minuscule.The lower-case function converts each character in $arg to its lower case equivalent. 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.The Microsoft Windows binary case conversion for Unicode code points specifies how characters are converted to lower case. Cette norme n'est pas identique au mappage de la norme des points de code Unicode.This standard is not identical to the mapping for Unicode code point standard.

SyntaxeSyntax


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

ArgumentsArguments

TermeTerm DéfinitionDefinition
$arg$arg Valeur de chaîne à convertir en minuscule.The string value to be converted to lower case.

NotesRemarks

Si la valeur de $arg est vide, une chaîne de longueur nulle est retournée.If the value of $arg is empty, a zero length string is returned.

ExemplesExamples

A.A. Conversion d'une chaîne en majuscules.Changing a string to upper case

L’exemple suivant modifie la chaîne d’entrée ' abcDEF ! @4' en minuscules.The following example changes the input string 'abcDEF!@4' to lower case.

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

Voici l'ensemble des résultats.Here is the result set.

abcdef!@4

B.B. Recherche d’une chaîne de caractères spécifiqueSearch for a specific character string

Cet exemple montre comment utiliser la fonction lower-case pour effectuer une recherche non sensible à la casse.This example shows you how to use the lower-case function to perform a case insensitive search.

USE AdventureWorks  
GO  
--WITH XMLNAMESPACES clause specifies the namespace prefix  
--to use.   
WITH XMLNAMESPACES ('http://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.Here is the result set.

ProductModelID Result

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

19 <Prod ProductModelID="19">

<pd:Summary xmlns:pd="http://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="http://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.

</p1:p>

</pd:Summary>

</Prod>

Voir aussiSee Also

Fonctions XQuery impliquant le type de données xmlXQuery Functions against the xml Data Type