Table of Contents

9 Fonctions de chaîne

Toutes les fonctions répertoriées ici sont prises en charge dans :

Quelques notes générales sur les paramètres de fonction :

  • Les paramètres de fonction sont séparés par une virgule
  • Les expressions sont acceptées comme paramètres
  • Les paramètres de chaîne doivent être entre guillemets doubles ; sinon ils pourraient être mal interprétés
  • Les paramètres de fonction optionnels (ou parties de paramètres) sont indiqués par < >
FONCTION
Description Paramètres spécifiques à la fonction Commentaires
ascii (valeur)
Le code ASCII du caractère le plus à gauche de la valeur. valeur - valeur à vérifier Types de valeur pris en charge : chaîne, texte, journal

Par exemple, une valeur comme 'Abc' renverra '65 ' (code ASCII pour 'A').

Exemple :
=> ascii(last(/host/key))
bitlength (valeur)
La longueur de la valeur en bits. valeur - valeur à vérifier Types de valeur pris en charge : chaîne, texte, journal, entier

Exemple :
=> bitlength(last(/host/key))
bytelength (valeur)
La longueur de la valeur en octets. valeur - valeur à vérifier Types de valeur pris en charge : chaîne, texte, journal, entier

Exemple :
=> bytelength(last(/host/key))
char (value)
Renvoyer le caractère en interprétant la valeur comme un code ASCII. valeur - valeur à vérifier Types de valeur pris en charge : entier

La valeur doit être comprise entre 0 et 255. Par exemple, une valeur comme '65' (interprétée comme un code ASCII) renverra 'A'.

Exemple :
=> char(last(/host/key))
concat (<valeur1>,<valeur2>,...)
La chaîne résultant de la concaténation de valeurs d'éléments référencés ou de valeurs constantes. valeur : une valeur renvoyée par l'une des fonctions d'historique ou une valeur constante (chaîne, entier ou nombre flottant) Types de valeur pris en charge : chaîne, texte, journal, flottant, entier

Pour Par exemple, une valeur comme 'Zab' concaténée à 'bix' (la chaîne constante) renverra 'Zabbix'.

Doit contenir au moins deux paramètres.

Exemples :
=> concat(last(/host/key),"bix")
=> concat("1 min: ",last(/host/system.cpu.load[all,avg1]),", 15 min: ",last(/host/system.cpu.load[all,avg15]))
insert (valeur,début,longueur,remplacement)
Insère des caractères ou des espaces spécifiés dans la chaîne de caractères en commençant à la position spécifiée dans la chaîne. valeur - valeur à vérifier
début - position de début
longueur - positions à remplacer
remplacement - chaîne de remplacement
Types de valeurs pris en charge : chaîne, texte, journal

Par exemple, une valeur comme 'Zabbbix' sera remplacée par 'Zabbix' si 'bb' ( position de départ 3, positions pour remplacer 2) est remplacée par 'b'.

Exemple :
=> insert(last(/host/key),3,2,"b")
left (valeur,compte)
Les caractères les plus à gauche de la valeur. valeur - valeur à vérifier
compte - nombre de caractères à renvoyer
Types de valeur pris en charge : chaîne, texte, journal

Par exemple , vous pouvez renvoyer 'Zab' à partir de 'Zabbix' en spécifiant 3 caractères les plus à gauche à renvoyer.

Exemple :
=> left(last(/host/key),3) - renvoie les trois caractères les plus à gauche

Voir aussi right().
length (valeur)
La longueur de la valeur en caractères. valeur - valeur à vérifier Types de valeur pris en charge : chaîne, texte, journal

Exemple :
=> length(last(/ host/key)) → longueur de la dernière valeur
=> length(last(/host/key,#3)) → longueur de la troisième valeur la plus récente
=> length (last(/host/key,#1:now-1d)) → longueur de la valeur la plus récente il y a un jour
ltrim (valeur,<caractères>)
Supprime les caractères spécifiés du début de la chaîne. valeur - valeur à vérifier
caractères - (facultatif) spécifiez les caractères à supprimer

Les espaces blancs sont coupés à gauche par défaut ( si aucun caractère facultatif n'est spécifié).
Types de valeur pris en charge : chaîne, texte, journal

Exemple :
=> ltrim(last(/host/key)) - supprime les espaces blancs du début de chaîne
=> ltrim(last(/host/key),"Z") - supprime tout 'Z' du début de chaîne
=> **ltrim* *(last(/host/key)," Z") - supprime tout espace et 'Z' au début de la chaîne

Voir aussi : rtrim(), trim()
mid (valeur,début,longueur)
Renvoie une sous-chaîne de N caractères commençant à la position de caractère spécifiée par 'début'. valeur - valeur à vérifier
début - position de début de la sous-chaîne
longueur - positions à renvoyer dans la sous-chaîne
Types de valeurs pris en charge : chaîne, texte, journal).

Exemple :
=> mid(last(/host/key),2,4)="abbi"
repeat (value,count)
Repeat a string. value - value to check
count - number of times to repeat
Supported value types: string, text, log

Example:
=> repeat(last(/host/key),2) - repeat the value two times
replace (valeur,modèle,remplacement)
Recherchez le motif dans la valeur et remplacez-le par remplacement. Toutes les occurrences du modèle seront remplacées. valeur - valeur à vérifier
modèle - modèle à rechercher
remplacement - chaîne pour remplacer le modèle par
Types de valeur pris en charge : chaîne, texte, journal

Exemple :
=> replace(last(/host/key),"ibb","abb") - remplacer tous les 'ibb' par 'abb'
right (valeur,compte)
Les caractères les plus à droite de la valeur. valeur - valeur à vérifier
compte - nombre de caractères à renvoyer
Types de valeur pris en charge : chaîne, texte, journal

Par exemple , vous pouvez renvoyer 'bix' à partir de 'Zabbix' en spécifiant 3 caractères les plus à droite à renvoyer.

Exemple :
=> right(last(/host/key),**3* *) - renvoie les trois caractères les plus à droite

Voir aussi left().
rtrim (valeur,<caractères>)
Supprime les caractères spécifiés de la fin de la chaîne. valeur - valeur à vérifier
caractères - (facultatif) spécifiez les caractères à supprimer

Les espaces blancs sont coupés à droite par défaut ( si aucun caractère facultatif n'est spécifié).
Types de valeur pris en charge : chaîne, texte, journal

Exemple :
=> rtrim(last(/host/key)) - supprime les espaces du fin de chaîne
=> rtrim(last(/host/key),"x") - supprime tout 'x' à la fin de la chaîne
=> **rtrim* *(last(/host/key),"x ") - supprime tout 'x' ou espace à la fin de la chaîne

Voir aussi : ltrim(), trim()
trim (valeur,<caractères>)
Supprime les caractères spécifiés du début et de la fin de la chaîne. valeur - valeur à vérifier
caractères - (facultatif) spécifiez les caractères à supprimer

Les espaces blancs sont coupés des deux côtés par défaut (si aucun caractère facultatif n'est spécifié).
Types de valeur pris en charge : chaîne, texte, journal

Exemple :
=> trim(last(/host/key)) - supprimer espace entre le début et la fin de la chaîne
=> trim(last(/host/key),"_") - supprime '_' du début et de la fin de la chaîne< br>
Voir aussi : ltrim(), rtrim()