SET_BIT (Transact SQL)

适用于: sql Server 2022 (16.x) Azure SQL 数据库 Azure SQL 托管实例 Microsoft Fabric Warehouse 中的 Microsoft Fabric Warehouse 中的 SQL 分析终结点

SET_BIT 通过 bit_offset 定义的位返回 expression_value 偏移量。 位值默认为 1,或由 bit_value 设置。

Transact-SQL 语法约定

语法

SET_BIT ( expression_value, bit_offset ) 
SET_BIT ( expression_value, bit_offset, bit_value )

参数

expression_value

任何不是大型对象 (LOB) 的整数或二进制表达式。

bit_offset

任意整数。

返回类型

与 expression_value 相同的类型。

bit_offset 参数用于标识要设置的数据的第 n 位。 在整数类型中,第 0 位是最低有效位。 在二进制类型中,第 0 位是最右侧字节中的最低有效位。

bit_value 可以是整数或位。 但是,无论数据类型如何,bit_value 的唯一有效值为 1 和 0。 如果 bit_value 不是 1、0 或 null,则 SET_BIT 将引发错误。

如果 bit_offset 为负或大于数据类型中的最后一位,SET_BIT 将引发错误。

备注

在初始实现中,链接服务器中的位操作函数的分布式查询功能或即席查询 (OPENQUERY) 不受支持。

示例

A. 使用 SET_BIT 修改值

在此示例中,第 3 位(索引从零开始,位于偏移量 2 处)设置为 1

SELECT SET_BIT ( 0x00, 2 ) as VARBIN1;

结果为 0x04。 这是因为 0x00 的 expression_value 转换为 0000。 SET_BIT 将其第 3 位(偏移量 2)更改为 1,使其变为 0100。 然后,以十六进制表示形式 4 返回此二进制值。

B. 使用 SET_BIT 修改具有自定义 bit_value 的值

在此示例中,bit_value 设置为 0 而不是默认值 1。

SELECT SET_BIT ( 0xabcdef, 0, 0 ) as VARBIN2;

结果为 0xABCDEE。 expression_value 转换为二进制,即 1010 1011 1100 1101 1110 1111。 SET_BIT 将第 1 位更改为 0,结果以十六进制格式返回。

请参阅