Funzioni su valori stringa - substring

  • Articolo

Si applica a:SQL Server

Restituisce parte del valore di $sourceString, a partire dalla posizione indicata dal valore di $startingLoc e continua per il numero di caratteri indicato dal valore di $length.

Sintassi

  
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?

Argomenti

$sourceString
Stringa di origine.

$startingLoc
Punto della stringa di origine corrispondente al punto iniziale della sottostringa. Se il valore è negativo o è uguale a 0, vengono restituiti solo i caratteri nelle posizioni maggiori di zero. Se è maggiore della lunghezza del $sourceString, viene restituita la stringa di lunghezza zero.

$length
Numero di caratteri da recuperare (facoltativo). Se non specificato, restituisce tutti i caratteri dalla posizione specificata in $startingLoc fino alla fine della stringa.

Osservazioni:

La versione della funzione con tre argomenti restituisce i caratteri di $sourceString il cui operatore di posizione $p è soggetto alla regola seguente:

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

Il valore di $length può essere maggiore del numero di caratteri nel valore di $sourceString dopo la posizione iniziale. In questo caso, la sottostringa restituisce i caratteri fino alla fine di $sourceString.

Il primo carattere di una stringa si trova nella posizione 1.

Se il valore di $sourceString è la sequenza vuota, viene gestito come stringa di lunghezza zero. In caso contrario, se $startingLoc o $length è la sequenza vuota, viene restituita la sequenza vuota.

Caratteri supplementari (coppie di surrogati)

Il comportamento delle coppie di surrogati nelle funzioni XQuery dipende dal livello di compatibilità del database e, in alcuni casi, dall'URI dello spazio dei nomi predefinito per le funzioni. Per altre informazioni, vedere la sezione "Le funzioni XQuery sono compatibile con surrogati" nell'argomento Modifiche di rilievo apportate alle funzionalità del motore di database in SQL Server 2016. Vedere anche Livello di compatibilità ALTER DATABASE (Transact-SQL) e Regole di confronto e supporto Unicode.

Limitazioni di implementazione

SQL Server richiede che i parametri $startingLoc e $length siano di tipo xs:decimal anziché xs:double.

SQL Server consente $startingLoc e $length di essere la sequenza vuota, perché la sequenza vuota è un valore possibile a causa di errori dinamici di cui è stato eseguito il mapping a ().

Esempi

In questo argomento vengono forniti esempi XQuery su istanze XML archiviate in varie colonne di tipo xml nel AdventureWorks2022 database.

R. Utilizzo della funzione XQuery substring() per recuperare le descrizioni parziali del modello del prodotto disponibili nell'elemento Summary

La query recupera i primi 50 caratteri del testo che descrive il modello di prodotto, l'elemento <Summary> nel documento.

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;

Dalla query precedente si noti quanto segue:

  • La funzione string() restituisce il valore stringa dell'elementoSummary<>. Questa funzione viene utilizzata, perché l'elemento <Summary> contiene sia il testo che i sottoelementi (elementi di formattazione html) e perché questi elementi verranno ignorati e recuperati tutto il testo.

  • La funzione substring() recupera i primi 50 caratteri dal valore stringa recuperato dalla stringa().

Risultato parziale:

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>  
...

Vedi anche

Funzioni XQuery per il tipo di dati XML