<< opérateur (Visual Basic)

Article
08/10/2011

Effectue un décalage arithmétique vers la gauche sur un modèle binaire.

result = pattern << amount

Éléments

result
Obligatoire. Valeur numérique intégrale. Le résultat du décalage du modèle binaire. Le type de données est le même que celui de pattern.
pattern
Obligatoire. Expression numérique intégrale. Modèle binaire qui doit être décalé. Le type de données doit être un type entier (SByte, Byte, Short, UShort, Integer, UInteger, Long ou ULong).
amount
Obligatoire. Expression numérique. Le nombre de bits pour décaler le modèle binaire. Le type de données doit être Integer ou s'étendre à Integer.

Notes

Les décalages arithmétiques ne sont pas circulaires, ce qui signifie que les bits décalés à une extrémité du résultat ne sont pas réintroduits à l'autre extrémité. Dans un décalage arithmétique vers la gauche, les bits décalés au-delà de la plage du type de données de résultat sont ignorés, et les positions des bits libérées à droite ont la valeur zéro.

Pour empêcher que le décalage soit effectué par plus de bits que ne peut en contenir le résultat, Visual Basic masque la valeur de amount avec un masque de taille correspondant au type de données de pattern. L'opérateur binaire AND de ces valeurs est utilisé pour le nombre de positions de décalage. Les masques de taille sont les suivants :

Type de données de pattern	Masque de taille (décimal)	Masque de taille (hexadécimal)
SByte, Byte	7	&H00000007
Short, UShort	15	&H0000000F
Integer, UInteger	31	&H0000001F
Long, ULong	63	&H0000003F

Si la valeur de amount est zéro, la valeur de result est identique à la valeur de pattern. Si la valeur de amount est négative, elle est considérée comme une valeur non signée et masquée avec le masque de taille approprié.

Les décalages arithmétiques ne génèrent jamais d'exception de dépassement de capacité.

Notes

L'opérateur << peut être surchargé, ce qui signifie qu'une classe ou une structure peut redéfinir son comportement lorsqu'un opérande a le type de cette classe ou de cette structure. Si votre code utilise cet opérateur sur une telle classe ou structure, assurez-vous que vous comprenez son comportement redéfini. Pour plus d'informations, consultez Procédures d'opérateur (Visual Basic).

Exemple

L'exemple suivant utilise l'opérateur << pour effectuer des décalages arithmétiques vers la gauche sur des valeurs intégrales. Le résultat a toujours le même type de données que celui de l'expression décalée.

Dim pattern As Short = 192
' The bit pattern is 0000 0000 1100 0000.
Dim result1, result2, result3, result4, result5 As Short
result1 = pattern << 0
result2 = pattern << 4
result3 = pattern << 9
result4 = pattern << 17
result5 = pattern << -1

Les résultats de l'exemple précédent sont les suivants :