Documentation
2 Funções bit a bit
Todas as funções listadas aqui são suportadas em:
Algumas notas gerais sobre parâmetros de função:
- Os parâmetros da função são separados por uma vírgula
- Expressões são aceitas como parâmetros
- Parâmetros de função opcionais (ou partes de parâmetros) são indicados por
<>
| FUNÇÃO | |||
|---|---|---|---|
| Descrição | Parâmetros específicos da função | Comentários | |
| bitand (valor,máscara) | |||
| Valor de "E bit a bit" de um valor de item e máscara. | valor - valor a ser verificado máscara (obrigatório) - inteiro sem sinal de 64 bits (0 - 18446744073709551615) |
Suportado tipos de valor: int Embora a comparação seja feita de forma bit a bit, todos os valores devem ser fornecidos e retornados em decimal. Por exemplo, a verificação do 3º bit é feita comparando-se a 4, não a 100. Exemplos: => bitand(last(/host/key),12 )=8 ou bitand(last(/host/key),12)=4 → 3º ou 4º bit definido, mas não ambos ao mesmo tempo => bitand (last(/host/key),20)=16 → 3º bit não definido e 5º bit definido. |
|
| bitlshift (valor, bits para deslocamento) | |||
| Deslocamento bit a bit para a esquerda de um valor de item. | valor - valor a ser verificado bits para deslocamento (obrigatório) - número de bits para deslocamento |
Tipos de valor suportados: int < br>Embora a comparação seja feita de forma bit a bit, todos os valores devem ser fornecidos e são retornados em decimal. Por exemplo, a verificação do 3º bit é feita comparando-se a 4, não a 100. |
|
| bitnot (valor) | |||
| Valor de "NÃO bit a bit" de um valor de item. | valor - valor a ser verificado |
Tipos de valor suportados: int Embora a comparação seja feita de maneira bit a bit, todos os valores devem ser fornecidos e são retornados em decimal. Por exemplo, a verificação do 3º bit é feita comparando-se a 4, não a 100. |
|
| bitor (valor,máscara) | |||
| Valor de "OR bit a bit" de um valor de item e máscara. | valor - valor a ser verificado máscara (obrigatório) - inteiro sem sinal de 64 bits (0 - 18446744073709551615) |
Suportado tipos de valor: int Embora a comparação seja feita de forma bit a bit, todos os valores devem ser fornecidos e retornados em decimal. Por exemplo, a verificação do 3º bit é feita comparando-se a 4, não a 100. |
|
| bitrshift (valor, bits para deslocamento) | |||
| Deslocamento bit a bit para a direita de um valor de item. | valor - valor a ser verificado bits a serem deslocados (obrigatório) - número de bits a serem deslocados |
Tipos de valor suportados: int < br>Embora a comparação seja feita de forma bit a bit, todos os valores devem ser fornecidos e são retornados em decimal. Por exemplo, a verificação do 3º bit é feita comparando-se a 4, não a 100. |
|
| bitxor (valor,máscara) | |||
| Valor de "OR exclusivo bit a bit" de um valor de item e máscara. | valor - valor a ser verificado máscara (obrigatório) - inteiro sem sinal de 64 bits (0 - 18446744073709551615) |
Tipos de valores suportados: int Embora a comparação seja feita de forma bit a bit, todos os valores devem ser fornecidos e são retornados em decimal. Por exemplo, a verificação do 3º bit é feita comparando-se a 4, não a 100. |
|
Function details
Some general notes on function parameters:
- Function parameters are separated by a comma
- Expressions are accepted as parameters
- Optional function parameters (or parameter parts) are indicated by
<>
bitand(value,mask)
The value of "bitwise AND" of an item value and mask.
Supported value types: Integer.
Parameter:
- value - the value to check;
- mask (mandatory) - a 64-bit unsigned integer (0 - 18446744073709551615).
Although the comparison is done in a bitwise manner, all the values must be supplied and are returned in decimal. For example, checking for the 3rd bit is done by comparing to 4, not 100.
Examples:
bitand(last(/host/key),12)=8 or bitand(last(/host/key),12)=4 #3rd or 4th bit set, but not both at the same time
bitand(last(/host/key),20)=16 #3rd bit not set and 5th bit setbitlshift(value,bits to shift)
The bitwise shift left of an item value.
Supported value types: Integer.
Parameter:
- value - the value to check;
- bits to shift (mandatory) - the number of bits to shift.
Although the comparison is done in a bitwise manner, all the values must be supplied and are returned in decimal. For example, checking for the 3rd bit is done by comparing to 4, not 100.
bitnot(value)
The value of "bitwise NOT" of an item value.
Supported value types: Integer.
Parameter:
- value - the value to check.
Although the comparison is done in a bitwise manner, all the values must be supplied and are returned in decimal. For example, checking for the 3rd bit is done by comparing to 4, not 100.
bitor(value,mask)
The value of "bitwise OR" of an item value and mask.
Supported value types: Integer.
Parameter:
- value - the value to check;
- mask (mandatory) - a 64-bit unsigned integer (0 - 18446744073709551615).
Although the comparison is done in a bitwise manner, all the values must be supplied and are returned in decimal. For example, checking for the 3rd bit is done by comparing to 4, not 100.
bitrshift(value,bits to shift)
The bitwise shift right of an item value.
Supported value types: Integer.
Parameter:
- value - the value to check;
- bits to shift (mandatory) - the number of bits to shift.
Although the comparison is done in a bitwise manner, all the values must be supplied and are returned in decimal. For example, checking for the 3rd bit is done by comparing to 4, not 100.
bitxor(value,mask)
The value of "bitwise exclusive OR" of an item value and mask.
Supported value types: Integer.
Parameter:
- value - the value to check;
- mask (mandatory) - a 64-bit unsigned integer (0 - 18446744073709551615).
Although the comparison is done in a bitwise manner, all the values must be supplied and are returned in decimal. For example, checking for the 3rd bit is done by comparing to 4, not 100.