STRING

Les littéraux chaînes de caractères se composent d’une suite de caractères ou de séquences d’échappement entre guillemets simples (').

Les littéraux chaînes de caractères peuvent être utilisés :

• Dans les éditeurs de déclaration pour initialiser une variable de type de données STRING

• Dans les corps d’un programme comme arguments d’entrée

Les littéraux chaînes de caractères suivants sont disponibles :

• Les littéraux chaînes de caractères codés Latin-1 permettant des caractères Unicode dans l’intervalle 0x00–0xFF

  • Littéraux chaînes de caractères codé Latin-1 non typés sans préfixe par ex. 'abc'. Ils génèrent un avertissement lorsqu’ils contiennent des caractères non ASCII dans l’intervalle 0x80–0xFF tels que 'äöü'.

    Exemples de littéraux chaînes de caractères Latin-1 non typés :

    Bloc Unicode	Littéral chaîne de caractères Latin-1 non typé	Octets en représentation hexadécimale	Remarque
    Chaîne de caractères vide	''	''
    Latin de base (0x00–0x7F)	'!"#+-*/<>='	' 21 22 23 2B 2D 2A 2F 3C 3E 3D'
    	'?@/{}[]~'	' 3F 40 2F 7B 7D 5B 5D 7E'
    	'0-9'	' 30 2D 39'
    	'A-Z,a-z'	' 41 2D 5A 2C 61 2D 7A'
    Supplément Latin-1 (0x80–0xFF)	'¥£©®'	' A5 A3 A9 AE'	Un message d’avertissement est généré.
    	'歨'	' B5 A1 BF'
    	'äöüß'	' E4 F6 FC DF'
    	'ÄÖÜ'	' C4 D6 DC'

  • Littéraux chaînes de caractères codés Latin-1 typés avec le préfixe latin1# par ex. latin1#'abc' ou latin1#'äöü'.

    Exemples de littéraux chaînes de caractères Latin-1 typés :

    Bloc Unicode	Littéral chaîne de caractères Latin-1 typé	Octets en représentation hexadécimale	Remarque
    Chaîne de caractères vide	latin1#''	''
    Latin de base (0x00–0x7F)	latin1#'!"#+-*/<>='	' 21 22 23 2B 2D 2A 2F 3C 3E 3D'
    	latin1#'?@/{}[]~'	' 3F 40 2F 7B 7D 5B 5D 7E'
    	latin1#'0-9'	' 30 2D 39'
    	latin1#'A-Z,a-z'	' 41 2D 5A 2C 61 2D 7A'
    Supplément Latin-1 (0x80–0xFF)	latin1#'¥£©®'	' A5 A3 A9 AE'	Aucun message d’avertissement n’est généré.
    	latin1#'歨'	' B5 A1 BF'
    	latin1#'äöüß'	' E4 F6 FC DF'
    	latin1#'ÄÖÜ'	' C4 D6 DC'

• Littéraux chaînes de caractères en UTF-8

  Les littéraux chaînes de caractères codés UTF-8 avec le préfixe utf8# par ex. utf8#'abc', utf8#'äöü' ou utf8#'ä+漢+🙏' peuvent coder tous les caractères Unicode dans l’intervalle 0x00–0x10FFFF en 1 à 4 octets.

  Exemples de littéraux chaînes de caractères UTF-8 :

  Octets par caractère	Bloc Unicode	Littéral chaîne de caractères en UTF-8	Octets en représentation hexadécimale
  	Chaîne de caractères vide	utf8#''	''
  1	Latin de base	utf8#'!"#+-*/<>='	' 21 22 23 2B 2D 2A 2F 3C 3E 3D'
  		utf8#'?@/{}[]~'	' 3F 40 2F 7B 7D 5B 5D 7E'
  		utf8#'0-9'	' 30 2D 39'
  		utf8#'A-Z,a-z'	' 41 2D 5A 2C 61 2D 7A'
  2	Supplément latin 1	utf8#'¥£©®'	' C2 A5 C2 A3 C2 A9 C2 AE'
  		utf8#'歨'	' C2 B5 C2 A1 C2 BF'
  		utf8#'äöüß'	' C3 A4 C3 B6 C3 BC C3 9F'
  		utf8#'ÄÖÜ'	' C3 84 C3 96 C3 9C'
  	Grec	utf8#'αβγ'	' CE B1 CE B2 CE B3'
  3	CJK Hirakana	utf8#'ゖ'	' E3 82 96'
  	CJK Katakana	utf8#'ヺ'	' E3 83 BA'
  	CJK Unified	utf8#'囆'	' E5 9B 86'
  4	CJK Unified	utf8#'𫜴'	' F0 AB 9C B4'
  	Emoticône	utf8#'🙏'	' F0 9F 99 8F'

• Séquences d’échappement

  Les séquences d’échappement peuvent être utilisées dans des littéraux chaînes de caractères 8 bits et des littéraux chaînes de caractères en UTF-8.

  La combinaison de trois caractères, le signe dollar ($) suivi de deux chiffres hexadécimaux, doit être interprétée comme la représentation hexadécimale du code de caractères 8 bits.

  Littéral chaîne de caractères		Octets en représentation hexadécimale	Remarque
  '$02$03'	utf8#'$02$03'	' 02 03'	STX, ETX
  '$E5$9B$86'	utf8#'$E5$9B$86'	' E5 9B 86'	utf8#'囆'
  '$F0$9F$99$8F'	utf8#'$F0$9F$99$8F'	' F0 9F 99 8F'	utf8#'🙏'

  NOTA

  • Si une séquence d’octets UTF-8 entrée dans une chaîne de caractères en UTF-8 est invalide, le résultat sera une chaîne de caractères en UTF-8 invalide.

    Exemple

    Entrée	utf8#'敬 敬$FE$FF敬 具' (' E6 95 AC FE FF E5 85 B7') sString10 défini en tant que STRING[10]
    Opération	sString10:= utf8#'敬敬$FE$FF敬具'
    Résultat	sString10: utf8?'敬敬þÿ敬具' (' E6 95 AC FE FF E5 85 B7')

  • La combinaison de deux caractères commençant par le signe dollar doit être interprétée de la façon suivante :

    Littéral chaîne de caractères		Octets en représentation hexadécimale	Remarque
    '$$'	utf8#'$$'	' 24'	Signe dollar
    '$''	utf8#'$''	' 27'	Guillemet simple
    '$L' ou '$l'	utf8#'$L' ou utf8#'$l'	' 0A'	Interligne
    '$N' ou '$n'	utf8#'$N' ou utf8#'$n'	' 0D 0A'	nouvelle ligne
    '$P' ou '$p'	utf8#'$P' ou utf8#'$p'	' 0C'	Page suivante
    '$R' ou '$r'	utf8#'$R' ou utf8#'$r'	' 0D'	Retour chariot
    '$T' ou '$t'	utf8#'$T' ou utf8#'$t'	' 09'	Tabulateur

Pendant le monitoring, sélectionnez la représentation par défaut pour voir les octets chaînes de caractères affichés correctement selon le codage de caractères détecté :

Pour déclarer des variables de type STRING dans l’en-tête du POU, utilisez la syntaxe suivante :

STRING[n], n = nombre d’octets

La valeur initiale par défaut, par ex. pour les déclarations de variables dans l’en-tête du POU ou la liste des variables globales, est ", c.-à-d. une chaîne de caractères vide.

Critères d’invalidité d’une chaîne de caractères :

• Le nombre d’octets maximum, réservé pour les caractères de la chaîne de caractères, est négatif ou supérieur à 32767.

• Le nombre d’octets actuel, contenu dans les caractères de la chaîne de caractères, est négatif ou supérieur à 32767.

• Le nombre d’octets actuel, contenu dans les caractères de la chaîne de caractères, est supérieur au nombre d’octets maximum réservé pour la chaîne de caractères.

Chaque caractère de la chaîne est sauvegardé dans un octet. La zone mémoire de la chaîne de caractères se compose d’un en-tête (deux mots) et d’un mot pour deux caractères.

• Le premier mot contient le nombre d’octets, réservé pour la chaîne de caractères.

• Le second mot contient le nombre actuel d’octets dans la chaîne de caractères.

• Les mots suivants contiennent chacun deux octets des caractères de la chaîne de caractères.

Pour réserver une certaine zone mémoire pour STRING[n], indiquez la longueur de la chaîne de caractères à l’aide de la formule suivante :

Taille de la mémoire = 2 mots (en-tête) + (n+1)/2 mots (octets).

La mémoire est organisée en mots. Par conséquent, les nombres de mots sont toujours arrondis au nombre supérieur suivant.

• Les codages de caractères Latin-1 et UTF-8 traitent les caractères dans l’intervalle 0x00–0x7F de manière identique aux caractères ASCII tels qu’ils sont définis dans le bloc Unicode Commandes C0 et Latin de base.

  

• Le codage de caractères Latin-1 traite les caractères dans l’intervalle 0x80–0xFF, tels qu’ils sont définis dans le bloc Unicode Commandes C1 et Supplément Latin-1.

  

• Le codage de caractères UTF-8 traite les caractères à partir de 0x80 ainsi :

  Séquence d’octets UTF-8 (représentation binaire)	Intervalle Unicode
  0xxxxxxx	0000 0000 – 0000 007F
  110xxxxx 10xxxxxx	0000 0080 – 0000 07FF
  1110xxxx 10xxxxxx 10xxxxxx	0000 0800 – 0000 FFFF
  11110xxx 10xxxxxx 10xxxxxx 10xxxxxx	0001 0000 – 0010 FFFF

  Comment utiliser le codage de caractères UTF-8

  • Précautions

    Un traitement correct du codage des caractères UTF-8 par les instructions du firmware n’est pas garanti. Une vérification détaillée est requise !

  • Remarques

    • Lorsque vous utilisez des chaînes de caractères en UTF-8, il est fortement recommandé d’utiliser exclusivement des chaînes de caractères en UTF-8 et d’éviter de mélanger des chaînes de caractères en UTF-8 et des chaînes de caractères non-UTF-8 !

    • Si vous mélangez des chaînes de caractères en UTF-8 et des chaînes de caractères non-UTF-8, les chaînes de caractères non-UTF-8 doivent uniquement contenir des caractères dans l’intervalle 0x00–0x7F.

    • Les fonctions telles que LEN, MID, LEFT; INSERT, DELETE, RIGHT sont orientées octets. Lorsqu’elles sont utilisées avec des chaînes de caractères en UTF-8, il est possible que les nombres et les positions des octets pris en compte par la fonction ne correspondent pas aux nombres et aux positions des caractères de la chaîne de caractères en UTF-8.

      Exemple

      Entrée	utf8#'敬具' (' E6 95 AC E5 85 B7')
      Opération	LEN(utf8#'敬具')
      Résultat	6

    • Lorsque des fonctions chaînes de caractères orientées octets sont appliquées à des chaînes de caractères en UTF-8 avec des nombres et positions d’octets qui ne correspondent pas à la taille et à la position de l’octet de départ des caractères UTF-8, le résultat sera une chaîne de caractères en UTF-8 invalide.

      Exemple

      Entrée	utf8#'敬具' (' E6 95 AC E5 85 B7')
      Opération	MID(IN := utf8#'敬具', L := 3, P := 4)
      Résultat	utf8#'具' (' E5 85 B7')
      Opération	MID(IN := utf8#'敬具', L := 3, P := 3)
      Résultat	'¬å$85' (' AC E5 85')

    • Si le résultat est une chaîne de caractères en UTF-8 de taille supérieure à la chaîne de caractères de destination, le résultat peut être une chaîne de caractères en UTF-8 invalide.

      Exemple

      Entrée	utf8#'敬具' (' E6 95 AC E5 85 B7') sString5 défini en tant que STRING[5]
      Opération	sString5:=utf8#'敬具'
      Résultat	sString5: utf8?'敬å$85' (' E6 95 AC E5 85')

    • Les caractères spéciaux dans l’intervalle Unicode 0x80–0xFF génèrent des résultats différents selon qu’ils sont entrés en tant que chaînes de caractères 8 bits ou en tant que chaînes de caractères en UTF-8.

      Exemple

      Entrée	'ö' (' F6') utf8#'ö' (' C3 B6')
      Opération	LEN('ö')
      Résultat	1
      Opération	LEN(utf8#'ö')
      Résultat	2
      Opération	'ö'= utf8#'ö'
      Résultat	FALSE

    • Rechercher une chaîne de caractères 8 bits avec des caractères dans l’intervalle 0x80–0xFF dans une chaîne de caractères en UTF-8 et vice versa peut aboutir à des résultats inattendus.

      Exemple

      Entrée	utf8#'敬具' (' E6 95 AC E5 85 B7') 'å' (' E5')
      Opération	FIND(IN1 := utf8#'敬具', IN2 :='å')
      Résultat	4

Schéma à contacts (LD) et diagramme de blocs fonctions (FBD)

Les instructions STRING avec contacts entrées et sorties de validation EN/ENO ne peuvent pas être connectées les unes aux autres en LD et FBD. Connectez d’abord des instructions sans EN/ENO puis ajoutez une instruction avec EN/ENO en dernière position. L’entrée de validation (EN) contrôle la sortie du résultat général.

Cette disposition n’est pas possible :

Cette disposition est possible :