# Fonctions de chaînes de caractères

Ces fonctions permettent de manipuler des chaînes de caractères.

Remarque :

- Les paramètres d’index sont basés sur zéro. Cela signifie que le premier caractère d’une chaîne possède un index de 0, le second un index de 1 etc.
- Les chaînes de texte qui dépassent d’un caractère la largeur de la cellule sont parfois tronquées. En augmentant la largeur de la colonne ou en ajoutant un espace à la chaîne, la chaîne entière s’affiche.

- Les fonctions de manipulation de chaînes fonctionnent sur des chaînes de caractères Unicode.

Fonction | Description
Code (Texte, [Index]) | Renvoie l’entier correspondant au code Unicode du caractère d’une chaîne pour l’index spécifié. Si aucun index n’est spécifié, renvoie le code du premier caractère. Renvoie zéro si la chaîne est vide ou si l’index se trouve au-delà de la fin de la chaîne. Les codes Unicode sont identiques à ASCII pour les 127 premiers caractères, mais la totalité des codes Unicode est prise en charge par cette fonction. Exemple de code Si la cellule A2 contient la chaîne alphanumérique "ABC123", la fonction Code(A2) renvoie 65,000, le code ASCII pour "A".
Concatenate (Arg1, [Arg2, Arg3, ...]) | Renvoie la concaténation de plusieurs chaînes de caractères alphanumériques. Les arguments numériques sont automatiquement convertis en texte. Exemple de concaténation Si la cellule A2 contient la chaîne alphanumérique "A1B1", la cellule A3 contient la chaîne alphanumérique "C1D2" et la cellule A4 contient le nombre à virgule flottante 4,556, alors la fonction Concatenate(A2,A3,A4) renvoie "A1B1C1D24.556".
Exact (texte1, texte2) | Renvoie 1 si texte1 et texte2 sont identiques, sinon 0. Remarque : sensible à la casse. Exemples précis Si la cellule A2 contient la chaîne "ABC123" et que la cellule A3 contient la chaîne "ABC1234", Exact(A2,A3) renvoie 0,000. Si la cellule A2 contient la chaîne de caractères "VISION" et la cellule A3 contient la chaîne de caractères "VISION", Exact(A2,A3) renvoie 1,000.
Find (TexteATrouver, TextSource, [CarDébut]) | Renvoie la position indexée de la chaîne TexteATrouver contenue dans la chaîne TextSource. Remarque : La fonction est sensible à la casse. Exemples de la fonction Find TexteATrouver et TextSource peuvent être des références à des cellules ou une chaîne directement passée en argument de la fonction. La cellule A2 contient la chaîne "123" et la cellule A3 contient la chaîne "ABC123". Find(A2, A3) ou Find("123", A3) renvoie 3,00, la position de l’index de "123" dans "ABC 123". CarDébut est un argument facultatif (nombre entier) qui représente une position d’index dans le texte source où peut commencer la recherche. Find(A2,A3,2) commence sa recherche à l’index 2 de TextSrc et renvoie la valeur d’index 3,000. Si TexteATrouver est introuvable, la fonction renvoie -1,00. Find("XYZ",A3) renvoie -1,000
FormatString (Chaîne de format, [Texte ou Valeur, ...]) | Renvoie une chaîne de caractères utilisant une chaîne de format standard "C". FormatString prend en charge la plupart des paramètres des chaînes de format. Utilisez la Boîte de dialogue Formater une chaîne pour configurer automatiquement cette fonction. Remarque : Toute modification manuelle de la fonction FormatString n’est pas recommandée.
Left (Texte, NbCars) | Renvoie le nombre de caractères de gauche (NumChars) d’une chaîne de Texte. Exemple de la fonction Left Si la cellule A2 contient la chaîne alphanumérique "ABC123", la fonction Left(A2,2) renvoie la chaîne "AB".
Len (texte) | Renvoie le nombre de caractères d’une chaîne de texte. Exemple de la fonction Len Si la cellule A2 contient la chaîne alphanumérique "ABC123", la fonction Len(A2) renvoie la valeur entière 6,000.
Lower (texte) | Renvoie le texte converti en minuscules. Exemple de la fonction Lower Si la cellule A2 contient la chaîne alphanumérique "ABC123", la fonction Lower(A2) renvoie la chaîne "abc123".
Mid (Texte, CarDébut, NbCars) | Renvoie le texte commençant à la position indexée CarDébut de la chaîne alphanumérique, pour le nombre de caractères spécifié par NbCars. Exemple de la fonction Mid Si la cellule A2 contient la chaîne alphanumérique "ABC123", la fonction Mid(A2,2,2) renvoie la chaîne "C1".
Replace (Textesource, CarDébut, NbCars, NouveauTexte) | Renvoie TexteSource modifié par NouveauTexte. La fonction supprime un certain nombre de caractères NbChars en commençant à la position indexée CarDébut et insère le texte de substitution NouveauTexte. Exemple de la fonction Replace Si la cellule A2 contient la chaîne "ABC123" et que la cellule A3 contient la chaîne "123", Replace(A2,0,3,A3) renvoie la chaîne "123123".
Right (Texte, NbCars) | Renvoie le nombre NbCars de caractères de droite d’une chaîne de caractères Text. Exemple de la fonction Right Si la cellule A2 contient la chaîne "ABC123", Right(A2,2) renvoie la chaîne "23".
Stringf (Chaîne de format, [Texte ou Valeur, ...]) | Renvoie une chaîne de caractères utilisant une chaîne de format standard "C". Astuce : La fonction FormatString prend en charge la plupart des paramètres des chaînes de format. Utilisez la Boîte de dialogue Formater une chaîne pour configurer automatiquement les paramètres. Remarque : La chaîne de format doit être écrite entre guillemets ("Ceci est une chaîne de caractères"). Les paramètres de format-chaîne respectent la casse. Lorsque vous utilisez la fonction Stringf, la barre oblique "\" sert à indiquer qu’un caractère de commande de format suit. Si la barre oblique n’est pas suivie par un caractère de commande ("n", "r" ou "t"), elle est ignorée et le caractère qui suit la barre est insérée. Pour afficher une seule barre oblique, vous devez en saisir deux. Exemple : Stringf("C:\\InSight2\\") = "C:\InSight2\" Les caractères non affichables/codes de contrôle seront affichés sous la forme d’un symbole ou de texte de remplissage sans signification. Les paramètres de format-chaîne sont :
%c | Renvoie le caractère Unicode correspondant à une valeur entière. Exemple Stringf %c Si la cellule A2 contient la valeur entière 65,000, alors Stringf("%c",A2) renvoie le caractère "A", qui est le caractère correspondant au code ASCII 65. La fonction Stringf("Valeur = %c",A2) renvoie la chaîne de caractères "Valeur = A".
%d | Renvoie une chaîne contenant une Valeur entière. Exemples Stringf %d Si la cellule A2 contient la valeur à virgule flottante 123,456, Stringf("%d",A2) renvoie la chaîne numérique "123". La fonction Stringf("Value = %d",A2) renvoie la chaîne alphanumérique "Valeur = 123".
%e | Renvoie une chaîne de caractères contenant une valeur en notation scientifique. Le nombre de postes décimaux peut être spécifié en insérant une virgule décimale (,) et un nombre entre les paramètres % et e. Exemples Stringf %e Si la cellule A2 contient la valeur à virgule flottante 123,456, Stringf("%e",A2) renvoie la chaîne numérique "1,234560e+02". La fonction Stringf("%.1e",A2) renvoie la chaîne numérique "1.2e+02", car un seul chiffre après le point décimal est spécifié.
%f | Renvoie une chaîne contenant une Valeur à virgule flottante. Le nombre de postes décimaux peut être spécifié en insérant une virgule décimale (,) et un nombre entre les paramètres % et f. Exemples Stringf %f Si la cellule A2 contient la valeur à virgule flottante 123,456, Stringf("%f",A2) renvoie la chaîne numérique "123,456001". La fonction Stringf("%.1f",A2) renvoie la chaîne numérique "123.5", car il est spécifié un seul chiffre après la virgule.
%o | Renvoie une chaîne contenant la valeur octale pour un entier. Exemples de Stringf %o Si la cellule A2 contient la valeur entière 123,000, Stringf("%o",A2) renvoie la chaîne numérique "173", la valeur octale de l’entier 123.
%s | Renvoie une chaîne avec des caractères alphanumériques attachés. Exemples de Stringf %s Si la cellule A2 contient la chaîne "ABC", la fonction Stringf("%s123",A2) renvoie la chaîne alphanumérique "ABC123". Si la cellule A2 contient la chaîne numérique "123", Stringf("%s.450",A2) renvoie la chaîne alphanumérique "123.450".
%u | Renvoie une chaîne de caractères contenant une valeur entière non signée. Exemples de Stringf %u Si la cellule A2 contient la valeur à virgule flottante 123,456, Stringf("%u",A2) renvoie la chaîne numérique "123". La fonction Stringf("Valeur = %u",A2) renvoie la chaîne alphanumérique "Valeur = 123".
%x ou %X | Renvoie une chaîne contenant la valeur hexadécimale d’un entier. Exemples de Stringf %x Si la cellule A2 contient l’entier 123,000, Stringf("%x",A2) renvoie la chaîne "7b", la valeur hexadécimale de l’entier 123.
%% | Renvoie une chaîne contenant un unique caractère de pourcentage (%).
Les paramètres de chaîne de format servent essentiellement à formater du texte (par exemple, à formater le texte d’un message dans la fonction WriteSMTP) :
\r | Insère un retour chariot dans le texte. Ce paramètre est généralement utilisé en conjonction avec \n (saut de ligne).
\n | Insère une nouvelle ligne dans le texte. Ce paramètre est généralement utilisé en conjonction avec \r (retour chariot).
\\ | Insère une barre oblique inverse « \ » dans le texte.
\t | Insère une tabulation dans le texte.
\v | Insère une barre verticale dans le texte.
\f | Insère un saut de page ASCII dans le texte.
\x## | Insère le caractère ASCII ou Unicode spécifié par le nombre hexadécimal ## dans le texte. Exemple de Stringf \x## Si la cellule A2 contient Stringf("\x02123\x1bABC\x03456"), alors la cellule affichera : ("<STX>123<ESC>ABC<ETX>456").
\u#### | Insère le caractère ASCII ou Unicode spécifié par le nombre hexadécimal 16 bits ## ## dans le texte.
Strtol (EntierTexte) | Convertit les caractères numériques (décimaux, hexadécimaux et octaux) situés au début d’une chaîne alphanumérique en nombre entier. Les caractères hexadécimaux doivent commencer par 0x, et les caractères octaux par 0. Exemples de Strtol Décimaux : Si la cellule A2 contient la chaîne "123ABC", Strtol(A2) renvoie l’entier "123,000". Hexadécimaux : Si la cellule A2 contient la chaîne de texte "0x123", Strtol(A2) renvoie la valeur entière 291,000. "0x12AB" = 4 779,000, puisque "A" et "B" sont des caractères hexadécimaux. "0x12GB" = 18,000, puisque "G" n’est pas un caractère hexadécimal. Octaux : Si la cellule A2 contient la chaîne de texte "0123ABC", Strtol(A2) renvoie la valeur entière 83,000.
Substitute (texte source, ancien texte, nouveau texte, [Instance]) | Renvoie une chaîne de texte construite en substituant le nouveau texte pour chaque occurrence de l’ancien texte dans le texte source. Si un index d’Instance en option est spécifié, seule cette instance du texte sera remplacée. Exemple de la fonction Substitute Si la cellule A2 contient la chaîne de caractères "ABC123123", la cellule A3 contient la chaîne "123" et la cellule A4 contient la chaîne "abc", puis Substitute(A2,A3,A4,1) remplace la seconde instance de "123" dans le nouveau texte et renvoie la chaîne "ABC123abc".
Token (texte, délimiteur, Instance) | Renvoie le texte situé à l’index d’Instance spécifié (occurrence) d’une chaîne délimitée. Le délimiteur doit être entouré de guillemets (" ") dans les arguments de la fonction. Exemple de Token Si la cellule A2 contient la chaîne délimitée par virgules "A,B,C,1,2,3", Token(A2,",",2) renvoie "C", car C est à l’index 2 dans le texte.
Trim (texte) | Renvoie le texte débarrassé des espaces à gauche et de fin, ce qui laisse un espace unique entre les mots (le cas échéant). Tous les caractères de commande (retour chariot, saut de ligne, etc.) sont également retirés. Exemple de la fonction Trim Si la cellule A2 contient la chaîne " ABC 123 ", Trim(A2) renvoie la chaîne "ABC 123".
Upper (texte) | Renvoie le texte converti en majuscules. Exemple de la fonction Upper Si la cellule A2 contient la chaîne alphanumérique "abc123", la fonction Upper(A2) renvoie la chaîne "ABC123".
Value (texte numérique) | Renvoie la valeur de virgule flottante du texte numérique. Tous les caractères non-numériques qui suivent sont ignorés. Exemple de Value Si la cellule A2 contient la chaîne numérique "123,4", la fonction Value(A2) renvoie la valeur de virgule flottante 123,400.