CODESYS String Libraries

Les bibliothèques du CODESYS String Libraries Le package peut être utilisé pour traiter des chaînes codées en UTF-8. La base est IString interface depuis String Segments bibliothèque. À l'aide de cette interface, les chaînes peuvent être transmises aux fonctions respectives par référence. Par exemple, pour créer un IString exemple, le GSB.UTF8String bloc de fonction du Generic String Base une bibliothèque est fournie.

Les nouvelles bibliothèques de chaînes peuvent également gérer de grandes chaînes de manière efficace. La longueur des cordes est quasiment illimitée. Pour cette raison, les bibliothèques sont également adaptées à l'édition de fichiers texte volumineux et de contenus Web.

Les nouvelles bibliothèques de chaînes vous permettent d'interroger une chaîne précédemment définie via les méthodes correspondantes, comme vous le savez dans d'autres langages de haut niveau.

udiStringLen := myString.Len();
if udiStringLen = 22 THEN
...

À partir du CODESYS 3.5.18.0, vous pouvez configurer le compilateur pour interpréter le contenu des variables de type STRING sous forme de codage UTF-8. Vous sélectionnez le Encodage UTF8 pour STRING option dans le Paramètres du projet dans le Options de compilation catégorie.

Si vous ne souhaitez pas tout traiter STRING variables d'un projet codées en UTF-8, vous devez désactiver cette option. Ensuite, vous pouvez appliquer le codage UTF-8 à des littéraux individuels STRING tapez au cas par cas.

{attribute 'monitoring_encoding' := 'UTF-8'}
sValue : STRING(140) := UTF8#'Ðα ṧтℯ♄ ḯḉℌ ηuη, i¢ℌ αямℯґ 𝕋øґ‼ Ṳᾔⅾ ♭ḯη ＄☺ ḱℓυℊ αł＄ ωⅈ℮ ẕυ√◎ґ';

Grâce aux capacités de l'encodage UTF-8, vous n'avez pas besoin d'utiliser WSTRING type de données dans CODESYS pour utiliser un jeu de caractères étendu. encodage UCS-2 WSTRING est basé sur, peut nécessiter plus de mémoire qu'un codage UTF-8, selon l'application. Le codage UCS-2 en utilise toujours WORD par caractère et ne peut représenter que les personnages U+0000 à U+D800 et U+DFFF à U+FFFD. Le codage UTF-8 nécessite entre un et quatre octets par caractère. Par conséquent, tous les caractères Unicode peuvent être traités

Avec le codage UTF-8, si vous essayez d'obtenir un caractère spécifique à l'aide d'un index spécifique, cela entraînera des résultats inattendus en raison de la longueur variable.

{attribute 'monitoring_encoding' := 'UTF-8'}
sValue : STRING(140) := UTF8#'Ðα ṧтℯ♄ ḯḉℌ ηuη, i¢ℌ αямℯґ 𝕋øґ‼ Ṳᾔⅾ ♭ḯη ＄☺ ḱℓυℊ αł＄ ωⅈ℮ ẕυ√◎ґ';

byValue := sValue[13]; // The 'u' is NOT the 13th character in the string
xOk := byValue <> 16#75;

Vous devez déterminer l'index d'un caractère en parcourant la chaîne.

Exemple 4. Itération sur des chaînes codées en UTF-8

VAR	
    {attribute 'monitoring_encoding' := 'UTF-8'}
    sValue : STRING(140) := UTF8#'Ðα ṧтℯ♄ ḯḉℌ ηuη, i¢ℌ αямℯґ 𝕋øґ‼ Ṳᾔⅾ ♭ḯη ＄☺ ḱℓυℊ αł＄ ωⅈ℮ ẕυ√◎ґ';

    fbsValue : STR.UTF8Literal := (psValue:=ADR(sValue)); 
    fbRange : STR.Range := (itfString:=fbsValue);
    diRune : STR.RUNE;
    udiIndex, udiLength : UDINT;
    xOk : BOOL;
END_VAR
 
WHILE (diRune := fbRange.GetNextRune(udiLength=>udiLength)) <> 0 DO
    IF diRune = 16#75 (* 'u' *) THEN
        EXIT;
    END_IF
    udiIndex := udiIndex + udiLength;
END_WHILE
 
xOk := sValue[udiIndex] = 16#75 (* 'u' *);

Dans le cadre précédemment établi STRING fonctions de la bibliothèque standard, les paramètres de type STRING sont copiés lorsqu'ils sont transmis aux fonctions. La valeur de retour est également copiée dans une variable avec l'affectation.

VAR
    sValue : STRING;
END_VAR
 
sValue := CONCAT(CONCAT(CONCAT('Da steh ich nun,', ' ich armer Tor!'), ' Und bin so'), ' klug als wie zu vor');
//                              -> Copy, LEN       -> Copy, LEN        -> Copy, LEN    -> Copy, LEN
//        -> 2xCopy, LEN
//               -> 2xCopy, LEN
//                      -> 2xCopy, LEN

Avant de traiter les paramètres de type STRING dans les fonctions respectives, leur longueur doit souvent être déterminée par itération jusqu'au caractère nul final. Pour les chaînes plus longues, ces opérations de copie et d'itération augmentent le temps de traitement de l'application. La longueur des chaînes est limitée à 255 caractères pour l'application de ces fonctions.

Le STR.IString interface a été introduite pour transmettre la structure de données qui gère les informations relatives à une chaîne par référence. Il s'agit d'une différence majeure par rapport aux fonctions STRING précédemment établies, qui n'implémentent pas le STR.IString interface.

De plus, la taille d'une chaîne (la mémoire respective pour les caractères codés UTF-8) peut être comprise dans la plage numérique UDINT 4 ≦ udiSize ≦ 16#FFFF_FF00).

VAR
    itfString : STR.IString;
    udiLength, udiSize, udiRuneCount : UDINT;
    pbySegment : POINTER TO BYTE;
    xValid : BOOL;
END_VAR
 
udiLength := itfString.Len(); // Current length in byte
pbySegment := itfString.GetSegment(udiSize=>udiSize); // Address first byte, capacity of the segment in bytes
udiRuneCount := STR.RuneCount(itfString); // Current number of "characters" in the segment
xValid := itfString.IsValid(); // Indication that a valid UTF-8 encoding is present.