Fonctions sur les valeurs de chaîne : substring

S’applique à :SQL Server

Renvoie une partie de la valeur de $sourceString, en commençant à la position indiquée par la valeur de $startingLoc, et continue pour le nombre de caractères indiqué par la valeur de $length.

Syntaxe

  
fn:substring($sourceString as xs:string?,  
                          $startingLoc as xs:decimal?) as xs:string?  
  
fn:substring($sourceString as xs:string?,  
                          $startingLoc as xs:decimal?,  
                          $length as xs:decimal?) as xs:string?  

Arguments

$sourceString
Chaîne source.

$startingLoc
Point de départ dans la chaîne source à partir duquel la sous-chaîne commence. Si cette valeur est inférieure ou égale à 0, seuls les caractères dans des positions supérieures à zéro sont retournés. Si elle est supérieure à la longueur du $sourceString, la chaîne de longueur nulle est retournée.

$length
[facultatif] Nombre de caractères à extraire. S’il n’est pas spécifié, il retourne tous les caractères de l’emplacement spécifié dans $startingLoc jusqu’à la fin de la chaîne.

Remarques

La version à trois arguments de la fonction retourne les caractères de $sourceString dont la position $p obéit à :

fn:round($startingLoc) <= $p < fn:round($startingLoc) + fn:round($length)

La valeur de $length peut être supérieure au nombre de caractères dans la valeur de $sourceString suivant la position de départ. Dans ce cas, la sous-chaîne retourne les caractères jusqu’à la fin de $sourceString.

Le premier caractère d'une chaîne se trouve à la position 1.

Si la valeur de $sourceString est la séquence vide, elle est gérée comme chaîne de longueur nulle. Sinon, si $startingLoc ou $length est la séquence vide, la séquence vide est retournée.

Caractères supplémentaires (paires de substitution)

Le comportement de la paire de substitution dans des fonctions XQuery dépend du niveau de compatibilité de la base de données et, dans certains cas, de l'URI de l'espace de noms par défaut des fonctions. Pour plus d’informations, consultez la section « Les fonctions XQuery sont compatibles avec les substituts » dans la rubrique Modifications cassants apportées aux fonctionnalités du moteur de base de données dans SQL Server 2016. Consultez également ALTER DATABASE Compatibility Level (Transact-SQL) et Classement et Prise en charge Unicode.

Limites de mise en œuvre

SQL Server exige que les paramètres $startingLoc et $length soient de type xs:decimal au lieu de xs:double.

SQL Server permet $startingLoc et $length d’être la séquence vide, car la séquence vide est une valeur possible en raison d’erreurs dynamiques mappées à ().

Exemples

Cette rubrique fournit des exemples XQuery sur des instances XML stockées dans différentes colonnes de type xml dans la AdventureWorks2022 base de données.

R. Utilisation de la fonction XQuery substring() pour extraire une synthèse partielle des descriptions de modèles de produits.

La requête récupère les 50 premiers caractères du texte qui décrit le modèle de produit, l’élément <Summary> du document.

WITH XMLNAMESPACES ('https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription' AS pd)  
SELECT ProductModelID, CatalogDescription.query('  
    <Prod>{ substring(string((/pd:ProductDescription/pd:Summary)[1]), 1, 50) }</Prod>  
 ') as Result  
FROM Production.ProductModel  
where CatalogDescription.exist('/pd:ProductDescription')  = 1;  

Notez les points suivants dans la requête précédente :

  • La fonction string() retourne la valeur de chaîne de l’élément<Summary> . Cette fonction est utilisée, car l’élément <Summary> contient à la fois le texte et les sous-éléments (éléments de mise en forme html), et parce que vous allez ignorer ces éléments et récupérer tout le texte.

  • La fonction substring() récupère les 50 premiers caractères de la valeur de chaîne récupérée par la chaîne().

Voici un extrait du résultat :

ProductModelID Result  
-------------- ----------------------------------------------------  
19      <Prod>Our top-of-the-line competition mountain bike.</Prod>   
23      <Prod>Suitable for any type of riding, on or off-roa</Prod>  
...  

Voir aussi

Fonctions XQuery impliquant le type de données xml