chaîne x

Valeur de chaîne pour la comparaison. Les valeurs qui ne sont pas des chaînes sont converties en une valeur de chaîne avant la comparaison.

chaîne y

Valeur de chaîne pour la comparaison. Les valeurs qui ne sont pas des chaînes sont converties en une valeur de chaîne avant la comparaison.

chaîne langue[facultatif]

Définit la langue pour déterminer l'ordre de tri. Cette chaîne est similaire à l'attribut <xsl:sort> lang (par exemple, "en-US" ou "fr-CA"). Si ce paramètre est omis ou si la chaîne est vide, la langue est définie par l'environnement système (langue du thread actuel).

chaîne options[facultatif]

Par défaut, la comparaison respecte la casse, les minuscules venant en premier.

option	description
u	Rend la comparaison sensible à la casse, majuscules en premier.
i	Rend la comparaison insensible à toutes les différences traditionnelles entre les caractères, p. ex. casse, kana et largeur. (La largeur des caractères ne s'applique qu'à certaines langues.)

Retourne l'une des trois valeurs numériques suivantes.

Les comparaisons entre chaînes se font dans l'ordre lexicographique (dictionnaire). Si une langue ou une option non prise en charge est spécifiée, une erreur d'exécution se produit. Pour les composants MSXML, la valeur E_FAIL est retournée.

L'exemple de code suivant montre comment comparer deux chaînes à l'aide de la fonction ms:string-compare. Il compare trois chaînes de nombres (« 1 », « 2 » et « 3 ») et « 2 ». Les résultats des comparaisons sont indiqués dans le tableau qui suit le code.

 Fichier XML

Xml

<?xml version="1.0"?>
<string-sample>
   <string>1</string>
   <string>2</string>
   <string>3</string>
</string-sample>

 Fichier XSLT (translate.xsl)

Xml

<?xml version='1.0'?>
<xsl:stylesheet  version="1.0"
      xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
      xmlns:ms="urn:schemas-microsoft-com:xslt">
   <xsl:output method="html" omit-xml-declaration="yes"/>
   <xsl:template match="/string-sample">
      <xsl:for-each select="string">
         <xsl:value-of select="ms:string-compare(., '2', 'en-US', 'i')"/>,
     </xsl:for-each>
  </xsl:template>
</xsl:stylesheet>

Les résultats des comparaisons sont les suivants :

x, y	Résultats
"1" , "2"	-1
"2" , "2"	0
"3" , "2"	1

Référence