Áú»¢¶Ä²©

9 Funcions de cadena

Totes les funcions listades aqu¨ª s¨®n compatibles amb:

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

¹ó³Ü²Ô³¦¾±¨® ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®
ascii Codi ASCII del car¨¤cter m¨¦s a l'esquerra del valor.
bitlength Longitud del valor en bits.
bytelength Longitud del valor en octets.
char Retorna el car¨¤cter interpretant el valor com a codi ASCII.
concat Cadena resultant de la concatenaci¨® dels valors dels elements de refer¨¨ncia o dels valors constants.
insert Insereix ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ o espais especificats a la cadena de ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ comen?ant a la posici¨® especificada de la cadena.
jsonpath Retorna el resultat JSONPath.
left Retorna els ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ m¨¦s a l'esquerra del valor.
lenght Longitud del valor en ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ.
ltrim Esborra els ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ especificats del principi de la cadena.
mid Retorna una subcadena de N ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ comen?ant a la posici¨® del car¨¤cter especificada per 'inici'.
repeat Repetir una cadena.
replace Cerca el ±è²¹³Ù°ù¨® al valor i el substitueix.
right Retorna els ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ m¨¦s a la dreta del valor.
rtrim Esborra els ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ especificats del final de la cadena.
trim Esborra els ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ especificats del principi i el final de la cadena.
xmlxpath Retorna el resultat XML XPath.

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.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð:

  • 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.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð:

  • 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.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð:

  • 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.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð:

  • 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.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð:

  • 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¨¤ 'Áú»¢¶Ä²©'.

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 ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ o espais especificats a la cadena de ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ comen?ant a la posici¨® especificada de la cadena.
Tipus de valors admesos: Cadena, Text, Log.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ:

  • 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 'Áú»¢¶Ä²©' si 'bb' (posici¨® inicial 3, posicions per substituir 2) es substitueix per 'b'.

Exemple:

insert(last(/host/key),3,2,"b")
Âá²õ´Ç²Ô±è²¹³Ù³ó(±¹²¹±ô´Ç°ù,³¦²¹³¾¨ª,&±ô³Ù;±è°ù±ð»å±ð³Ù±ð°ù³¾¾±²Ô²¹³Ù&²µ³Ù;)

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

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ:

  • valor - el valor que cal comprovar;
  • ³¦²¹³¾¨ª - el ³¦²¹³¾¨ª (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 ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ m¨¦s a l'esquerra del valor.
Tipus de valors admesos: Cadena, Text, Log.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð:

  • valor - valor que cal comprovar;
  • recompte - nombre de ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ a retornar.

Per exemple, podeu tornar 'Zab' de 'Áú»¢¶Ä²©' especificant 3 ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ m¨¦s a l'esquerra per retornar. Veieu tamb¨¦ right().

Exemple:

left(last(/host/key),3) #retorna els tres ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ de m¨¦s a l'esquerra
length(value)

Longitud del valor en ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ.
Tipus de valors admesos: Cadena, Text, Log.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð:

  • 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 ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ especificats del principi de la cadena.
Tipus de valors admesos: String, Text, Log.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð:

  • valor - valor que cal comprovar;
  • ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ (opcional) - especifiqueu els ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ que voleu esborrar.

Els espais en blanc es retallen a l'esquerra per defecte (si no s'especifiquen ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ 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 ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ que comen?a a la posici¨® del car¨¤cter especificada per 'inici'.
Tipus de valors admesos: Cadena, Text, Log.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð:

  • 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 'Áú»¢¶Ä²©' 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.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð:

  • 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 ±è²¹³Ù°ù¨® al valor i el substitueix. Es substituiran totes les ocurr¨¨ncies del ±è²¹³Ù°ù¨®.
Tipus de valors admesos: Cadena, Text, Log.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð:

  • valor - valor que cal comprovar;
  • ±è²¹³Ù°ù¨® - ±è²¹³Ù°ù¨® a cercar;
  • reempla?ament - cadena per substituir el ±è²¹³Ù°ù¨®.

Exemple:

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

Retorna els ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ m¨¦s a l'esquerra del valor.
Tipus de valors admesos: Cadena, Text, Log.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð:

  • valor - valor que cal comprovar;
  • recompte - nombre de ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ a retornar.

Per exemple, podeu tornar 'bix' de 'Áú»¢¶Ä²©' especificant 3 ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ m¨¦s a l'esquerra per retornar. Veieu tamb¨¦ left().

Exemple:

right(last(/host/key),3) #retorna els tres ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ de m¨¦s a l'esquerra
rtrim(value,<chars>)

Esborra els ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ especificats del final de la cadena.
Tipus de valors admesos: String, Text, Log.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð:

  • valor - valor que cal comprovar;
  • ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ (opcional) - especifiqueu els ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ que voleu esborrar.

Els espais en blanc es retallen a la dreta per defecte (si no s'especifiquen ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ 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 ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ especificats del principi i final de la cadena.
Tipus de valors admesos: String, Text, Log.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð:

  • valor - valor que cal comprovar;
  • ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ (opcional) - especifiqueu els ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ que voleu esborrar.

Els espais en blanc es retallen a les dues bandes per defecte (si no s'especifiquen ³¦²¹°ù¨¤³¦³Ù±ð°ù²õ 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,³¦²¹³¾¨ª,<predeterminat>)

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

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ:

  • valor - el valor que cal comprovar;
  • ³¦²¹³¾¨ª - el ³¦²¹³¾¨ª (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.