Opérateurs sur les bits

4D v16.3

Les opérateurs sur les bits s'appliquent à des expressions ou valeurs de type Entier long.

Note : Si vous passez une valeur de type Entier ou Réel à un opérateur sur les bits, 4D la convertit en Entier long avant de calculer le résultat de l'expression.

Lorsque vous employez des opérateurs sur les bits, vous devez considérer une valeur de type Entier long comme un tableau de 32 bits. Les bits sont numérotés de 0 à 31, de droite à gauche.

Comme un bit peut valoir 0 (zéro) ou 1, vous pouvez également considérer une valeur de type Entier long comme une expression dans laquelle vous pouvez stocker 32 valeurs de type Booléen. Lorsque le bit vaut 1, la valeur est Vrai et lorsque le bit vaut 0, la valeur est Faux.

Une expression utilisant un opérateur sur les bits retourne une valeur de type Entier long, à l'exception de l'opérateur Tester bit avec lequel l'expression retournée est du type Booléen. Le tableau suivant fournit la liste des opérateurs sur les bits et leur syntaxe :

Opération	Opérateur	Syntaxe	Retourne
ET	&	E.long & E.long	E.long
OU (inclusif)	\|	E.long \| E.long	E.long
OU (exclusif)	^\|	E.long ^\| E.long	E.long
Décaler bits à gauche	<<	E.long << E.long	E.long	(voir note 1)
Décaler bits à droite	>>	E.long >> E.long	E.long	(voir note 1)
Mettre bit à 1	?+	E.long ?+ E.long	E.long	(voir note 2)
Mettre bit à 0	?-	E.long ?- E.long	E.long	(voir note 2)
Tester bit	??	E.long ?? E.long	Booléen	(voir note 2)

Notes
1. Dans les opérations utilisant Décaler bits à gauche et Décaler bits à droite, le second opérande indique le nombre de décalages de bits du premier opérande à effectuer dans la valeur retournée. Par conséquent, ce second opérande doit être compris entre 0 et 31. Notez qu'un décalage de 0 retourne une valeur inchangée et qu'un décalage de plus de 31 bits retourne 0x00000000 car tous les bits sont perdus. Si vous passez une autre valeur en tant que second opérande, le résultat sera non significatif.
2. Dans les opérations utilisant Mettre bit à 1, Mettre bit à 0 et Tester bit, le second opérande indique le numéro du bit sur lequel agir. Par conséquent, ce second opérande doit être compris entre 0 et 31, sinon le résultat de l'expression sera non significatif.

Le tableau suivant dresse la liste des opérateurs sur les bits et de leurs effets :

Opération sur les bits	Description
ET	Chaque bit retourné est le résultat de l'opération ET logique appliquée aux deux bits opérandes.
	Voici la table du ET logique :
	1 & 1 --> 1
	0 & 1 --> 0
	1 & 0 --> 0
	0 & 0 --> 0
	En résumé, le résultat vaut 1 si les deux bits opérandes valent 1, dans tous les autres cas le bit résultant vaut 0.
OU (inclusif)	Chaque bit retourné est le résultat de l'opération OU inclusif logique appliquée aux deux bits opérandes.
	Voici la table du OU inclusif logique :
	1 \| 1 --> 1
	0 \| 1 --> 1
	1 \| 0 --> 1
	0 \| 0 --> 0
	En résumé, le résultat vaut 1 si au moins un des deux bits opérandes vaut 1, sinon le bit résultant vaut 0.
OU (exclusif)	Chaque bit retourné est le résultat de l'opération OU exclusif logique appliquée aux deux bits opérandes.
	Voici la table du OU exclusif logique:
	1 ^\| 1 --> 0
	0 ^\| 1 --> 1
	1 ^\| 0 --> 1
	0 ^\| 0 --> 0
	Donc, le résultat vaut 1 si un seul des deux bits opérandes vaut 1 (et pas l'autre), dans tous les autres cas le bit résultant vaut 0.
Décaler bits à gauche	La valeur retournée correspond au premier opérande dont la valeur est décalée vers la gauche du nombre de bits spécifié par le second opérande. Les bits auparavant situés à gauche sont perdus et les nouveaux bits situés à droite ont la valeur 0.
	Note : En ne tenant compte que des valeurs positives, un décalage vers la gauche de N bits revient à multiplier la valeur par 2^N.
Décaler bits à droite	La valeur retournée correspond au premier opérande dont la valeur est décalée vers la droite du nombre de bits spécifié par le second opérande. Les bits auparavant situés à droite sont perdus et les nouveaux bits situés à gauche ont la valeur 0.
	Note : En ne tenant compte que des valeurs positives, un décalage vers la droite de N bits revient à diviser la valeur par 2^N.
Mettre bit à 1	La valeur retournée est la valeur du premier opérande dans lequel le bit dont le numéro est spécifié par le second opérande est positionné à 1. Les autres bits sont inchangés.
Mettre bit à 0	La valeur retournée est la valeur du premier opérande dans lequel le bit dont le numéro est spécifié par le second opérande est positionné à 0. Les autres bits sont inchangés.
Tester bit	Retourne Vrai si, dans le premier opérande, le bit dont le numéro est indiqué par le second opérande vaut 1. Retourne Faux si, dans le premier opérande, le bit dont le numéro est indiqué par le second opérande vaut 0.

Exemple

(1) Le tableau ci-dessous propose un exemple d'utilisation de chaque opérateur sur les bits :

Opération	Exemple	Résultat
ET	0x0000FFFF & 0xFF00FF00	0x0000FF00
OU (inclusif)	0x0000FFFF \| 0xFF00FF00	0xFF00FFFF
OU (exclusif)	0x0000FFFF ^\| 0xFF00FF00	0xFF0000FF
Décaler bit gauche	0x0000FFFF << 8	0x00FFFF00
Décaler bit droit	0x0000FFFF >> 8	0x000000FF
Mettre bit à 1	0x00000000 ?+ 16	0x00010000
Mettre bit à 0	0x00010000 ?- 16	0x00000000
Tester bit	0x00010000 ?? 16	Vrai

(2) 4D exploite de nombreuses constantes prédéfinies. Le nom de certaines d'entre elles commence par "Bit" ou "Masque". C'est le cas des constantes incluses dans le thème Propriétés des ressources :

Constante	Type	Valeur
Changed resource bit	Entier long	1
Changed resource mask	Entier long	2
Locked resource bit	Entier long	4
Locked resource mask	Entier long	16
Preloaded resource bit	Entier long	2
Preloaded resource mask	Entier long	4
Protected resource bit	Entier long	3
Protected resource mask	Entier long	8
Purgeable resource bit	Entier long	5
Purgeable resource mask	Entier long	32
System heap resource bit	Entier long	6
System heap resource mask	Entier long	64

Ces constantes vous permettent de tester la valeur retournée par la fonction Get resource properties ou de définir la valeur à passer à _o_SET RESOURCE PROPERTIES. Les constantes dont le nom débute par “Bit” fournissent la position du bit que vous voulez tester, effacer ou fixer. Les constantes dont le nom débute par “Masque” sont des valeurs de type Entier long dans lesquelles seul le bit que vous voulez tester, effacer ou fixer est égal à 1.

Si, par exemple, vous devez tester si une ressource (dont les propriétés sont stockées dans la variable $vlResAttr) est purgeable ou non, vous pouvez écrire :

If($vlResAttr ?? Bit ressource purgeable) ` Est-ce que la ressource est purgeable?

ou :

If(($vlResAttr & Purgeable resource mask)#0) ` Est-ce que la ressource est purgeable?

A l'inverse, vous pouvez utiliser ces constantes pour définir le même bit. Vous pouvez écrire :

$vlResAttr:=$vlResAttr ?+Purgeable resource bit

ou :

$vlResAttr:=$vlResAttr |Purgeable resource bit

(3) Vous voulez stocker deux valeurs entières dans un Entier long. Vous pouvez écrire :

 $vlLong:=($viIntA<<16)|$viIntB  ` Stocker deux Entiers dans un Entier long

 $vlIntA:=$vlLong>>16 ` Extraire l'Entier stocké dans le mot haut

 $viIntB:=$vlLong  & 0xFFFF ` Extraire l'entier stocké dans le mot bas

Note : Soyez prudent lorsque vous manipulez des Entiers longs ou des Entiers avec des expressions qui combinent des opérateurs sur les bits et des opérateurs numériques. Le bit supérieur (bit 31 pour un Entier long, bit 15 pour un Entier) détermine le signe de la valeur (positif s'il est à 0, négatif s'il est à 1). Les opérateurs numériques utilisent ce bit pour détecter le signe d'une valeur, mais les opérateurs sur les bits n'en tiennent pas compte.

Voir aussi

Opérateurs
Opérateurs de comparaison
Opérateurs logiques
Opérateurs numériques
Opérateurs sur les chaînes
Opérateurs sur les dates
Opérateurs sur les heures
Opérateurs sur les images