ROL_*** : décalage circulaire vers la gauche

Description de la fonction

La fonction ROL_*** décale de manière circulaire les éléments d'un tableau, dans le sens croissant des index.

Les paramètres supplémentaires et peuvent être configurés.

Fonctions disponibles

Les fonctions disponibles dans la bibliothèque générale sont les suivantes :

ROL_ARWORD,
ROL_ARDWORD,
ROL_ARINT,
ROL_ARDINT,
ROL_ARREAL.

Représentation en FBD

Représentation appliquée à un tableau d'entiers :

Représentation en LD

Représentation appliquée à un tableau d'entiers :

Représentation en IL

Représentation appliquée à un tableau d'entiers :

LD Positions

ROL_ARINT Array1

Représentation en ST

Représentation appliquée à un tableau d'entiers :

ROL_ARINT(Positions, Array1);

Description des paramètres

Le tableau suivant décrit le paramètre d'entrée :

Paramètre	Type	Commentaire
Positions	INT	Valeur de décalage selon les index croissants du tableau. Exemple : Positions = 2. Remarque : Si la valeur de Positions est négative ou nulle, aucun décalage n'est effectué.

Le tableau suivant décrit les paramètres d'E/S :

Paramètre	Type	Commentaire
Array1	ARRAY [n..m] OF WORD, ARRAY [n..m] OF DWORD, ARRAY [n..m] OF INT, ARRAY [n..m] OF DINT ARRAY [n..m] OF REAL	Les éléments de Array1 sont déplacés d'un certain nombre de positions égal à Positions. Le décalage est effectué selon les index croissants. Exemple : Avec un registre de décalage de 2, l'élément situé à la première position passe à la troisième position (1+2), le deuxième à la quatrième (2+2)..., l'avant-dernier à la première et le dernier à la deuxième.

EN correspond à ENable (activer) ; il s'agit d'une entrée de bloc facultative. Quand l'entrée EN est activée, une sortie ENO est automatiquement définie.

Si EN = 0, le bloc n'est pas activé, son programme interne n'est pas exécuté et ENO est réglé sur 0.

Si EN = 1, le programme interne du bloc est exécuté et ENO est réglé sur 1. Si une erreur survient, ENO reprend la valeur 0.

Si l'entrée EN n'est pas connectée, elle est automatiquement réglée sur 1.

ENO

ENO signifie Error NOtification (notification d'erreur). C'est la sortie associée à l'entrée facultative EN.

Si ENO est réglé sur 0 (car EN = 0 ou en cas d'erreur d'exécution) :

les sorties du bloc fonction restent dans l'état qui était le leur lors du dernier cycle de scrutation exécuté correctement ;
la ou les sorties de la fonction, ainsi que les procédures, sont réglées sur 0.

WORD

Le type WORD est codé dans un format 16 bits et sert à effectuer des traitements sur des chaînes de bits.

Le tableau ci-dessous donne les limites inférieure/supérieure des bases qui peuvent être utilisées :

Base	Limite inférieure	Limite supérieure
Hexadécimale	16#0	16#FFFF
Octale	8#0	8#177777
Binaire	2#0	2#1111111111111111

Exemples de représentation

Données	Représentation dans l'une des bases
0000000011010011	16#D3
1010101010101010	8#125252
0000000011010011	2#11010011

DWORD

DWORD est l'acronyme de « Double Word » (mot double).

Le type DWORD est codé dans un format 32 bits.

Le tableau ci-dessous donne les limites inférieure/supérieure des bases qui peuvent être utilisées :

Base	Limite inférieure	Limite supérieure
Hexadécimale	16#0	16#FFFFFFFF
Octale	8#0	8#37777777777
Binaire	2#0	2#11111111111111111111111111111111

Exemples de représentation :

Données	Représentation dans l'une des bases
00000000000010101101110011011110	16#ADCDE
00000000000000010000000000000000	8#200000
00000000000010101011110011011110	2#10101011110011011110

REAL

Le type REAL (réel) est codé sur 32 bits.

Les plages de valeurs possibles sont indiquées dans la figure suivante :

Lorsqu'un résultat est :

compris entre -1,175494e-38 et 1,175494e-38, il est considéré comme étant un DEN ;
inférieur à -3,402824e+38, le symbole -INF (pour - infini) s'affiche ;
supérieur à +3,402824e+38, le symbole INF (pour + infini) s'affiche ;
indéfini (racine carrée d'un nombre négatif), le symbole NAN s'affiche.

NOTE : La norme CEI 559 définit deux catégories de NAN : le NAN silencieux (QNAN) et le NAN de signalement (SNAN). Un QNAN est un NAN (Not a Number) avec un bit de fraction de poids fort tandis qu'un SNAN est un NAN sans bit de fraction de poids fort (bit numéro 22). Les QNAN peuvent être propagés par la plupart des opérations arithmétiques, sans générer d'exception. Quant aux SNAN, ils signalent en général une opération non valide lorsqu'ils sont utilisés en tant qu'opérandes dans des opérations arithmétiques (voir %SW17 et %S18).

NOTE : Lorsqu'un DEN (nombre non normalisé) est utilisé en tant qu'opérande, le résultat n'est pas significatif.