Documentation
Table of Contents
9 Funciones de cadena
Todas las funciones enumeradas aquí son compatibles con:
Algunas notas generales sobre los parámetros de función:
- Los parámetros de la función están separados por una coma.
- Se aceptan expresiones como parámetros.
- Los parámetros de cadena deben estar entre comillas dobles; de lo contrario podrían ser mal interpretados
- Los parámetros de función opcionales (o partes de parámetros) se indican mediante
<>
| FUNCIÓN | ||
|---|---|---|
| Descripción | Parámetros específicos de la función | Comentarios |
| ascii (valor) | ||
| El código ASCII del carácter más a la izquierda del valor. | valor - valor a comprobar | Tipos de valores admitidos: cadena, texto, registro Por ejemplo, un valor como 'Abc' devolverá ' 65' (código ASCII para 'A'). Ejemplo: => ascii(last(/host/key)) |
| bitlength (valor) | ||
| La longitud del valor en bits. | valor - valor a comprobar | Tipos de valores admitidos: cadena, texto, registro, entero Ejemplo: => bitlength(last (/host/clave)) |
| bytelength (valor) | ||
| La longitud del valor en bytes. | valor - valor a comprobar | Tipos de valores admitidos: cadena, texto, registro, entero Ejemplo: => bytelength(last (/host/clave)) |
| char (valor) | ||
| Devuelve el carácter interpretando el valor como código ASCII. | valor - valor a comprobar | Tipos de valores admitidos: entero El valor debe estar en el rango 0-255. Por ejemplo, un valor como '65' (interpretado como código ASCII) devolverá 'A'. Ejemplo: => char(last(/host/key)) |
| concat (<valor1>,<valor2>,...) | ||
| La cadena resultante de concatenar valores de elementos referenciados o valores constantes. | valor: un valor devuelto por una de las funciones de historial o un valor constante (cadena, entero o número flotante) | Tipos de valores admitidos: cadena, texto, registro, flotante, entero Para Por ejemplo, un valor como 'Zab' concatenado con 'bix' (la cadena constante) devolverá 'Zabbix'. Debe contener al menos dos parámetros. Ejemplos: => 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 (valor,inicio,longitud,reemplazo) | ||
| Inserte caracteres o espacios especificados en la cadena de caracteres comenzando en la posición especificada en la cadena. | valor - valor a verificar inicio - posición inicial longitud - posiciones para reemplazar reemplazo - cadena de reemplazo |
Tipos de valores admitidos: cadena, texto, registro Por ejemplo, un valor como 'Zabbbix' será reemplazado por 'Zabbix' si 'bb' ( posición inicial 3, posiciones para reemplazar 2) se reemplaza por 'b'. Ejemplo: => insert(last(/host/key),3,* *2,"b"**) |
| left (valor,recuento) | ||
| Los caracteres más a la izquierda del valor. | valor - valor a comprobar recuento - número de caracteres a devolver |
Tipos de valores admitidos: cadena, texto, registro Por ejemplo , puede devolver 'Zab' desde 'Zabbix' especificando los 3 caracteres más a la izquierda para devolver. Ejemplo: => left(last(/host/key),**3* *) - devuelve tres caracteres situados más a la izquierda Ver también derecha(). |
| length (valor) | ||
| La longitud del valor en caracteres. | valor - valor a comprobar | Tipos de valores admitidos: cadena, texto, registro Ejemplo: => length(last(/ host/clave)) → longitud del último valor => length(last(/host/key,#3)) → longitud del tercer valor más reciente => length (last(/host/key,#1:now-1d)) → longitud del valor más reciente hace un día |
| ltrim (valor,<caracteres>) | ||
| Eliminar caracteres especificados desde el principio de la cadena. | valor - valor a verificar caracteres - (opcional) especificar caracteres a eliminar Los espacios en blanco se recortan a la izquierda de forma predeterminada ( si no se especifican caracteres opcionales). |
Tipos de valores admitidos: cadena, texto, registro Ejemplo: => ltrim(last(/host/key)) - elimine los espacios en blanco del comienzo de la cadena => ltrim(last(/host/key),"Z") - elimina cualquier 'Z' del comienzo de la cadena => **ltrim* *(last(/host/key)," Z") - elimina cualquier espacio y 'Z' del principio de la cadena Ver también: rtrim(), trim() |
| mid (valor,inicio,longitud) | ||
| Devuelve una subcadena de N caracteres que comienzan en la posición de carácter especificada por 'inicio'. | valor - valor a verificar inicio - posición inicial de la subcadena longitud - posiciones para devolver en la subcadena |
Tipos de valores admitidos: cadena, texto, registro Por ejemplo, es posible devolver 'abbi' a partir de un valor como 'Zabbix' si la posición inicial es 2 y las posiciones para devolver son 4 ). Ejemplo: => mid(last(/host/key),2,4)="abbi" |
| repeat (valor,recuento) | ||
| Repetir una cadena. | valor - valor a verificar count - número de veces a repetir |
Tipos de valores admitidos: cadena, texto, registro Ejemplo: => repeat(last(/host/key),2) - repite el valor dos veces |
| replace (valor,patrón,reemplazo) | ||
| Encuentre un patrón en el valor y reemplácelo con reemplazo. Se reemplazarán todas las apariciones del patrón. | valor - valor para verificar patrón - patrón para buscar reemplazo - cadena para reemplazar el patrón con |
Tipos de valores admitidos : cadena, texto, registro Ejemplo: => replace(last(/host/key),"ibb","abb") - reemplace todo 'ibb' con 'abb' |
| right (valor,recuento) | ||
| Los caracteres situados más a la derecha del valor. | valor - valor a comprobar recuento - número de caracteres a devolver |
Tipos de valores admitidos: cadena, texto, registro Por ejemplo , puede devolver 'bix' desde 'Zabbix' especificando 3 caracteres situados más a la derecha para devolver. Ejemplo: => right(last(/host/key),**3* *) - devuelve tres caracteres situados más a la derecha Ver también left(). |
| rtrim (valor,<caracteres>) | ||
| Eliminar caracteres especificados al final de la cadena. | valor - valor a verificar caracteres - (opcional) especificar caracteres a eliminar Los espacios en blanco están recortados a la derecha de forma predeterminada ( si no se especifican caracteres opcionales). |
Tipos de valores admitidos: cadena, texto, registro Ejemplo: => rtrim(last(/host/key)) - elimine los espacios en blanco del fin de la cadena => rtrim(last(/host/key),"x") - elimina cualquier 'x' del final de la cadena => **rtrim* *(last(/host/key),"x ") - elimina cualquier 'x' o espacio del final de la cadena Ver también: ltrim(), trim() |
| trim (valor,<caracteres>) | ||
| Elimina los caracteres especificados del principio y el final de la cadena. | valor - valor a verificar caracteres - (opcional) especifica los caracteres a eliminar Los espacios en blanco se recortan de ambos lados de forma predeterminada (si no se especifican caracteres opcionales). |
Tipos de valores admitidos: cadena, texto, registro Ejemplo: => trim(last(/host/key)) - eliminar espacios en blanco desde el principio y el final de la cadena => trim(last(/host/key),"_") - elimina '_' del principio y el final de la cadena< br> Ver también: ltrim(), rtrim() |