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 | ||
|---|---|---|
| ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô | 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¨¢ 'Áú»¢¶Ä²©'. 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 'Áú»¢¶Ä²©' 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 'Áú»¢¶Ä²©' 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 'Áú»¢¶Ä²©' 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 (±¹²¹±ô´Ç°ù,±è²¹³Ù°ù¨®²Ô,°ù±ð±ð³¾±è±ô²¹³ú´Ç) | ||
| Encuentre un ±è²¹³Ù°ù¨®²Ô en el valor y reempl¨¢celo con reemplazo. Se reemplazar¨¢n todas las apariciones del ±è²¹³Ù°ù¨®²Ô. | valor - valor para verificar ±è²¹³Ù°ù¨®²Ô - ±è²¹³Ù°ù¨®²Ô para buscar reemplazo - cadena para reemplazar el ±è²¹³Ù°ù¨®²Ô 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 'Áú»¢¶Ä²©' 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() |