9 Funcions de cadena

Totes les funcions listades aquí són compatibles amb:

• Expressions triggers
• Elements calculats

Les funcions es llisten sense informació addicional. Feu clic a la funció per veure'n tots els detalls.

Detalls de la funció

Algunes notes generals sobre paràmetres de funció:

• Els paràmetres de funció són separats per una coma
• S'admeten expressions com a paràmetres
• Els paràmetres de cadena han de ser entre cometes; en cas contrari es podrien malinterpretar
• Els paràmetres de funció opcionals (o parts de paràmetres) s'indiquen amb < >

ascii(value)

Codi ASCII del caràcter més a l'esquerra del valor.
Tipus de valors admesos: Cadena, Text, Log.

Paràmetre:

• valor - valor que cal comprovar

Per exemple, un valor com 'Abc' retornarà '65' (codi ASCII per a 'A').

Exemple:

ascii(last(/host/key))

bitlength(value)

Longitud del valor en bits.
Tipus de valors admesos: Cadena, Text, Log, Enter.

Paràmetre:

• valor - valor que cal comprovar

Exemple:

bitlength(last(/host/key))

bytelength(value)

Longitud del valor en octets.
Tipus de valors admesos: Cadena, Text, Log, Enter.

Paràmetre:

• valor - valor que cal comprovar

Exemple:

bytelength(last(/host/key))

char(value)

Retorna el caràcter interpretant el valor com a codi ASCII.
Tipus de valors admesos: Enter.

Paràmetre:

• valor - valor que cal comprovar

El valor ha de ser entre 0 i 255. Per exemple, un valor com '65' (interpretat com a codi ASCII) retornarà 'A'.

Exemple:

char(last(/host/key))

concat(<value1>,<value2>,...)

Cadena resultant de la concatenació dels valors dels elements de referència o dels valors constants.
Tipus de valors admesos: Cadena, Text, Log, Flotant, Enter.

Paràmetre:

• valorX - valor que retorna una de les funcions de l'historial o un valor constant (cadena, enter o nombre flotant). Ha de contindre almenys dos paràmetres.

Per exemple, un valor com 'Zab' concatenat a 'bix' (la cadena constant) retornarà 'Zabbix'.

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(value,start,length,replacement)

Insereix caràcters o espais especificats a la cadena de caràcters començant a la posició especificada de la cadena.
Tipus de valors admesos: Cadena, Text, Log.

Paràmetres:

• valor - valor que cal comprovar;
  
• inici - posició inicial;
  
• longitud - posicions per substituir;
  
• reemplaçament - cadena de substitució.

Per exemple, un valor com 'Zabbbix' es substituirà per 'Zabbix' si 'bb' (posició inicial 3, posicions per substituir 2) es substitueix per 'b'.

Exemple:

insert(last(/host/key),3,2,"b")

jsonpath(valor,camí,<predeterminat>)

Retorna el resultat JSONPath.
Tipus de valors admesos: Cadena, Text, Registre.

Paràmetres:

• valor - el valor que cal comprovar;
  
• camí - el camí (s'ha de citar entre cometes);
  
• per defecte - el valor alternatiu opcional si la consulta JSONPath no retorna cap dada. Tingueu en compte que en altres errors es retorna un error (per exemple, "construcció no compatible").

Exemple:

jsonpath(last(/host/proc.get[zabbix_agentd,,,summary]),"$..size")

left(value,count)

Retorna els caràcters més a l'esquerra del valor.
Tipus de valors admesos: Cadena, Text, Log.

Paràmetre:

• valor - valor que cal comprovar;
  
• recompte - nombre de caràcters a retornar.

Per exemple, podeu tornar 'Zab' de 'Zabbix' especificant 3 caràcters més a l'esquerra per retornar. Veieu també right().

Exemple:

left(last(/host/key),3) #retorna els tres caràcters de més a l'esquerra

length(value)

Longitud del valor en caràcters.
Tipus de valors admesos: Cadena, Text, Log.

Paràmetre:

• valor - valor que cal comprovar.

Exemples:

 length(last(/host/key)) #longitud del darrer valor
        length(last(/host/key,#3)) #longitud del tercer valor més recent
        length(last(/host/key,#1:now-1d)) #durada del valor més recent fa un dia

ltrim(value,<chars>)

Esborra els caràcters especificats del principi de la cadena.
Tipus de valors admesos: String, Text, Log.

Paràmetre:

• valor - valor que cal comprovar;
  
• caràcters (opcional) - especifiqueu els caràcters que voleu esborrar.

Els espais en blanc es retallen a l'esquerra per defecte (si no s'especifiquen caràcters opcionals). Veieu també: rtrim(), trim().

Exemples:

 ltrim(last(/host/key)) #esborra els espais en blanc del principi de la cadena
        ltrim(last(/host/key),"Z") #esborra qualsevol 'Z' del principi de la cadena
        ltrim(last(/host/key),"Z") #esborra qualsevol espai i 'Z' des del principi de la cadena

mid(value,start,length)

Retorna una subcadena d'N caràcters que comença a la posició del caràcter especificada per 'inici'.
Tipus de valors admesos: Cadena, Text, Log.

Paràmetre:

• valor - valor que cal comprovar;
  
• start - posició inicial de la subcadena;
  
• longitud - posicions a retornar a la subcadena.

Per exemple, és possible retornar 'abbi' des d'un valor com 'Zabbix' si la posició inicial és 2 i les posicions a retornar és 4.

Exemple:

mid(last(/host/key),2,4)="abbi"

repeat(value,count)

Repeteix una cadena.
Tipus de valor admesos: Cadena, Text, Log.

Paràmetre:

• valor - valor a comprovar;
  
• recompte - nombre de vegades a repetir.

Exemple:

repeat(last(/host/key),2) #repeteix dos cops el valor

replace(value,pattern,replacement)

Troba el patró al valor i el substitueix. Es substituiran totes les ocurrències del patró.
Tipus de valors admesos: Cadena, Text, Log.

Paràmetre:

• valor - valor que cal comprovar;
  
• patró - patró a cercar;
  
• reemplaçament - cadena per substituir el patró.

Exemple:

replace(last(/host/key),"ibb","abb") - substitueix tots els 'ibb' amb 'abb'

right(value,count)

Retorna els caràcters més a l'esquerra del valor.
Tipus de valors admesos: Cadena, Text, Log.

Paràmetre:

• valor - valor que cal comprovar;
  
• recompte - nombre de caràcters a retornar.

Per exemple, podeu tornar 'bix' de 'Zabbix' especificant 3 caràcters més a l'esquerra per retornar. Veieu també left().

Exemple:

right(last(/host/key),3) #retorna els tres caràcters de més a l'esquerra

rtrim(value,<chars>)

Esborra els caràcters especificats del final de la cadena.
Tipus de valors admesos: String, Text, Log.

Paràmetre:

• valor - valor que cal comprovar;
  
• caràcters (opcional) - especifiqueu els caràcters que voleu esborrar.

Els espais en blanc es retallen a la dreta per defecte (si no s'especifiquen caràcters opcionals). Veieu també: ltrim(), trim().

Exemples:

 rtrim(last(/host/key)) #esborra els espais en blanc del final de la cadena
        rtrim(last(/host/key),"x") #esborra qualsevol 'x' del final de la cadena
        rtrim(last(/host/key),"x") #esborra qualsevol espai i 'x' des del final de la cadena

trim(value,<chars>)

Esborra els caràcters especificats del principi i final de la cadena.
Tipus de valors admesos: String, Text, Log.

Paràmetre:

• valor - valor que cal comprovar;
  
• caràcters (opcional) - especifiqueu els caràcters que voleu esborrar.

Els espais en blanc es retallen a les dues bandes per defecte (si no s'especifiquen caràcters opcionals). Veieu també: ltrim(), rtrim().

Exemples:

 ltrim(last(/host/key)) esborra els espais en blanc del principi i final de la cadena
        ltrim(last(/host/key),"_") esborra qualsevol '_' del principi i final de la cadena

xmlpath(valor,camí,<predeterminat>)

Retorna el resultat XMLPath.
Tipus de valors admesos: Cadena, Text, Registre.

Paràmetres:

• valor - el valor que cal comprovar;
  
• camí - el camí (s'ha de citar entre cometes);
  
• per defecte - el valor alternatiu opcional si la consulta XMLPath retorna un nodeset buit. No retornarà res si el resultat buit no és un nodeset (com ara una cadaena buida). Davant altres errors, retornarà una fallida (com ara "expressió invàlida").

Exemple:

xmlxpath(last(/host/xml_result),"/response/error/status")

Veieu totes les funcions admeses.