CHAR (Transact-SQL)
适用于： 
SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics 分析平台系统 (PDW) Microsoft Fabric 中的 SQL 分析端点 Microsoft Fabric 中的仓库
返回具有指定整数代码的单字节字符，由当前数据库的字符集和默认排序规则的编码定义。
语法
CHAR ( integer_expression )
参数
integer_expression
0 到 255 之间的整数。 对于此输入范围外的整数表达式或不表示完整字符的整数表达式，CHAR 返回 NULL 值。
字符超出了返回类型的长度时，CHAR 也会返回 NULL 值。
许多常见字符集将 ASCII 共享为子集，并为范围 0 到 127 中的整数值返回相同的字符。
注意
某些字符集（如 Unicode 和 Shift 日本工业标准）包括可以以单字节编码方案表示但需要多字节编码的字符。 有关字符集的详细信息，请参阅单字节和多字节字符集。
返回类型
char(1)
注解
使用 CHAR 可将控制字符插入字符字符串中。 此表显示了一些常用的控制字符。
| 控制字符 | 值 |
|---|---|
| 选项卡 | char(9) |
| Space | char（32） |
| 换行 | char(10) |
| 回车 | char(13) |
示例
A. 使用 ASCII 和 CHAR 从字符串打印 ASCII 值
此示例将输出字符串 New Moon 中每个字符的 ASCII 值和字符。
SET TEXTSIZE 0;
-- Create variables for the character string and for the current
-- position in the string.
DECLARE @position INT, @string CHAR(8);
-- Initialize the current position and the string variables.
SET @position = 1;
SET @string = 'New Moon';
WHILE @position <= DATALENGTH(@string)
BEGIN
SELECT ASCII(SUBSTRING(@string, @position, 1)),
CHAR(ASCII(SUBSTRING(@string, @position, 1)))
SET @position = @position + 1
END;
GO
结果集如下。
----------- -
78 N
----------- -
101 e
----------- -
119 w
----------- -
32
----------- -
77 M
----------- -
111 o
----------- -
111 o
----------- -
110 n
B. 使用 CHAR 插入控件字符
当查询以文本形式返回结果时，此示例使用 CHAR(13) 输出不同行中的员工姓名和电子邮件地址。 该示例使用 AdventureWorks2022 数据库。
SELECT p.FirstName + ' ' + p.LastName + CHAR(13) + pe.EmailAddress
FROM Person.Person p
INNER JOIN Person.EmailAddress pe
ON p.BusinessEntityID = pe.BusinessEntityID
AND p.BusinessEntityID = 1;
GO
结果集如下。
Ken Sanchez
ken0@adventure-works.com
°C 使用 ASCII 和 CHAR 从字符串打印 ASCII 值
此示例假定一个 ASCII 字符集。 它返回六个不同的 ASCII 字符数值的字符值。
SELECT CHAR(65) AS [65], CHAR(66) AS [66],
CHAR(97) AS [97], CHAR(98) AS [98],
CHAR(49) AS [49], CHAR(50) AS [50];
结果集如下。
65 66 97 98 49 50
---- ---- ---- ---- ---- ----
A B a b 1 2
D. 使用 CHAR 插入控件字符
当查询以文本的形式返回结果时，此示例用于 CHAR(13) 从 sys.databases 单独的行返回信息。
SELECT name, 'was created on ',
create_date,
CHAR(13),
name,
'is currently ',
state_desc
FROM sys.databases;
GO
结果集如下。
name create_date name state_desc
--------------------------------------------------------------------------------------------------------------------
master was created on 2003-04-08 09:13:36.390 master is currently ONLINE
tempdb was created on 2014-01-10 17:24:24.023 tempdb is currently ONLINE
AdventureWorksPDW2012 was created on 2014-05-07 09:05:07.083 AdventureWorksPDW2012 is currently ONLINE
E. 使用 CHAR 返回单字节字符
此示例使用 ASCII 有效范围中的整数和十六进制值。 CHAR 函数能够输出单字节日语字符。
SELECT CHAR(188) AS single_byte_representing_complete_character,
CHAR(0xBC) AS single_byte_representing_complete_character;
GO
结果集如下。
single_byte_representing_complete_character single_byte_representing_complete_character
------------------------------------------- -------------------------------------------
ｼ ｼ
F. 使用 CHAR 返回多字节字符
此示例使用扩展的 ASCII 有效范围中的整数和十六进制值。 但 CHAR 函数返回 NULL，因为此参数仅表示多字节字符的第一个字节。 字符（2） 双字节字符不能部分表示，也不能在没有某些转换操作的情况下进行分割。 双字节字符的各个字节通常不表示有效的 char（1） 值。
SELECT CHAR(129) AS first_byte_of_double_byte_character,
CHAR(0x81) AS first_byte_of_double_byte_character;
GO
结果集如下。
first_byte_of_double_byte_character first_byte_of_double_byte_character
----------------------------------- -----------------------------------
NULL NULL
G. 使用 CONVERT 而不是 CHAR 返回多字节字符
此示例接受二进制值作为编码的多字节字符，该字符与当前数据库的默认代码页一致，但需要经过验证。 字符转换受到更广泛的支持，可能是使用较低级别的编码的替代方法。
CREATE DATABASE [multibyte-char-context] COLLATE Japanese_CI_AI;
GO
USE [multibyte-char-context];
GO
SELECT NCHAR(0x266A) AS [eighth-note],
CONVERT(CHAR(2), 0x81F4) AS [context-dependent-convert],
CAST(0x81F4 AS CHAR(2)) AS [context-dependent-cast];
结果集如下。
eighth-note context-dependent-convert context-dependent-cast
----------- ------------------------- ----------------------
♪ ♪ ♪
H. 使用 NCHAR 而不是 CHAR 查找 UTF-8 字符
此示例强调了在给定编码形式下，Unicode 标准造成的字符的码位与代码单元序列之间的区别 。 分配给经典字符集中某个字符的二进制代码是其唯一的数字标识符。
相反，与字符关联的 UTF-8 字节序列是其分配的数字标识符（码位）的算法编码。 UTF-8 char 和 UTF-16 nchar 是使用 8 位和 16 位代码单元的不同编码形式，属于相同的字符集：Unicode 字符数据库 。
;WITH uni (c)
AS (
-- BMP character
SELECT NCHAR(9835)
UNION ALL
-- non-BMP supplementary character or, under downlevel collation, NULL
SELECT NCHAR(127925)
),
enc (u16c, u8c)
AS (SELECT c, CONVERT(VARCHAR(4), c COLLATE Latin1_General_100_CI_AI_SC_UTF8) FROM uni)
SELECT u16c AS [Music note],
u8c AS [Music note (UTF-8)],
UNICODE(u16c) AS [Code Point],
CONVERT(VARBINARY(4), u16c) AS [UTF-16LE bytes],
CONVERT(VARBINARY(4), u8c) AS [UTF-8 bytes]
FROM enc;
结果集如下。 这些结果是在具有补充字符支持的排序规则下 _SC 生成的。
| 音乐笔记 | 音乐笔记 （UTF-8） | 代码点 | UTF-16LE 字节 | UTF-8 字节 |
|---|---|---|---|---|
| ♫ | ♫ | 9835 | 0x6B26 | 0xE299AB |
| 🎵 | 🎵 | 127925 | 0x3CD8B5DF | 0xF09F8EB5 |