Documentation
2 Fonctions binaires
Toutes les fonctions répertoriées ici sont prises en charge dans :
Quelques notes générales sur les paramètres de fonction :
- Les paramètres de fonction sont séparés par une virgule
- Les expressions sont acceptées comme paramètres
- Les paramètres de fonction optionnels (ou parties de paramètres) sont indiqués par
<>
| FONCTION | ||
|---|---|---|
| Description | Paramètres spécifiques à la fonction | Commentaires |
| bitand (valeur,masque) | ||
| Valeur de "ET binaire" d'une valeur d'élément et d'un masque. | valeur : valeur à vérifier masque (obligatoire) : entier non signé 64 bits (0 - 18446744073709551615) |
Types de valeur pris en charge : int Bien que la comparaison se fasse au niveau du bit, toutes les valeurs doivent être fournies et sont renvoyées en décimal. Par exemple, la vérification du 3e bit est effectuée en comparant à 4, et non à 100. Exemples : => bitand(last(/host/key),12 )=8 ou bitand(last(/host/key),12)=4 → 3ème ou 4ème bit défini, mais pas les deux en même temps => bitand (last(/host/key),20)=16 → 3e bit non défini et 5e bit défini. |
| bitlshift (valeur,bits à décaler) | ||
| Décalage au niveau du bit à gauche d'une valeur d'élément. | valeur : valeur à vérifier bits à décaler (obligatoire) : nombre de bits à décaler |
Types de valeurs pris en charge : int Bien que la comparaison se fasse au niveau du bit, toutes les valeurs doivent être fournies et sont renvoyées en décimal. Par exemple, la vérification du 3e bit se fait en comparant à 4, et non à 100. |
| bitnot (valeur) | ||
| Valeur de "NON binaire" d'une valeur d'élément. | valeur - valeur à vérifier |
Types de valeur pris en charge : int Bien que la comparaison soit effectuée au niveau du bit, toutes les valeurs doivent être fournis et sont retournés en décimal. Par exemple, la vérification du 3e bit se fait en comparant à 4, et non à 100. |
| bitor (valeur,masque) | ||
| Valeur de "OU binaire" d'une valeur d'élément et d'un masque. | valeur : valeur à vérifier masque (obligatoire) : entier non signé 64 bits (0 - 18446744073709551615) |
Types de valeur pris en charge : int Bien que la comparaison se fasse au niveau du bit, toutes les valeurs doivent être fournies et sont renvoyées en décimal. Par exemple, la vérification du 3e bit se fait en comparant à 4, et non à 100. |
| bitrshift (valeur,bits à décaler) | ||
| Décalage au niveau du bit vers la droite d'une valeur d'élément. | valeur : valeur à vérifier bits à décaler (obligatoire) : nombre de bits à décaler |
Types de valeurs pris en charge : int Bien que la comparaison se fasse au niveau du bit, toutes les valeurs doivent être fournies et sont renvoyées en décimal. Par exemple, la vérification du 3e bit se fait en comparant à 4, et non à 100. |
| bitxor (valeur,masque) | ||
| Valeur du "OU exclusif binaire" d'une valeur d'élément et d'un masque. | valeur : valeur à vérifier masque (obligatoire) : entier non signé 64 bits (0 - 18446744073709551615) |
Valeur prise en charge types : int Bien que la comparaison se fasse au niveau du bit, toutes les valeurs doivent être fournies et sont renvoyées en décimal. Par exemple, la vérification du 3e bit se fait en comparant à 4, et non à 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.