NCHAR (Transact-SQL)

Articolo
12/22/2023

Si applica a:SQL Server database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics Analytics Platform System (PDW)

Restituisce il carattere Unicode corrispondente al codice integer specificato, in base alla definizione dello standard Unicode.

Convenzioni di sintassi Transact-SQL

Sintassi

NCHAR ( integer_expression )

Nota

Per visualizzare la sintassi Transact-SQL per SQL Server 2014 (12.x) e versioni precedenti, vedere la documentazione delle versioni precedenti.

Argomenti

integer_expression
Quando le regole di confronto del database non contengono il flag di caratteri supplementari (SC), si tratta di un intero positivo compreso tra 0 e 65535 (tra 0 e 0xFFFF). Se viene specificato un valore non compreso in questo intervallo, viene restituito NULL. Per altre informazioni sui caratteri supplementari, vedere Regole di confronto e supporto Unicode.

Quando le regole di confronto del database supportano il flag SC, si tratta di un intero positivo compreso tra 0 e 1114111 (tra 0 e 0x10FFFF). Se viene specificato un valore non compreso in questo intervallo, viene restituito NULL.

Tipi restituiti

nchar(1) quando le regole di confronto predefinite del database non supportano i caratteri supplementari.

nvarchar(2) quando le regole di confronto predefinite del database supportano i caratteri supplementari.

Se il parametro integer_expression rientra nell'intervallo 0 - 0xFFFF, viene restituito un solo carattere. Per i valori superiori, NCHAR restituisce la coppia di surrogati corrispondente. Non creare una coppia di surrogati tramite NCHAR(<High surrogate>) + NCHAR(\<Low Surrogate>). Utilizzare invece regole di confronto del database che supportano caratteri supplementari, quindi specificare il punto di codice Unicode per la coppia di surrogati. Nell'esempio seguente vengono illustrati sia il metodo obsoleto per la creazione di una coppia di surrogati che il metodo preferito per la specifica del punto di codice Unicode.

CREATE DATABASE test COLLATE Finnish_Swedish_100_CS_AS_SC;  
DECLARE @d NVARCHAR(10) = N'𣅿';
-- Old style method.  
SELECT NCHAR(0xD84C) + NCHAR(0xDD7F);   
  
-- Preferred method.   
SELECT NCHAR(143743);   
  
-- Alternative preferred method.  
SELECT NCHAR(UNICODE(@d));

Esempi

R. Utilizzo delle funzioni NCHAR e UNICODE

Nell'esempio seguente vengono utilizzate le funzioni UNICODE e NCHAR per stampare il valore UNICODE e il risultato di NCHAR (carattere Unicode) del secondo carattere della stringa di caratteri København, nonché il secondo carattere effettivo, ovvero ø.

DECLARE @nstring NCHAR(8);  
SET @nstring = N'København';  
SELECT UNICODE(SUBSTRING(@nstring, 2, 1)),   
   NCHAR(UNICODE(SUBSTRING(@nstring, 2, 1)));  
GO

Questo è il set di risultati.

----------- -   
248         ø  
(1 row(s) affected)

B. Utilizzo di SUBSTRING, UNICODE, CONVERT e NCHAR

Nell'esempio seguente vengono utilizzate le funzioni SUBSTRING, UNICODE, CONVERT, e NCHAR per stampare il numero di caratteri, il carattere Unicode e il valore UNICODE di ogni carattere della stringa København.

-- The @position variable holds the position of the character currently  
-- being processed. The @nstring variable is the Unicode character   
-- string to process.  
DECLARE @position INT, @nstring NCHAR(9);  
-- Initialize the current position variable to the first character in   
-- the string.  
SET @position = 1;  
-- Initialize the character string variable to the string to process.  
-- Notice that there is an N before the start of the string. This   
-- indicates that the data following the N is Unicode data.  
SET @nstring = N'København';  
-- Print the character number of the position of the string you are at,   
-- the actual Unicode character you are processing, and the UNICODE   
-- value for this particular character.  
PRINT 'Character #' + ' ' + 'Unicode Character' + ' ' + 'UNICODE Value';  
WHILE @position <= DATALENGTH(@nstring)  
   BEGIN  
   SELECT @position,   
      NCHAR(UNICODE(SUBSTRING(@nstring, @position, 1))),  
      CONVERT(NCHAR(17), SUBSTRING(@nstring, @position, 1)),  
      UNICODE(SUBSTRING(@nstring, @position, 1))  
   SELECT @position = @position + 1  
   END;  
GO