Fonction upper-case
La fonction fn:upper-case convertit une chaîne en majuscules.
Syntaxe
- source-string
- Chaîne à convertir en majuscules.
source-string a le type de données xs: string ou est une séquence vide.
- locale-name
- Chaîne contenant l'environnement local à utiliser pour l'opération en majuscules.
locale-name est de type xs:string ou correspond à la séquence vide. Si locale-name n'est pas la séquence vide, la valeur de locale-name n'est pas sensible à la casse et doit être un environnement local valide ou une chaîne de longueur égale à zéro.
Valeur renvoyée
Si source-string n'est pas une séquence vide, la valeur renvoyée est source-string avec chaque caractère converti en son correspondant en majuscules. Si locale-name n'est pas spécifié, s'il s'agit d'une séquence vide ou s'il s'agit d'une chaîne de longueur égale à zéro, les règles en majuscules définies dans la norme Unicode sont utilisées. Sinon, les règles en majuscules de l'environnement local spécifié sont utilisées. Chaque caractère qui n'a pas de correspondant en majuscule est inclus dans la valeur renvoyée dans sa forme d'origine.
Si source-string est la séquence vide, la valeur renvoyée est une chaîne de longueur zéro.
Exemples
fn:upper-case('Test literal 1')La valeur renvoyée est'TEST LITERAL 1'.
La fonction suivante spécifie l'environnement local turc tr_TR et convertit la lettre "i", ainsi que la référence de caractère numérique ı (référence de caractère pour la lettre latine dotless i).
fn:upper-case("iı", "tr_TR")La valeur renvoyée se compose de deux caractères, le caractère représenté par İ (majuscule latine I avec point ci-dessus) et la lettre "I". Pour l'environnement local turc, la lettre "i" est convertie en caractère représenté par İ (majuscule latine I avec point au-dessus), et le caractère représenté par ı (lettre minuscule latine sans point i) est converti en la lettre "I".
La fonction suivante ne spécifie pas d'environnement local et convertit deux caractères en majuscules à l'aide des règles définies dans la norme Unicode.
fn:upper-case("ıi")La fonction renvoie les caractères "II". fn:upper-case convertit le caractère en minuscules ı et la lettre "i" en majuscule "I".