LEFT (Transact-SQL)
Restituisce la parte iniziale di una stringa di caratteri, di lunghezza pari al numero di caratteri specificato.
.gif "Icona di collegamento a un argomento")
Convenzioni della sintassi Transact-SQL
Sintassi
LEFT ( character_expression , integer_expression )
Argomenti
character_expression
Espressione di dati di tipo carattere o binario. character_expression può essere una costante, una variabile o una colonna. Il tipo di dati di character_expression può essere qualsiasi tipo di dati, eccetto text o ntext, convertibile in modo implicito in varchar o nvarchar. In caso contrario, utilizzare la funzione CAST per convertire in modo esplicito character_expression.integer_expression
Intero positivo che specifica quanti caratteri dell'espressione character_expression verranno restituiti. Se l'argomento integer_expression è negativo, viene restituito un errore. Se integer_expression è di tipo bigint e contiene un valore di grandi dimensioni, character_expression deve essere di un tipo di dati di grandi dimensioni, ad esempio varchar(max).Il parametro integer_expression considera un carattere surrogato UTF-16 come un solo carattere.
Tipi restituiti
Viene restituito varchar quando character_expression è un tipo di dati carattere non Unicode.
Viene restituito nvarchar quando character_expression è un tipo di dati carattere Unicode.
Osservazioni
Quando si utilizzano le regole di confronto SC, il parametro integer_expression considera una coppia di surrogati UTF-16 come un solo carattere. Per ulteriori informazioni, vedere Regole di confronto e supporto Unicode.
Esempi
A.Utilizzo di LEFT con una colonna
Nell'esempio seguente vengono restituiti i primi cinque caratteri di ogni nome di prodotto.
USE AdventureWorks2012;
GO
SELECT LEFT(Name, 5)
FROM Production.Product
ORDER BY ProductID;
GO
B.Utilizzo di LEFT con una stringa di caratteri
Nell'esempio seguente viene utilizzata la funzione LEFT per ottenere i primi due caratteri della stringa di caratteri abcdefg.
SELECT LEFT('abcdefg',2)
GO
Set di risultati:
--
ab
(1 row(s) affected)