Table of Contents

9 Funkcje tekstowe

Wszystkie funkcje wymienione tutaj są obsługiwane w:

Kilka ogólnych uwag na temat parametrów funkcji:

  • Parametry funkcji są oddzielone przecinkiem
  • Wyrażenia są akceptowane jako parametry
  • Parametry tekstowe muszą być ujęte w podwójne cudzysłowy; w przeciwnym razie mogą zostać błędnie zinterpretowane
  • Opcjonalne parametry funkcji (lub części parametrów) są wskazane przez < >
FUNKCJA
Opis Parametry specyficzne dla funkcji Komentarze
ascii (value)
Kod ASCII pierwszego znaku wartości. value - wartość do sprawdzenia Obsługiwane typy wartości: string, text, log

Na przykład, wartość 'Abc' zwróci '65' (kod ASCII dla 'A').

Przykład:
=> ascii(last(/host/key))
bitlength (value)
Długość wartości w bitach. value - wartość do sprawdzenia Obsługiwane typy wartości: string, text, log, integer

Przykład:
=> bitlength(last(/host/key))
bytelength (value)
Długość wartości w bajtach. value - wartość do sprawdzenia Obsługiwane typy wartości: string, text, log, integer

Przykład:
=> bytelength(last(/host/key))
char (value)
Zwraca znak, interpretując wartość jako kod ASCII. value - wartość do sprawdzenia Obsługiwane typy wartości: integer

Wartość musi mieścić się w zakresie 0-255. Na przykład, wartość '65' (interpretowana jako kod ASCII) zwróci 'A'.

Przykład:
=> char(last(/host/key))
concat (<value1>,<value2>,...)
Łańcuch znaków wynikający z połączenia wartości pozycji referencyjnych lub wartości stałych. value - wartość zwrócona przez jedną z funkcji historii lub wartość stała (ciąg, liczba całkowita lub liczba zmiennoprzecinkowa) Obsługiwane typy wartości: string, text, log, float, integer

Na przykład, wartość 'Zab' połączona z 'bix' (stały ciąg) zwróci 'Zabbix'.

Musi zawierać co najmniej dwa parametry.

Przykłady:
=> 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)
Wstawia określone znaki lub spacje do łańcucha znaków, zaczynając od określonej pozycji w łańcuchu. value - wartość do sprawdzenia
start - pozycja początkowa
length - pozycje do zastąpienia
replacement - ciąg zastępczy
Obsługiwane typy wartości: string, text, log

Na przykład, wartość 'Zabbbix' zostanie zastąpiona przez 'Zabbix', jeśli 'bb' (pozycja początkowa 3, pozycje do zastąpienia 2) zostanie zastąpione przez 'b'.

Przykład:
=> insert(last(/host/key),3,2,"b")
left (value,count)
Pierwsze znaki wartości po lewej stronie. value - wartość do sprawdzenia
count - liczba znaków do zwrócenia
Obsługiwane typy wartości: string, text, log

Na przykład, możesz zwrócić 'Zab' z 'Zabbix', określając 3 skrajne lewe znaki do zwrócenia.

Przykład:
=> left(last(/host/key),3) - zwróć trzy skrajne lewe znaki

Zobacz także right().
length (value)
Długość wartości w znakach. value - wartość do sprawdzenia Obsługiwane typy wartości: str, text, log

Przykład:
=> length(last(/host/key)) → długość najnowszej wartości
=> length(last(/host/key,#3)) → długość trzeciej najnowszej wartości
=> length(last(/host/key,#1:now-1d)) → długość najnowszej wartości sprzed jednego dnia
ltrim (value,<chars>)
Usuń określone znaki z początku ciągu. value - wartość do sprawdzenia
chars - (opcjonalnie) określ znaki do usunięcia

Domyślnie usuwane są białe znaki z lewej strony (jeśli nie określono opcjonalnych znaków).
Obsługiwane typy wartości: string, text, log

Przykład:
=> ltrim(last(/host/key)) - usuń białe znaki z początku ciągu
=> ltrim(last(/host/key),"Z") - usuń wszystkie 'Z' z początku ciągu
=> ltrim(last(/host/key)," Z") - usuń wszystkie spacje i 'Z' z początku ciągu

Zobacz także: rtrim(), trim()
mid (value,start,length)
Zwróć podciąg N znaków zaczynający się od określonej pozycji przez parametr 'start'. value - wartość do sprawdzenia
start - pozycja początkowa podciągu
length - liczba znaków do zwrócenia w podciągu
Obsługiwane typy wartości: string, text, log

Na przykład, możliwe jest zwrócenie 'abbi' z wartości 'Zabbix', jeśli pozycja początkowa to 2, a liczba znaków do zwrócenia to 4).

Przykład:
=> mid(last(/host/key),2,4)="abbi"
repeat (value,count)
Powtórz ciąg znaków. value - wartość do sprawdzenia
count - liczba powtórzeń
Obsługiwane typy wartości: string, text, log

Przykład:
=> repeat(last(/host/key),2) - powtórz wartość dwa razy
replace (value,pattern,replacement)
Znajdź wzorzec w wartości i zastąp go podaną zmienną. Wszystkie wystąpienia wzorca zostaną zastąpione. value - wartość do sprawdzenia
pattern - wzorzec do znalezienia
replacement - ciąg znaków do zastąpienia wzorca
Obsługiwane typy wartości: string, text, log

Przykład:
=> replace(last(/host/key),"ibb","abb") - zastąp wszystkie 'ibb' na 'abb'
right (value,count)
Ostatnie znaki wartości od prawej strony. value - wartość do sprawdzenia
count - liczba znaków do zwrócenia
Obsługiwane typy wartości: string, text, log

Na przykład, możesz zwrócić 'bix' z 'Zabbix', określając 3 skrajne prawe znaki do zwrócenia.

Przykład:
=> right(last(/host/key),3) - zwróć trzy skrajne prawe znaki

Zobacz także left().
rtrim (value,<chars>)
Usuń określone znaki z końca ciągu. value - wartość do sprawdzenia
chars - (opcjonalnie) określ znaki do usunięcia

Domyślnie usuwane są białe znaki z prawej strony (jeśli nie określono opcjonalnych znaków).
Obsługiwane typy wartości: string, text, log

Przykład:
=> rtrim(last(/host/key)) - usuń białe znaki z końca ciągu
=> rtrim(last(/host/key),"x") - usuń wszystkie 'x' z końca ciągu
=> rtrim(last(/host/key),"x ") - usuń wszystkie 'x' lub spacje z końca ciągu

Zobacz także: ltrim(), trim()
trim (value,<chars>)
Usuń określone znaki z początku i końca ciągu. value - wartość do sprawdzenia
chars - (opcjonalnie) określ znaki do usunięcia

Domyślnie usuwane są białe znaki z obu stron (jeśli nie określono opcjonalnych znaków).
Obsługiwane typy wartości: string, text, log

Przykład:
=> trim(last(/host/key)) - usuń białe znaki z początku i końca ciągu
=> trim(last(/host/key),"_") - usuń '_' z początku i końca ciągu

Zobacz także: ltrim(), rtrim()