Version: 20

String

String ("Chaîne") est un terme générique utilisé pour :

Les variables ou champs de type Texte : un champ, une variable ou une expression de type Texte peut contenir de 0 à 2 Go de texte.
Les variables ou champs de type alphanumérique : un champ alphanumérique peut contenir de 0 à 255 caractères (la limite est fixée lors de la définition du champ).

Constantes littérales de type chaîne

Une constante littérale de type chaîne est incluse entre des guillemets droits ("…"). En voici quelques exemples :

"Ajouter Enregistrements"
"Aucun enregistrement trouvé."
"Facture"

Une chaîne vide est spécifiée par la succession de deux guillemets ("").

Séquences d’échappement

Les séquences d’échappement suivantes peuvent être utilisées dans les chaînes :

Séquence d’échappement	Caractère remplacé
\n	LF (Retour ligne)
\t	HT (Tabulation)
\r	CR (Retour chariot)
\\	\ (Barre oblique inversée)
\"	" (Guillemets)

Note: Le caractère \ est utilisé comme séparateur dans les chemins d’accès sous Windows. Vous devez donc saisir un double \ lorsque vous souhaitez insérer une barre oblique inversée devant un caractère utilisé dans une des séquences d’échappement reconnues par 4D (ex : “C:\MesDocuments\Nouveaux.txt”).

Opérateurs sur les chaînes

Opération	Syntaxe	Retourne	Expression	Valeur
Concaténation	Chaîne + Chaîne	String	"abc" + "def"	"abcdef"
Répétition	Chaîne * Nombre	String	"ab" * 3	"ababab"
Egalité	Chaîne = Chaîne	Boolean	"abc" = "abc"	True
			"abc" = "abd"	False
Inégalité	Chaîne # Chaîne	Boolean	"abc" # "abd"	True
			"abc" # "abc"	False
Supérieur à	Chaîne > Chaîne	Boolean	"abd" > "abc"	True
			"abc" > "abc"	False
Inférieur à	Chaîne < Chaîne	Boolean	"abc" < "abd"	True
			"abc" < "abc"	False
Supérieur ou égal à	Chaîne >= Chaîne	Boolean	"abd" >= "abc"	True
			"abc" >= "abd"	False
Inférieur ou égal à	Chaîne <= Chaîne	Boolean	"abc" <= "abd"	True
			"abd" <= "abc"	False
Contient mot-clé	Chaîne % Chaîne	Boolean	"Alpha Bravo" % "Bravo"	True
			"Alpha Bravo" % "ravo"	False

Comparaisons de chaînes

Les chaînes sont toujours comparées caractère par caractère (hormis en cas de recherche par mot-clé, cf. ci-dessous).
Lors d'une comparaison de chaînes, 4D ne tient pas compte de la casse des caractères ; par exemple, "a"="A" retourne VRAI. Pour savoir si des caractères sont en majuscules ou en minuscules, vous devez comparer leurs codes de caractères. Par exemple, l'expression suivante retourne FAUX :

Character code("A")=Character code("a") // 65 n'est pas égal à 97

Lorsque des chaînes de caractères sont comparées, les caractères diacritiques sont comparés en utilisant la table de comparaison des caractères système de votre ordinateur. Par exemple, les expressions suivantes retournent VRAI :

     "n"="ñ"
     "n"="Ñ"
     "A"="å"
      // etc

Note : Les comparaisons de chaîne tiennent compte des spécificités du langage défini pour le fichier de données 4D (qui n'est pas toujours identique au langage défini pour le système).

Le joker (@)

Le langage 4D prend en charge @ en tant que joker. Ce caractère peut être utilisé dans toute comparaison de chaînes. Ainsi, par exemple, l'expression suivante est évaluée à TRUE :

"abcdefghij"="abc@"

Le joker doit être utilisé dans le second opérande (la chaîne qui se trouve à droite de l'opérateur). L'expression suivante est évaluée à FAUX car le joker est alors considéré en tant que caractère :

    "abc@"="abcdefghij"

Le joker signifie “un ou plusieurs caractères sinon rien”. Les expressions suivantes sont évaluées à VRAI :

     "abcdefghij"="abcdefghij@"
     "abcdefghij"="@abcdefghij"
     "abcdefghij"="abcd@efghij"
     "abcdefghij"="@abcdefghij@"
     "abcdefghij"="@abcde@fghij@"

En revanche, dans tous les cas, lorsque deux jokers consécutifs sont placés dans une comparaison de chaînes, celle-ci sera évaluée à FAUX. L'expression suivante est à FAUX :

"abcdefghij"="abc@@fg"

Lorsque l'opérateur de comparaison est ou contient un symbole < ou >, seule la comparaison avec un seul joker situé en fin d'opérande est prise en charge :

     "abcd"<="abc@" //Comparaison valide
 "abcd"<="abc@ef" //Comparaison non valide

Si vous souhaitez effectuer des comparaisons ou des recherches utilisant @ en tant que caractère (et non en tant que joker), vous devez utiliser l'instruction Code de caractere(Arobase). Imaginons par exemple que vous souhaitiez savoir si une chaîne se termine par le caractère @. L’expression suivante (si $vaValeur n'est pas vide) retourne toujours VRAI :

($vsValue[[Length($vsValue)]]="@")

L'expression suivante sera correctement évaluée :

(Code de caractere($vaValeur[[Longueur($vaValeur)]])#64)

Note : Une option 4D du mode Développement vous permet de paramétrer le mode d’interprétation du caractère @ lorsque celui-ci est inclus dans une chaîne de caractères.

Mots-clés

A la différence des autres comparaisons de chaîne, les recherches par mots-clés recherchent des “mots” dans des “textes” : les mots sont évalués individuellement et dans leur globalité. L’opérateur % retournera toujours Faux si la recherche porte sur plusieurs mots ou une partie de mot (par exemple une syllabe). Les “mots” sont des chaînes de caractères encadrées par des “séparateurs”, qui sont les espaces, les caractères de ponctuation et les tirets. Une apostrophe, comme dans “aujourd'hui”, est généralement considérée comme partie du mot, mais sera ignorée dans certains cas (cf. règles ci-dessous). Les nombres peuvent être recherchés car ils sont évalués dans leur ensemble (incluant les symboles décimaux). Les autres symboles (monnaie, température, etc.) seront ignorés.

     "Alpha Bravo Charlie"%"Bravo" // Retourne Vrai
 "Alpha Bravo Charlie"%"vo" // Retourne Faux
 "Alpha Bravo Charlie"%"Alpha Bravo" // Retourne Faux
 "Alpha,Bravo,Charlie"%"Alpha" // Retourne Vrai
 "Software and Computers"%"comput@" // Retourne Vrai

Notes :

4D utilise la bibliothèque ICU pour comparer des chaînes de caractères (en utilisant les opérateurs <>=#) et détecter des mots-clés. Pour plus d'informations sur les règles mises en œuvre, veuillez vous reporter à l'adresse suivante : http://www.unicode.org/reports/tr29/#Word_Boundaries.

Dans la version japonaise, au lieu de ICU, 4D utilise Mecab par défaut pour la détection des mots-clés.

Symboles d'indice de chaîne

Les symboles d'indice de chaîne sont les suivants : [[...]]

Ces symboles sont utilisés pour désigner un caractère particulier dans une chaîne. Cette syntaxe vous permet de référencer un caractère dans un champ ou une variable de type Alpha ou Texte.

Lorsque les symboles d'indice de chaîne sont placés à gauche de l'opérateur d'affectation (:=), un caractère est affecté à la position référencée dans la chaîne. Par exemple, en postulant que la chaîne vsNom n'est pas une chaîne vide, le code suivant passe le premier caractère de la chaîne vsNom en majuscule :

If(vsNom#"")
    vsNom[[1]]:=Uppercase(vsNom[[1]])
End if

Lorsque les symboles d'indice de chaîne apparaissent dans une expression, ils retournent le caractère auquel ils font référence sous la forme d'une chaîne d'un caractère. Par exemple :

//L'exemple suivant teste si le dernier caractère de vtText est le caractère "@"
 If(vtText#"")
    If(Character code(Substring(vtText;Length(vtText);1))=At sign)
  //...
    End if
 End if

  //En utilisant la syntaxe des caractères d'indice de chaîne, vous écririez plus simplement :
 If(vtText#"")
    If(Character code(vtText[[Length(vtText)]])=At sign)
  // ...
    End if
 End if

Note avancée sur la référence à des caractères invalides

Lorsque vous utilisez les symboles d'indice de chaîne, il est de votre responsabilité de vous référer à des caractères existant dans la chaîne, de la même manière que pour les éléments d'un tableau. Si, par exemple, vous référencez le 20e caractère d'une chaîne, cette chaîne doit contenir au moins 20 caractères.

Ne pas respecter cette condition en mode interprété n'est pas signalé comme une erreur par 4D.
Ne pas respecter cette condition en mode compilé (sans options) peut entraîner une "corruption" de la mémoire, si, par exemple, vous écrivez un caractère au-delà de la fin d'une chaîne ou d'un texte.
Ne pas respecter cette condition en mode compilé est signalé lorsque le contrôle d'exécution est activé. Si, par exemple, vous exécutez le code suivant :

//Ne pas faire ça !
 vsAnyText:=""
 vsAnyText[[1]]:="A"

L'alerte suivante s'affichera en mode compilé :

alt-text

Exemple

La méthode projet suivante ajoute une lettre capitale à tous les mots du texte passé en paramètre et retourne le texte modifié :

  // Méthode projet de passage en capitale
  // PasserEnCap ( Texte ) -> Texte
  // PasserEnCap ( Texte source ) -> Texte avec des lettres capitales

 $0:=$1
 $vlLen:=Length($0)
 If($vlLen>0)
    $0[[1]]:=Uppercase($0[[1]])
    For($vlChar;1;$vlLen-1)
       If(Position($0[[$vlChar]];" !&()-{}:;<>?/,.=+*")>0)
          $0[[$vlChar+1]]:=Uppercase($0[[$vlChar+1]])
       End if
    End for
 End if

Une fois cette méthode placée dans la base, la ligne :

ALERT(Capitalize_text("Bonjour, mon nom est Jean Bon et je me présente aux présidentielles !"))

affiche l'alerte suivante :

alt-text

Constantes littérales de type chaîne​

Séquences d’échappement​

Opérateurs sur les chaînes​

Comparaisons de chaînes​

Le joker (@)​

Mots-clés​

Symboles d'indice de chaîne​

Note avancée sur la référence à des caractères invalides​

Exemple​