[comment]: # attributes: notoc

[comment]: # translation:outdated

[comment]: # ({ee623e7f-b12f316b})
# 9 Tekstfuncties

Alle hier vermelde functies worden ondersteund in:

-   [Trigger expressies](/manual/config/triggers/expression)
-   [Berekende items](/manual/config/items/itemtypes/calculated)

De functies worden vermeld zonder aanvullende informatie. Klik op de functie om de volledige details te zien.

|Functie|Beschrijving|
|--|--------|
|[ascii](#ascii)|De ASCII-code van het meest linkse teken van de waarde.|
|[bitlength](#bitlength)|De lengte van de waarde in bits.|
|[bytelength](#bytelength)|De lengte van de waarde in bytes.|
|[char](#char)|Geef het teken terug door de waarde te interpreteren als ASCII-code.|
|[concat](#concat)|De string die wordt verkregen door de waarden van de gerefereerde items of constante waarden samen te voegen.|
|[insert](#insert)|Voeg opgegeven tekens of spaties in het tekenreeks in, te beginnen op de opgegeven positie in de tekenreeks.|
|[left](#left)|Geef de meest linkse tekens van de waarde terug.|
|[length](#length)|De lengte van de waarde in tekens.|
|[ltrim](#ltrim)|Verwijder opgegeven tekens van het begin van de tekenreeks.|
|[mid](#mid)|Geef een substring van N tekens terug die begint bij de positie van het teken die wordt opgegeven door 'start'.|
|[repeat](#repeat)|Herhaal een tekenreeks.|
|[replace](#replace)|Zoek het patroon in de waarde en vervang dit door de vervanging.|
|[right](#right)|Geef de meest rechtse tekens van de waarde terug.|
|[rtrim](#rtrim)|Verwijder opgegeven tekens van het einde van de tekenreeks.|
|[trim](#trim)|Verwijder opgegeven tekens van het begin en einde van de tekenreeks.|

[comment]: # ({/ee623e7f-b12f316b})

[comment]: # ({a11d2557-e91f4bca})
### Functie details

Enkele algemene opmerkingen over functieparameters:

-   Functieparameters worden gescheiden door een komma
-   Uitdrukkingen worden geaccepteerd als parameters
-   Tekstparameters moeten tussen dubbele aanhalingstekens staan; anders kunnen ze verkeerd worden geïnterpreteerd
-   Optionele functieparameters (of parameterdelen) worden aangeduid met `<` `>`

[comment]: # ({/a11d2557-e91f4bca})

[comment]: # ({1aeeff8e-6bdf63a4})
##### ascii(waarde) {#ascii}

De ASCII-code van het meest linkse teken van de waarde.<br>
Ondersteunde waarsetypes: *String*, *Text*, *Log*.

Parameter:

-   **waarde** - de waarde om te controleren

Bijvoorbeeld, een waarde als 'Abc' zal '65' teruggeven (ASCII-code voor 'A').

Voorbeeld:

    ascii(last(/host/key))

Sure, I will continue with the translations. Just let me know which functions you would like me to translate next.

[comment]: # ({/1aeeff8e-6bdf63a4})

[comment]: # ({b17a6f51-30f96a52})
##### bitlengte(waarde) {#bitlengte}

De lengte van de waarde in bits.<br>
Ondersteunde waarsetypes: *String*, *Text*, *Log*, *Integer*.

Parameter:

-   **waarde** - de waarde om te controleren

Voorbeeld:

    bitlengte(last(/host/key))

[comment]: # ({/b17a6f51-30f96a52})

[comment]: # ({61fbbd3c-d58806ed})
##### bytelengte(waarde) {#bytelengte}

De lengte van de waarde in bytes.<br>
Ondersteunde waarsetypes: *String*, *Text*, *Log*, *Integer*.

Parameter:

-   **waarde** - de waarde om te controleren

Voorbeeld:

    bytelengte(last(/host/key))

[comment]: # ({/61fbbd3c-d58806ed})

[comment]: # ({8c89cb7e-e35a326a})
##### teken(waarde) {#teken}

Geef het teken terug door de waarde te interpreteren als ASCII-code.<br>
Ondersteunde waarsetypes: *Integer*.

Parameter:

-   **waarde** - de waarde om te controleren

De waarde moet binnen het bereik van 0-255 liggen. Bijvoorbeeld, een waarde als '65' (geïnterpreteerd als ASCII-code) zal 'A' teruggeven.

Voorbeeld:

    teken(last(/host/key))

[comment]: # ({/8c89cb7e-e35a326a})

[comment]: # ({de915c4a-5e2f76e5})
##### concat(<waarde1>,<waarde2>,...) {#concat}

De string die ontstaat door de waarden van de genoemde items of constante waarden te concateneren.<br>
Ondersteunde waardepunten: *String*, *Tekst*, *Log*, *Float*, *Integer*.

Parameter: 

-   **waardeX** - de waarde die wordt geretourneerd door een van de history functies of een constante waarde (string, integer of drijvend nummer). Moet minstens twee parameters bevatten.

Bijvoorbeeld, een waarde zoals 'Zab' samengevoegd met 'bix' (de constante string) zal 'Zabbix' retourneren.

Voorbeelden:

    concat(last(/host/key),"bix")
    concat("1 min: ",last(/host/systeem.cpu.belasting[all,avg1]),", 15 min: ",last(/host/systeem.cpu.belasting[all,avg15]))

[comment]: # ({/de915c4a-5e2f76e5})

[comment]: # ({new-06698de3})

##### insert(value,start,length,replacement) {#insert}

Insert specified characters or spaces into the character string beginning at the specified position in the string.<br>
Supported value types: *String*, *Text*, *Log*.

Parameter: 

-   **value** - the value to check;<br>
-   **start** - start position;<br>
-   **length** - positions to replace;<br>
-   **replacement** - replacement string.

For example, a value like 'Zabbbix' will be replaced by 'Zabbix' if 'bb' (starting position 3, positions to replace 2) is replaced by 'b'.

Example:

    insert(last(/host/key),3,2,"b")

[comment]: # ({/new-06698de3})

[comment]: # ({new-2791e6b1})

##### jsonpath(value,path,<default>) {#jsonpath}

Return JSONPath result.<br>
Supported value types: *String*, *Text*, *Log*.

Parameters: 

-   **value** - the value to check;<br>
-   **path** - the path (must be quoted);<br>
-   **default** - the optional fallback value if the JSONPath query returns no data. Note that on other errors failure is returned (e.g. "unsupported construct").

Example:

    jsonpath(last(/host/proc.get[zabbix_agentd,,,summary]),"$..size")

[comment]: # ({/new-2791e6b1})

[comment]: # ({e83a547b-16f928ed})
##### left(waarde,aantal) {#left}

De meest linkse tekens van de waarde retourneren.<br>
Ondersteunde waardepunten: *String*, *Tekst*, *Log*.

Parameter: 

-   **waarde** - de te controleren waarde;<br>
-   **aantal** - het aantal te retourneren tekens.

Bijvoorbeeld, je kunt 'Zab' terugkrijgen van 'Zabbix' door aan te geven dat de meest linkse 3 tekens moeten worden geretourneerd. Zie ook [right()](#right).

Voorbeeld:

    left(last(/host/key),3) #retourneer de drie meest linkse tekens

[comment]: # ({/e83a547b-16f928ed})

[comment]: # ({07331e1d-b8f86065})
##### length(waarde) {#length}

De lengte van de waarde in tekens.<br>
Ondersteunde waardepunten: *String*, *Tekst*, *Log*.

Parameter: 

-   **waarde** - de te controleren waarde.

Voorbeelden:

    length(last(/host/key)) #de lengte van de meest recente waarde
    length(last(/host/key,#3)) #de lengte van de op twee na meest recente waarde
    length(last(/host/key,#1:nu-1d)) #de lengte van de meest recente waarde van één dag geleden

[comment]: # ({/07331e1d-b8f86065})

[comment]: # ({db800202-01a5023c})
##### ltrim(waarde,<tekens>) {#ltrim}

Specifieke tekens verwijderen van het begin van de tekenreeks.<br>
Ondersteunde waardepunten: *String*, *Tekst*, *Log*.

Parameter: 

-   **waarde** - de te controleren waarde;<br>
-   **tekens** (optioneel) - specificeer de tekens die verwijderd moeten worden.

Spaties aan het begin worden standaard verwijderd (als er geen optionele tekens zijn gespecificeerd). Zie ook: [rtrim()](#rtrim), [trim()](#trim).

Voorbeelden:

    ltrim(last(/host/key)) #verwijder spaties van het begin van de tekenreeks
    ltrim(last(/host/key),"Z") #verwijder eventuele 'Z' van het begin van de tekenreeks
    ltrim(last(/host/key)," Z") #verwijder eventuele spatie en 'Z' van het begin van de tekenreeks

[comment]: # ({/db800202-01a5023c})

[comment]: # ({493e6fa0-de3605ed})
##### mid(waarde,start,lengte) {#mid}

Een substring van N tekens retourneren, beginnend op de tekenpositie die is opgegeven door 'start'.<br>
Ondersteunde waardepunten: *String*, *Tekst*, *Log*.

Parameter: 

-   **waarde** - de te controleren waarde;<br>
-   **start** - startpositie van de substring;<br>
-   **lengte** - posities om te retourneren in de substring.

Bijvoorbeeld, het is mogelijk om 'abbi' terug te krijgen van een waarde zoals 'Zabbix' als de startpositie 2 is en het aantal posities om terug te geven 4 is.

Voorbeeld:

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

[comment]: # ({/493e6fa0-de3605ed})

[comment]: # ({40e5740b-9e3e42f7})
##### repeat(waarde,aantal) {#repeat}

Een tekenreeks herhalen.<br>
Ondersteunde waardepunten: *String*, *Tekst*, *Log*.

Parameter: 

-   **waarde** - de te controleren waarde;<br>
-   **aantal** - het aantal keren dat de herhaling moet plaatsvinden.

Voorbeeld:

    repeat(last(/host/key),2) #herhaal de waarde twee keer

[comment]: # ({/40e5740b-9e3e42f7})

[comment]: # ({9a951e28-6aa607aa})
##### replace(waarde,patroon,vervanging) {#replace}

Het patroon vinden in de waarde en vervangen door de opgegeven vervanging. Alle voorkomens van het patroon zullen worden vervangen.<br>
Ondersteunde waardepunten: *String*, *Tekst*, *Log*.

Parameter: 

-   **waarde** - de te controleren waarde;<br>
-   **patroon** - het patroon om te zoeken;<br>
-   **vervanging** - de tekenreeks waarmee het patroon moet worden vervangen.

Voorbeeld:

    replace(last(/host/key),"ibb","abb") - vervang alle 'ibb' door 'abb'

[comment]: # ({/9a951e28-6aa607aa})

[comment]: # ({785cf7f4-ccefcd9e})
##### right(waarde,aantal) {#right}

De meest rechtse tekens van de waarde retourneren.<br>
Ondersteunde waardepunten: *String*, *Tekst*, *Log*.

Parameter: 

-   **waarde** - de te controleren waarde;<br>
-   **aantal** - het aantal te retourneren tekens.

Bijvoorbeeld, je kunt 'bix' terugkrijgen van 'Zabbix' door aan te geven dat de meest rechtse 3 tekens moeten worden geretourneerd. Zie ook [left()](#left).

Voorbeeld:

    right(last(/host/key),3) #retourneer de drie meest rechtse tekens

[comment]: # ({/785cf7f4-ccefcd9e})

[comment]: # ({20aa9a8f-6e9972ef})
##### rtrim(waarde,<tekens>) {#rtrim}

Specifieke tekens verwijderen van het einde van de tekenreeks.<br>
Ondersteunde waardepunten: *String*, *Tekst*, *Log*.

Parameter: 

-   **waarde** - de te controleren waarde;<br>
-   **tekens** (optioneel) - specificeer de tekens die verwijderd moeten worden.

Spaties aan het einde worden standaard verwijderd (als er geen optionele tekens zijn gespecificeerd). Zie ook: [ltrim()](#ltrim), [trim()](#trim).

Voorbeelden:

    rtrim(last(/host/key)) #verwijder spaties van het einde van de tekenreeks
    rtrim(last(/host/key),"x") #verwijder eventuele 'x' van het einde van de tekenreeks
    rtrim(last(/host/key),"x ") #verwijder eventuele 'x' en spatie van het einde van de tekenreeks

[comment]: # ({/20aa9a8f-6e9972ef})

[comment]: # ({fc585039-97fb4186})
##### trim(waarde,<tekens>) {#trim}

Specifieke tekens verwijderen van zowel het begin als het einde van de tekenreeks.<br>
Ondersteunde waardepunten: *String*, *Tekst*, *Log*.

Parameter: 

-   **waarde** - de te controleren waarde;<br>
-   **tekens** (optioneel) - specificeer de tekens die verwijderd moeten worden.

Spaties aan beide zijden worden standaard verwijderd (als er geen optionele tekens zijn gespecificeerd). Zie ook: [ltrim()](#ltrim), [rtrim()](#rtrim).

Voorbeelden:

    trim(last(/host/key)) - verwijder spaties van het begin en einde van de tekenreeks
    trim(last(/host/key),"_") - verwijder '_' van het begin en einde van de tekenreeks

[comment]: # ({/fc585039-97fb4186})

[comment]: # ({new-b7fde6b3})

##### xmlxpath(value,path,<default>) {#xmlxpath}

Return XML XPath result.<br>
Supported value types: *String*, *Text*, *Log*.

Parameters: 

-   **value** - the value to check;<br>
-   **path** - the path (must be quoted);<br>
-   **default** - the optional fallback value if the XML XPath query returns an empty nodeset. It will not be returned if the empty result is not a nodeset (i.e., empty string). On other errors failure is returned (e.g. "invalid expression").

Example:

    xmlxpath(last(/host/xml_result),"/response/error/status")

[comment]: # ({/new-b7fde6b3})

[comment]: # ({62849ca2-b8eeecec})
Zie [alle ondersteunde functies](/handleiding/bijlage/functies).

[comment]: # ({/62849ca2-b8eeecec})