GET_BIT (Transact SQL)
Applies to:
SQL Server 2022 (16.x)
Azure SQL Database
Azure SQL Managed Instance
SQL analytics endpoint in Microsoft Fabric
Warehouse in Microsoft Fabric
GET_BIT takes two parameters and returns the bit in expression_value that is in the offset defined by bit_offset.
Transact-SQL syntax conventions
Syntax
GET_BIT ( expression_value, bit_offset )
Arguments
expression_value
Any integer or binary expression that isn't a large object (LOB).
bit_offset
Any integer.
Return type
bit
The bit_offset parameter in GET_BIT is used to identify the nth bit of the data to get or set. In integer types, the 0
th bit is the least significant bit. In binary types, the 0
th bit is the least significant bit in the rightmost byte.
GET_BIT will throw an error if bit_offset is negative or greater than the last bit in the data type.
Remarks
In the initial implementation, Distributed Query functionality for the bit manipulation functions within linked server or ad hoc queries (OPENQUERY) won't be supported.
Examples
In this example, the second and fourth bits are returned.
SELECT GET_BIT ( 0xabcdef, 2 ) as Get_2nd_Bit,
GET_BIT ( 0xabcdef, 4 ) as Get_4th_Bit;
The results are as follows:
Get_2nd_Bit | Get_4th_Bit |
---|---|
1 | 0 |
Note
0xabcdef
in binary is 1010 1011 1100 1101 1110 1111. The second and fourth bits are highlighted.