Cette rubrique détaille la syntaxe, la description, les paramètres et les valeurs de retour des fonctions de chaîne. Elle fournit également des exemples d'utilisation pour chacune de ces fonctions.
substr
Le tableau suivant présente les détails de cette fonction.
| Fonctionnalité | Description |
| Syntaxe | substr(s, i, j) |
| Description | Extrait une partie d'une chaîne de caractères. |
| Paramètre |
|
| Valeur de retour | Renvoie la sous-chaîne s[i, j] extraite de la chaîne source spécifiée par s. |
| Exemple | |
concat
Le tableau ci-dessous décrit le fonctionnement de cette fonction.
| Fonctionnalité | Description |
| Syntaxe | concat(s1, ...) |
| Description | Concatène plusieurs chaînes de caractères. |
| Paramètre | Les chaînes à concaténer. Vous pouvez spécifier une ou plusieurs chaînes. Les valeurs numériques sont prises en charge. |
| Valeur de retour | Renvoie la chaîne résultant de la concaténation. |
| Exemple | |
upper
Consultez le tableau suivant pour obtenir des informations détaillées sur cette fonction.
| Fonctionnalité | Description |
| Syntaxe | upper(s) |
| Description | Convertit une chaîne en majuscules. |
| Paramètre | s : la chaîne à convertir. |
| Valeur de retour | Renvoie la chaîne spécifiée par le paramètre s convertie en majuscules. |
| Exemple | |
lower
Les caractéristiques de cette fonction sont décrites dans le tableau ci-après.
| Fonctionnalité | Description |
| Syntaxe | lower(s) |
| Description | Convertit une chaîne en minuscules. |
| Paramètre | s : la chaîne à convertir. |
| Valeur de retour | Renvoie la chaîne spécifiée par le paramètre s convertie en minuscules. |
| Exemple | |
len
Ce tableau résume les spécifications de la fonction.
| Fonctionnalité | Description |
| Syntaxe | len(s) |
| Description | Détermine la longueur d'une chaîne de caractères. |
| Paramètre | s : la chaîne dont vous souhaitez mesurer la longueur. |
| Valeur de retour | Renvoie la longueur de la chaîne indiquée par le paramètre s. Type de données : entier. |
| Exemple | |
byte
Vous trouverez ci-dessous les détails concernant cette fonction.
| Fonctionnalité | Description |
| Syntaxe | byte(c) |
| Description | Obtient la valeur ASCII d'un caractère. |
| Paramètre | c : le caractère dont vous voulez connaître la valeur ASCII. Un seul caractère peut être spécifié. |
| Valeur de retour | Renvoie la valeur ASCII du caractère spécifié. Type de données : numérique. |
| Exemple | |
match_re
| Fonctionnalité | Description |
| Syntaxe | match_re(s, p [, o]) |
| Description | Vérifie si une chaîne correspond à une expression régulière via le moteur Perl Compatible Regular Expressions (PCRE). Pour plus d'informations, consultez la page Syntaxe des expressions régulières PCRE. |
| Paramètre |
|
| Valeur de retour | Renvoie true si la chaîne correspond au modèle, et false dans le cas contraire. |
| Exemple | |
capture_re
Le tableau suivant expose les propriétés de cette fonction.
| Fonctionnalité | Description |
| Syntaxe | capture_re(s, p [,init]) |
| Description | Capture les correspondances d'une chaîne et renvoie les sous-chaînes associées. Pour en savoir plus sur PCRE, reportez-vous à la syntaxe PCRE. |
| Paramètre |
|
| Valeur de retour | Renvoie les sous-chaînes correspondantes sous forme de dictionnaire si la chaîne valide l'expression régulière. Sinon, un dictionnaire vide est retourné. |
| Exemple | |
gsub_re
Voici les informations techniques relatives à cette fonction.
| Fonctionnalité | Description |
| Syntaxe | gsub_re(subject, regex, replace [,option]) |
| Description | Remplace toutes les occurrences correspondant au motif dans une chaîne et renvoie la chaîne modifiée. Pour plus de détails sur PCRE, voir la syntaxe PCRE. |
| Paramètre |
|
| Valeur de retour | Substitue toutes les sous-chaînes correspondant au paramètre regex dans le paramètre subject par celles définies dans le paramètre replace, puis renvoie la chaîne résultante. |
| Exemple | |
split
Lisez le tableau ci-dessous pour comprendre cette fonction.
| Fonctionnalité | Description |
| Syntaxe | split(s [,sep]) |
| Description | Découpe une chaîne en un tableau de sous-chaînes et retourne ce tableau. |
| Paramètre |
|
| Valeur de retour | Renvoie un tableau de paires clé-valeur sous forme de dictionnaire. La valeur du paramètre key est un nombre débutant à 1, par exemple [1]=xx et [2]=y. Si sep n'est pas renseigné, le découpage s'effectue selon les caractères d'espacement (espaces et tabulations \t). |
| Exemple | |
split_as_key
Cette section détaille le comportement de la fonction.
| Fonctionnalité | Description |
| Syntaxe | split_as_key(s [,sep]) |
| Description | Fractionne une chaîne en un tableau de sous-chaînes et retourne le résultat. |
| Paramètre |
|
| Valeur de retour | Produit des paramètres de réponse similaires à ceux de la fonction split(). Toutefois, le paramètre key prend le nom de chaque élément fractionné selon le schéma : Element 1 -> Element 2. |
| Exemple | |
tohex
Référez-vous au tableau suivant pour les spécificités de cette fonction.
| Fonctionnalité | Description |
| Syntaxe | tohex(s) |
| Description | Transforme une chaîne en sa représentation hexadécimale. |
| Paramètre | s : la chaîne à transformer. |
| Valeur de retour | Renvoie la chaîne hexadécimale issue de la conversion du paramètre s. |
| Exemple | |
tostring
Les détails de cette fonction figurent dans le tableau ci-après.
| Fonctionnalité | Description |
| Syntaxe | tostring(a) |
| Description | Convertit une donnée de n'importe quel type en chaîne de caractères. |
| Paramètre | a : la donnée à convertir. Type de données : quelconque. |
| Valeur de retour | Renvoie la chaîne obtenue après conversion de la valeur du paramètre a. |
| Exemple | |
tochar
Examinez le tableau suivant pour maîtriser cette fonction.
| Fonctionnalité | Description |
| Syntaxe | tochar(n1, n2, ...) |
| Description |
|
| Paramètre | nX : les entiers à convertir. Il est possible d'en spécifier un ou plusieurs. |
| Valeur de retour | Renvoie la chaîne générée à partir des entiers. |
| Exemple | |
reverse
Les attributs de cette fonction sont listés ci-dessous.
| Fonctionnalité | Description |
| Syntaxe | reverse(str) |
| Description | Inverse l'ordre des caractères d'une chaîne. |
| Paramètre | str : la chaîne à inverser. |
| Valeur de retour | Renvoie la chaîne inversée. |
| Exemple | Résultat : |
find
Ce tableau synthétise les informations essentielles sur la fonction.
| Fonctionnalité | Description |
| Syntaxe | string.find (s, substr, pos) |
| Description | Recherche une sous-chaîne au sein d'une chaîne donnée. |
| Paramètre |
|
| Valeur de retour |
|
| Exemple | Résultat : |
format
Analysez le tableau ci-dessous pour comprendre l'usage de cette fonction.
| Fonctionnalité | Description |
| Syntaxe | format(fmt, ···) |
| Description | Formate les valeurs d'un ou plusieurs paramètres. Le premier argument doit obligatoirement être une chaîne de formatage. Cette chaîne suit la norme du paramètre sprintf utilisé dans le langage C. La structure d'une chaîne de format est la suivante : %[paramètre][indicateur][largeur de champ][.précision]spécificateur.
|
| Paramètre |
|
| Valeur de retour | Renvoie une chaîne ASCII. |
| Exemple | Résultat : |
tobin
Le tableau suivant explicite le rôle de cette fonction.
| Fonctionnalité | Description |
| Syntaxe | tobin(str) |
| Description | Convertit une chaîne hexadécimale en chaîne ASCII. |
| Paramètre | str : la chaîne hexadécimale à convertir. La casse n'a aucune incidence. |
| Valeur de retour | Renvoie une chaîne ASCII. |
| Exemple | Résultat : |
trim
Voici une description technique complète de la fonction.
| Fonctionnalité | Description |
| Syntaxe | trim(s, [, loc]) |
| Description | Supprime les espaces situés avant ou après la chaîne définie par le paramètre s, puis retourne la chaîne nettoyée. |
| Paramètre |
|
| Valeur de retour | Retourne la chaîne débarrassée des caractères d'espacement ciblés. |
| Exemple | Résultat : |