NCHAR (Transact-SQL)
Unicode 標準の定義に従って、指定された整数コードの Unicode 文字を返します。
.gif "トピック リンク アイコン")
構文
NCHAR ( integer_expression )
引数
integer_expression
データベースの照合順序に補助文字 (SC) フラグが含まれない場合、これは 0 ～ 65535 (0 ～ 0xFFFF) の正の整数です。 この範囲外の値を指定すると、NULL が返されます。 補助文字の詳細については、「照合順序と Unicode のサポート」を参照してください。データベースの照合順序が補助文字 (SC) フラグをサポートする場合、これは 0 ～ 1114111 (0 ～ 0x10FFFF) の正の整数です。 この範囲外の値を指定すると、NULL が返されます。
戻り値の型
既定のデータベースの照合順序が補助文字をサポートしない場合は nchar(1)。
既定のデータベースの照合順序が補助文字をサポートする場合は nvarchar(2)。
パラメーター integer_expression が 0 ～ 0 xFFFF の範囲内にある場合、1 つの文字だけが返されます。 値が大きい場合、NCHAR は対応するサロゲート ペアを返します。 NCHAR(<High surrogate>) + NCHAR(<Low Surrogate>) を使用してサロゲート ペアを作成しないでください。 代わりに、補助文字をサポートするデータベース照合順序を使用し、サロゲート ペアの Unicode コード ポイントを指定します。 次の例では、サロゲート ペアを作成する古いスタイルの方法と、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));
使用例
A. NCHAR と UNICODE を使用する
次の例では、UNICODE 関数と NCHAR 関数を使用して、København という文字列の 2 番目の文字の UNICODE 値と NCHAR (Unicode 文字) を出力することによって、ø という実際の 2 番目の文字を出力します。
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 という文字列の中の各文字の文字番号、Unicode 文字、および UNICODE 値を出力します。
-- 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
以下に結果セットを示します。
Character # Unicode Character UNICODE Value
----------- ---- ----------------- -----------
1 K K 75
(1 row(s) affected)
----------- ---- ----------------- -----------
2 ø ø 248
(1 row(s) affected)
----------- ---- ----------------- -----------
3 b b 98
(1 row(s) affected)
----------- ---- ----------------- -----------
4 e e 101
(1 row(s) affected)
----------- ---- ----------------- -----------
5 n n 110
(1 row(s) affected)
----------- ---- ----------------- -----------
6 h h 104
(1 row(s) affected)
----------- ---- ----------------- -----------
7 a a 97
(1 row(s) affected)
----------- ---- ----------------- -----------
8 v v 118
(1 row(s) affected)
----------- ---- ----------------- -----------
9 n n 110
(1 row(s) affected)
----------- ---- ----------------- -----------
10 NULL NULL
(1 row(s) affected)
----------- ---- ----------------- -----------
11 NULL NULL
(1 row(s) affected)
----------- ---- ----------------- -----------
12 NULL NULL
(1 row(s) affected)
----------- ---- ----------------- -----------
13 NULL NULL
(1 row(s) affected)
----------- ---- ----------------- -----------
14 NULL NULL
(1 row(s) affected)
----------- ---- ----------------- -----------
15 NULL NULL
(1 row(s) affected)
----------- ---- ----------------- -----------
16 NULL NULL
(1 row(s) affected)
----------- ---- ----------------- -----------
17 NULL NULL
(1 row(s) affected)
----------- ---- ----------------- -----------
18 NULL NULL
(1 row(s) affected)