GET_BIT (Transact SQL)

Aplica-se a: SQL Server 2022 (16.x) Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Ponto de extremidade de análise de SQL no Microsoft Fabric Warehouse no Microsoft Fabric

GET_BIT usa dois parâmetros e retorna o bit em expression_value que está no deslocamento definido por bit_offset.

Convenções de sintaxe de Transact-SQL

Sintaxe

GET_BIT ( expression_value, bit_offset )

Argumentos

expression_value

Qualquer expressão binária ou de número inteiro que não seja um LOB (objeto grande).

bit_offset

Qualquer número inteiro.

Tipo de retorno

bit

O parâmetro bit_offset no GET_BIT é usado para identificar o nésimo bit dos dados a serem obtidos ou definidos. Em tipos inteiros, o 0o bit é o bit menos significativo. Em tipos binários, o 0o bit é o bit menos significativo no byte mais à direita.

GET_BIT gerará um erro se bit_offset for negativo ou maior que o último bit no tipo de dados.

Comentários

Na implementação inicial, não haverá suporte para a funcionalidade de Consulta Distribuída para as funções de manipulação de bits no servidor vinculado ou em consultas ad hoc (OPENQUERY).

Exemplos

Neste exemplo, o segundo e o quarto bits são retornados.

SELECT GET_BIT ( 0xabcdef, 2 ) as Get_2nd_Bit,
GET_BIT ( 0xabcdef, 4 ) as Get_4th_Bit;

Os resultados são os seguintes:

Get_2nd_Bit Get_4th_Bit
1 0

Observação

0xabcdef em binário é 1010 1011 1100 1101 1110 1111. O segundo e o quarto bits são realçados.

Confira também