NCHAR (Transact-SQL)

Статья
12/22/2023

Применимо к:SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure Azure Synapse Analytics AnalyticsPlatform System (PDW)

Возвращает символ Юникода с указанным целочисленным кодом, определенным в стандарте Юникода.

Соглашения о синтаксисе Transact-SQL

Синтаксис

NCHAR ( integer_expression )

Примечание.

Сведения о синтаксисе Transact-SQL для SQL Server 2014 (12.x) и более ранних версиях см . в документации по предыдущим версиям.

Аргументы

integer_expression
Если параметры сортировки базы данных не содержат флаг дополнительных символов, используется положительное целое число от 0 до 65 535 (от 0 до 0xFFFF). При указании значения вне этого диапазона возвращается значение NULL. Дополнительные сведения о дополнительных символах см. в статье Поддержка параметров сортировки и Юникода.

Если параметры сортировки базы данных поддерживают флаг дополнительных символов, используется положительное целое число от 0 до 1 114 111 (от 0 до 0x10FFFF). При указании значения вне этого диапазона возвращается значение NULL.

Типы возвращаемых данных

nchar(1), когда параметры сортировки базы данных по умолчанию не поддерживают дополнительные символы.

nvarchar(2), когда параметры сортировки базы данных по умолчанию поддерживают дополнительные символы.

Если параметр integer_expression лежит в диапазоне 0–0xFFFF, то возвращается только один символ. Для больших значений NCHAR возвращает соответствующую суррогатную пару. Не создавайте суррогатные пары с применением NCHAR(<High surrogate>) + NCHAR(\<Low Surrogate>). Вместо этого используйте параметры сортировки базы данных, которые поддерживают дополнительные символы, с указанием кодовой точки в Юникоде для суррогатной пары. В следующем примере рассматривается как старый метод конструирования суррогатной пары, так и предпочтительный метод с указанием кодовой точки в Юникоде.

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));

Примеры

А. Использование функций NCHAR и UNICODE

В следующем примере функции UNICODE и NCHAR используются для вывода значения UNICODE и NCHAR (символ Юникода) второго символа строки København и вывода второго фактического символа ø.

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

Результирующий набор:

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

B. Использование функций SUBSTRING, UNICODE, CONVERT и NCHAR

В следующем пример функции SUBSTRING, UNICODE, CONVERT и NCHAR используются для печати номера символа, символа Юникода и значения Юникода каждого символа в строке 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