Áú»¢¶Ä²©

9 Funciones de cadena

Todas las funciones enumeradas aqu¨ª son compatibles con:

Las funciones se enumeran sin informaci¨®n adicional. Haga clic en la funci¨®n para ver los detalles completos.

¹ó³Ü²Ô³¦¾±¨®²Ô ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô
ascii El c¨®digo ASCII del car¨¢cter m¨¢s a la izquierda del valor.
bitlength La longitud del valor en bits.
bytelength La longitud del valor en bytes.
char Devuelve el car¨¢cter interpretando el valor como c¨®digo ASCII.
concat La cadena resultante de concatenar los valores de elemento o valores constantes referenciados.
insert Inserte caracteres o espacios especificados en la cadena de caracteres comenzando en la posici¨®n especificada en la cadena.
left Devuelve los caracteres m¨¢s a la izquierda del valor.
length La longitud del valor en caracteres.
ltrim Eliminar los caracteres especificados del principio de la cadena.
mid Devuelve una subcadena de N caracteres que comienzan en la posici¨®n del car¨¢cter especificada por 'inicio'.
repeat Repetir una cadena.
replace Busque el ±è²¹³Ù°ù¨®²Ô en el valor y reempl¨¢celo con reemplazo.
right Devuelve los caracteres m¨¢s a la derecha del valor.
rtrim Eliminar los caracteres especificados del final de la cadena.
trim Elimina los caracteres especificados del principio y del final de la cadena.

Detalles de la funci¨®n

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 malinterpretados
  • Los par¨¢metros de funci¨®n opcionales (o partes de par¨¢metros) se indican mediante < >
ascii (valor)

El c¨®digo ASCII del car¨¢cter m¨¢s a la izquierda del valor.
Tipos de valores admitidos: Cadena, Texto, Registro.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç:

  • valor - el valor a comprobar

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.
Tipos de valores admitidos: Cadena, Texto, Registro, Entero.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç:

  • valor - el valor a comprobar

Ejemplo:

bitlength(last(/host/key))
bytelength(valor)

La longitud del valor en bytes.
Tipos de valores admitidos: Cadena, Texto, Registro, Entero.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç:

  • valor - el valor a comprobar

Ejemplo:

bytelength(last(/host/key))
char(valor)

Devuelve el car¨¢cter interpretando el valor como c¨®digo ASCII.
Tipos de valores admitidos: Entero.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç:

  • valor - el valor a comprobar

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 los valores de la m¨¦trica referenciada o los valores constantes.
Tipos de valores admitidos: Cadena, Texto, Registro, Float, Entero.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç:

  • valorX: el valor devuelto por una de las funciones hist¨®ricas o un valor constante (cadena, entero o n¨²mero flotante). Debe contener al menos dos par¨¢metros.

Por ejemplo, un valor como 'Zab' concatenado con 'bix' (la cadena constante) devolver¨¢ 'Áú»¢¶Ä²©'.

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.
Tipos de valores admitidos: Cadena, Texto, Registro.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç:

  • valor - el valor a comprobar;
  • inicio - posici¨®n inicial;
  • longitud - posiciones a reemplazar;
  • reemplazo - cadena de reemplazo.

Por ejemplo, un valor como 'Zabbbix' se reemplazar¨¢ 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, contar)

Devuelve los caracteres m¨¢s a la izquierda del valor.
Tipos de valores admitidos: Cadena, Texto, Registro.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç:

  • valor - el valor a comprobar;
  • contar: el n¨²mero de caracteres que se devolver¨¢n.

Por ejemplo, puede devolver 'Zab' desde 'Áú»¢¶Ä²©' especificando 3 caracteres situados m¨¢s a la izquierda para devolver. V¨¦ase tambi¨¦n right().

Ejemplo:

left(last(/host/key),3) #devuelve los tres caracteres m¨¢s a la izquierda
length(valor)

La longitud del valor en caracteres.
Tipos de valores admitidos: Cadena, Texto, Registro.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç:

  • valor: el valor a comprobar.

Ejemplos:

length(last(/host/key)) #la longitud del ¨²ltimo valor
       length(last(/host/key,#3)) #la longitud del tercer valor m¨¢s reciente
       length(last(/host/key,#1:now-1d)) #la longitud del valor m¨¢s reciente de hace un d¨ªa
ltrim(valor,<caracteres>)

Elimina los caracteres especificados desde el principio de la cadena.
Tipos de valores admitidos: Cadena, Texto, Registro.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç:

  • valor - el valor a comprobar;
  • caracteres (opcional): especifique los caracteres que desea eliminar.

Los espacios en blanco se recortan a la izquierda de forma predeterminada (si no se especifican caracteres opcionales). Ver tambi¨¦n: rtrim(), trim().

Ejemplos:

ltrim(last(/host/key)) #eliminar espacios en blanco desde el principio de la cadena
       ltrim(last(/host/key),"Z") #eliminar cualquier 'Z' del principio de la cadena
       ltrim(last(/host/key)," Z") #elimina cualquier espacio y 'Z' del principio de la cadena
mid(valor,inicio,longitud)

Devuelve una subcadena de N caracteres que comienza en la posici¨®n del car¨¢cter especificada por 'inicio'.
Tipos de valores admitidos: Cadena, Texto, Registro.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç:

  • valor - el valor a comprobar;
  • inicio - posici¨®n inicial de la subcadena;
  • longitud - posiciones para devolver en la subcadena.

Por ejemplo, es posible devolver 'abbi' a partir de un valor como 'Áú»¢¶Ä²©' si la posici¨®n inicial es 2 y las posiciones a devolver son 4.

Ejemplo:

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

Repetir una cadena.
Tipos de valores admitidos: Cadena, Texto, Registro.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç:

  • valor - el valor a comprobar;
  • count - el n¨²mero de veces que se repetir¨¢.

Ejemplo:

repeat(last(/host/key),2) #repetir el valor dos veces
replace(valor, ±è²¹³Ù°ù¨®²Ô, reemplazo)

Encuentre el ±è²¹³Ù°ù¨®²Ô en el valor y reempl¨¢celo con reemplazo. Se reemplazar¨¢n todas las apariciones del ±è²¹³Ù°ù¨®²Ô.
Tipos de valores admitidos: Cadena, Texto, Registro.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç:

  • valor - el valor a comprobar;
  • ±è²¹³Ù°ù¨®²Ô - el ±è²¹³Ù°ù¨®²Ô a encontrar;
  • reemplazo - la cadena con la que reemplazar el ±è²¹³Ù°ù¨®²Ô.

Ejemplo:

replace(last(/host/key),"ibb","abb") - reemplaza todo 'ibb' con 'abb'

Devuelve los caracteres situados m¨¢s a la derecha del valor.
Tipos de valores admitidos: Cadena, Texto, Registro.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç:

  • valor - el valor a comprobar;
  • contar: el n¨²mero de caracteres que se devolver¨¢n.

Por ejemplo, puede devolver 'bix' de 'Áú»¢¶Ä²©' especificando 3 caracteres situados m¨¢s a la derecha para devolver. V¨¦ase tambi¨¦n left().

Ejemplo:

right(last(/host/key),3) #devuelve tres caracteres situados m¨¢s a la derecha
rtrim(valor,<caracteres>)

Elimina los caracteres especificados al final de la cadena.
Tipos de valores admitidos: Cadena, Texto, Registro.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç:

  • valor - el valor a comprobar;
  • caracteres (opcional): especifique los caracteres que desea eliminar.

Los espacios en blanco se recortan a la derecha de forma predeterminada (si no se especifican caracteres opcionales). Ver tambi¨¦n: ltrim(), trim().

Ejemplos:

rtrim(last(/host/key)) #eliminar espacios en blanco del final de la cadena
       rtrim(last(/host/key),"x") #eliminar cualquier 'x' del final de la cadena
       rtrim(last(/host/key),"x ") #eliminar cualquier 'x' y espacio del final de la cadena
trim(valor,<caracteres>)

Elimina los caracteres especificados al principio y al final de la cadena.
Tipos de valores admitidos: Cadena, Texto, Registro.

±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç:

  • valor - el valor a comprobar;
  • caracteres (opcional): especifique los caracteres que desea eliminar.

Los espacios en blanco se recortan de ambos lados de forma predeterminada (si no se especifican caracteres opcionales). Ver tambi¨¦n: ltrim(), rtrim().

Ejemplos:

trim(last(/host/key)) - elimina los espacios en blanco del principio y el final de la cadena
       trim(last(/host/key),"_") - elimina '_' del principio y del final de la cadena

Consulte todas las funciones admitidas.