Table of Contents
8 funções de string
Todas as funções listadas aqui são suportadas em:
Algumas notas gerais sobre parâmetros de função:
- Os parâmetros da função são separados por uma vírgula
- Expressões são aceitas como parâmetros
- Parâmetros de string devem estar entre aspas duplas; caso contrário, eles podem obter mal interpretado
- Parâmetros de função opcionais (ou partes de parâmetros) são indicados por
<>
| FUNÇÃO | |||
|---|---|---|---|
| Descrição | Parâmetros específicos da função | Comentários | |
| ascii (valor) | |||
| O código ASCII do caractere mais à esquerda do valor. | valor - valor a ser verificado | Tipos de valor suportados: string, texto, log Por exemplo, um valor como 'Abc' return '65' (código ASCII para 'A'). Exemplo: => ascii(last(/host/key)) |
|
| comprimento de bits (valor) | |||
| O comprimento do valor em bits. | valor - valor a verificar | Tipos de valor suportados: string, texto, log, inteiro Exemplo: => comprimento de bits (last(/host/chave)) |
|
| bytelength (valor) | |||
| O comprimento do valor em bytes. | valor - valor a ser verificado | Tipos de valor suportados: string, texto, log, inteiro Exemplo: => bytelength (last(/host/chave)) |
|
| char (valor) | |||
| Retorne o caractere interpretando o valor como código ASCII. | valor - valor a ser verificado | Tipos de valor suportados: integer O valor deve estar no intervalo de 0 a 255. Por exemplo, um valor como '65' (interpretado como código ASCII) retornará 'A'. Exemplo: => char(last(/host/key)) |
|
| concat (<valor1>,<valor2>,...) | |||
| A string resultante da concatenação de valores de itens referenciados ou valores constantes. | valor - um valor retornado por uma das funções de histórico ou um valor constante (string, integer ou float number) | Tipos de valor suportados: string, text, log, float, integer Para Por exemplo, um valor como 'Zab' concatenado a 'bix' (a string constante) retornará 'Zabbix'. Deve conter pelo menos dois parâmetros. Exemplos: => concat(last(/host/key),"bix") => concat("1 min: ",last(/host/system.cpu.load[all,avg1]),", 15 min: ",last(/host/system.cpu.load[all,avg15])) |
|
| inserir (valor,início,comprimento,substituição) | |||
| Insira caracteres ou espaços especificados na string de caracteres começando na posição especificada na string. | valor - valor a ser verificado start - posição inicial comprimento - posições para substituir substituição - substituição string |
Tipos de valor suportados: string, texto, log Por exemplo, um valor como 'Zabbbix' será substituído por 'Zabbix' se 'bb ' (posição inicial 3, posições para substituir 2) é substituído por 'b'. Exemplo: => insert(last(/host/key),3 ,2,"b") |
|
| esquerda (valor,contagem) | |||
| Os caracteres mais à esquerda do valor. | valor - valor a ser verificado count - número de caracteres a serem retornados |
Tipos de valor suportados: string, texto, log Por exemplo, você pode retornar 'Zab' de 'Zabbix' especificando 3 caracteres mais à esquerda para retornar. Exemplo: => left(last(/host/key),** 3**) - retorna três caracteres mais à esquerda Veja também à direita(). |
|
| comprimento (valor) | |||
| O comprimento do valor em caracteres. | valor - valor a ser verificado | Tipos de valor suportados: str, text, log Exemplo: => length(last (/host/key)) → comprimento do valor mais recente => comprimento(last(/host/key,#3)) → comprimento do terceiro valor mais recente => * *length**(last(/host/key,#1:now-1d)) → comprimento do valor mais recente um dia atrás |
|
| ltrim (valor,<chars>) | |||
| Remova os caracteres especificados do início da string. | value - valor a ser verificado chars - (opcional) especifique os caracteres a serem removidos O espaço em branco é cortado à esquerda por default (se nenhum caractere opcional for especificado). |
Tipos de valor suportados: string, text, log Exemplo: => ltrim(last(/host/key)) - remove whitespace do início da string => ltrim(last(/host/key),"Z") - remova qualquer 'Z' do início da string => ** ltrim(last(/host/key)," Z"**) - remove qualquer espaço e 'Z' do início da string Veja também: rtrim(), trim() |
|
| meio (valor,início,comprimento) | |||
| Retorna uma substring de N caracteres começando na posição do caractere especificada por 'start'. | value - valor a ser verificado start - posição inicial da substring **length* * - posições para retornar em substring |
Tipos de valor suportados: string, texto, log Por exemplo, é possível retornar 'abbi' de um valor como 'Zabbix' se a posição inicial for 2 e posições a serem retornadas é 4). Exemplo: => mid(last(/host/key),2,4)="abbi" |
|
| repetir (valor,contagem) | |||
| Repita uma string. | valor - valor a verificar count - número de vezes a repetir |
Tipos de valor suportados: string, texto, log Exemplo:< br>=> repetir(last(/host/key),2) - repita o valor duas vezes |
|
| substituir (valor, padrão, substituição) | |||
| Encontrar patern no valor e substituir por substituição. Todas as ocorrências do padrão serão substituídas. | valor - valor a ser verificado padrão - padrão a ser encontrado substituição - string para substituir o padrão por |
Tipos de valor suportados : string, texto, log Exemplo: => replace(last(/host/key),"ibb","abb") - substitua todos os 'ibb' por 'abb' |
|
| direita (valor,contagem) | |||
| Os caracteres mais à direita do valor. | valor - valor a ser verificado count - número de caracteres a serem retornados |
Tipos de valor suportados: string, texto, log Por exemplo, você pode retornar 'bix' de 'Zabbix' especificando 3 caracteres mais à direita para retornar. Exemplo: => right(last(/host/key),** 3**) - retorna três caracteres mais à direita Veja também left(). |
|
| rtrim (valor,<chars>) | |||
| Remova os caracteres especificados do final da string. | value - valor a ser verificado chars - (opcional) especifique os caracteres a serem removidos O espaço em branco é cortado à direita por default (se nenhum caractere opcional for especificado). |
Tipos de valor suportados: string, text, log Exemplo: => rtrim(last(/host/key)) - remove whitespace do final da string => rtrim(last(/host/key),"x") - remova qualquer 'x' do final da string => ** rtrim(last(/host/key),"x "**) - remove qualquer 'x' ou espaço do final da string Veja também: ltrim(), trim() |
|
| trim (valor,<chars>) | |||
| Remova os caracteres especificados do início e do final da string. | value - valor a ser verificado chars - (opcional) especifique os caracteres a serem removidos Espaço em branco é cortado de ambos os lados por padrão (se nenhum caractere opcional for especificado). |
Tipos de valor suportados: string, text, log Exemplo: => trim(last(/host/key)) - remova o espaço em branco do início e do final da string => trim(last(/host/key),"_") - remova '_' do início e do final de string Veja também: ltrim(), rtrim() |
|