Share via

SET_BIT (Transact SQL)

  • Articolo

Si applica a: endpoint di analisi SQL Server 2022 (16.x) database SQL di Azure Istanza gestita di SQL di Azure SQL in Microsoft FabricWarehouse in Microsoft Fabric

SET_BIT restituisce l'offset di expression_value dal bit definito da bit_offset. Il valore del bit predefinito è 1 o viene impostato da bit_value.

Convenzioni di sintassi Transact-SQL

Sintassi

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

Argomenti

expression_value

Qualsiasi espressione integer o binaria diversa da un Large Object (LOB).

bit_offset

Qualsiasi valore integer.

Tipi restituiti

Stesso tipo di expression_value.

Il parametro bit_offset viene usato per identificare il bit dei dati da impostare. Nei tipi integer, il bit 0 è quello meno significativo. Nei tipi binari, il bit 0 è quello meno significativo nel byte più a destra.

bit_value può essere un valore integer o un bit. Tuttavia, gli unici valori validi per bit_value sono 1 e 0, indipendentemente dal tipo di dati. SET_BIT genererà un errore se bit_value non è 1 o 0 o Null.

SET_BIT genererà un errore se bit_offset è negativo o maggiore dell'ultimo bit nel tipo di dati.

Osservazioni:

Nell'implementazione iniziale, non è supportata la funzionalità Query distribuita per le funzioni di manipolazione dei bit all'interno di un server collegato o di query ad hoc (OPENQUERY).

Esempi

R. Usare SET_BIT per modificare un valore

In questo esempio il terzo bit (in corrispondenza dell'offset 2, indice in base zero) viene impostato su 1.

SELECT SET_BIT ( 0x00, 2 ) as VARBIN1;

Il risultato è 0x04. Questo perché il valore expression_value di 0x00 viene convertito in 0000. SET_BIT modifica il terzo bit (offset 2) in 1, rendendolo 0100. Questo valore binario viene quindi restituito come 4 nella rappresentazione esadecimale.

B. Usare SET_BIT per modificare un valore con un valore bit_value personalizzato

In questo esempio il valore bit_value viene impostato su 0 anziché sul valore predefinito 1.

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

Il risultato è 0xABCDEE. Il valore expression_value viene convertito in binario, ovvero 1010 1011 1100 1101 1110 1111. SET_BIT modifica il primo bit in 0 e il risultato viene restituito in formato esadecimale.

Vedi anche