---
title: "Sintaksa i tijek izvršavanja"
description: "Sintaksa skripte TapHome: točka sa zarezom, komentari, brojčani i tekstualni literali, blokovi IF i ELSEIF, SWITCH, petlje WHILE i DO, BREAK, CONTINUE, RETURN i sigurno dijeljenje s IF."
url: "https://taphome.com/hr/docs/script/basics/"
language: hr
lastmod: 2026-11-06
generator: hugo
ai:
  topics: ["scripting-language","syntax","control-flow","variables","expressions"]
  questions: ["Kako napisati višeredne skripte u sustavu TapHome?","Kako koristiti naredbe IF/ELSE u izrazima TapHome?","Kako radi naredba SWITCH u sustavu TapHome?","Kako napisati petlju WHILE ili DO u sustavu TapHome?","Kako napisati heksadecimalne ili binarne brojeve u sustavu TapHome?","Kako ukloniti pogrešku „Line in script: 1 Message: Division by zero” u skripti TapHome?","Kako sigurno podijeliti dvije varijable (va1/va2) tako da se formula primijeni samo kada je nazivnik veći od 0?","Kako upisati vrijednost 0 kada je uređaj u pogrešci ili umjesto broja vraća NaN?","Gdje se u skripti TapHome može napisati komentar?"]
---

# Sintaksa i tijek izvršavanja

Sintaksa skriptnog jezika TapHome: naredbe i točka sa zarezom, komentari, literali, IF u obliku funkcije i bloka, SWITCH, petlje WHILE i DO, BREAK, CONTINUE i RETURN.

Posljednje ažuriranje: 2026-11-06

Skripta TapHome je niz naredbi, svaka završena točkom sa zarezom, koja se može granati pomoću `IF` i `SWITCH` te ponavljati petljama `WHILE` i `DO`. Stranica opisuje komentare, literale (brojevi, heksadecimalne i binarne vrijednosti, tekst, zbirke), oblik funkcije i bloka naredbe `IF`, `SWITCH`, petlje s `BREAK` i `CONTINUE` te `RETURN`. Ključne riječi i nazivi ne razlikuju velika i mala slova, a skripta vraća vrijednost posljednje naredbe ako je `RETURN` ne završi ranije. Na primjer, `IF(va2 > 0, va1/va2, 0)` dijeli sigurno i izbjegava pogrešku `Division by zero`.

## Naredbe i točka sa zarezom

Skripta je niz naredbi, a svaka naredba završava točkom sa zarezom `;`. Blok naredbe (`IF … END`, `WHILE … LOOP`, `DO … LOOP WHILE …`) i komentari ne završavaju točkom sa zarezom. Ključne riječi i nazivi ne razlikuju velika i mala slova: `IF`, `if` i `If` su isto.

```taphome
# x počinje s 5
VAR x := 5;
IF x > 3
    x := x - 1;   # izvodi se samo kada je x veći od 3
END
# zadnji izraz je rezultat
x;
# Result: 4
```

Točka sa zarezom smije se izostaviti samo iza posljednje naredbe skripte; unutar bloka treba je svaka naredba, uključujući posljednju prije `END` ili `LOOP`. Ako unutar bloka nedostaje točka sa zarezom prije `END` ili `LOOP`, skripta se zaustavlja pogreškom `Unexpected character 'E' at the end of statement. Expected ';'` (`'L'` prije `LOOP`).

## Komentari

Komentar počinje znakom `#` i traje do kraja retka. Može stajati u vlastitom retku ili iza cjelovite naredbe: iza njezine točke sa zarezom ili iza `END`, `ELSE` ili `LOOP`.

```taphome
# početna vrijednost
VAR x := 5;          # komentar iza točke sa zarezom
IF x > 3
    x := 1;
END                  # kraj provjere
```

Znak `#` unutar naredbe (prije njezine točke sa zarezom ili iza uvjeta `IF` ili `WHILE`) završava pogreškom `Comment must start on a new line and inline comments are not supported`.

## Literali

Literal je vrijednost napisana izravno u skripti.

| Literal | Primjer | Napomene |
|---|---|---|
| Broj | `5`, `21.5`, `-3` | Decimalna točka `.`. Brojčani literal je `double`, pa je `5 / 2` jednako `2.5`. Bez eksponenta (`1e3`), bez točke na početku (`.5`). |
| Heksadecimalni | `0xA0A0`, `0xff` | Tip `int`, znamenke ne razlikuju velika i mala slova: `0xA0A0` je 41120. |
| Binarni | `0b10101010` | Tip `int`: 170. |
| Logička vrijednost | `TRUE`, `FALSE` | |
| Nepoznati broj | `NaN` | Nikad nije jednak ničemu; provjerava se funkcijom [`ISNAN`](https://taphome.com/hr/docs/script/logic-and-diagnostics/#isnan). |
| Bez vrijednosti | `Null` | Provjerava se funkcijom [`ISNULL`](https://taphome.com/hr/docs/script/logic-and-diagnostics/#isnull). |
| Niz znakova | `"°C"`, `"a\nb"`, `"C:\\data"` | Escape sekvence `\n`, `\r`, `\t`, `\"`, `\\`, `\xHH`, `\uXXXX`. Neispravna sekvenca završava pogreškom `Couldn't unescape …`. |
| Znak | `'A'`, `'\n'` | Točno jedan znak. |
| Zbirka | `{1, 2, 3}`, `{"a", "b"}` | Barem jedan element, vidi [Zbirke](https://taphome.com/hr/docs/script/data-types/#collections). |
| Vrijednost enuma | `H`, `BigEndianFloat`, `DateTimeKind.Utc` | Sama ili s nazivom tipa, vidi [Enum tipovi](https://taphome.com/hr/docs/script/data-types/#enum-types). |

## IF

`IF` vraća jednu od dviju vrijednosti ovisno o uvjetu (oblik funkcije) ili izvršava jedan od nekoliko blokova naredbi (oblik bloka).

```text
IF(condition, valueIfTrue)
IF(condition, valueIfTrue, valueIfFalse)
```

**Parametri**

| Naziv | Tip | Opis |
|---|---|---|
| `condition` | bool | Broj različit od nule je `TRUE`, `Null` je `FALSE`. |
| `valueIfTrue` | any | Vraća se kada je uvjet `TRUE`. |
| `valueIfFalse` | any | Neobavezno, vraća se u suprotnom. |

**Vraća** odabranu vrijednost ili `Null` kada uvjet nije `TRUE` i nema trećeg argumenta. Izračunava se samo odabrana grana, pa druga ne može završiti pogreškom.

**Primjer** — sigurno dijeljenje i zamjena za `NaN`. Dijeljenje nulom zaustavlja skriptu pogreškom `Line in script: 1 Message: Division by zero`; uvjet to sprječava:

```taphome
IF(va2 > 0, va1/va2, 0);
# Result: va1/va2, or 0 when va2 is 0
IF(ISNAN(Te), 0, Te);
# Result: 0 when the device is in error or returns NaN
```

**Oblik bloka**

```text
IF condition
    statements;
ELSEIF condition
    statements;
ELSE
    statements;
END
```

Uvjet smije biti u zagradama i mora stati u jedan redak; prijelom retka ga završava. `ELSEIF` se može ponavljati, `ELSE` je neobavezan, `END` je obavezan. Sam blok vraća `Null`; za vrijednost iz bloka koristite `RETURN`.

```taphome
# odaberi vrijednost prema temperaturi Te
IF Te < 5
    RETURN(1);   # ispod 5
ELSEIF Te > 10
    RETURN(3);   # iznad 10
ELSE
    RETURN(0);   # inače
END
```

**Pogreške** — `Function IF requires at least 2 parameters.`; `Unexpected keyword 'X' at the end of IF statement.` kada iza unutarnjeg `END` slijedi `;`.

**Vidi također** — [SWITCH](https://taphome.com/hr/docs/script/basics/#switch), [Operatori](https://taphome.com/hr/docs/script/operators/).

## SWITCH

`SWITCH` uspoređuje vrijednost s popisom slučajeva i vraća rezultat prvog odgovarajućeg slučaja ili zadani rezultat kada nijedan slučaj ne odgovara.

```text
SWITCH(value, case1, result1, case2, result2, ..., defaultResult)
```

**Napomene** — `SWITCH` prima najmanje 4 i najviše 100 argumenata, uvijek paran broj: vrijednost, parove slučaja i njegova rezultata te zadani rezultat. Slučajevi se uspoređuju kao kod `=`: brojevi po vrijednosti, tekst točno; usporedba teksta s brojem završava pogreškom `Operator '==' not defined …`. Izračunava se samo rezultat odgovarajućeg slučaja.

**Primjer** — priručnik uređaja navodi aktivni način rada kao vrijednosti bitova; skripta ih pretvara u položaje prekidača s više vrijednosti:

![SWITCH Example](https://taphome.com/documentation/script/switch-example.webp)

```taphome
# čita bitove načina rada iz Modbus registra 168
# vrijednost bita postaje položaj prekidača s više vrijednosti, inače NaN
SWITCH(MODBUSR(H, 168, UInt16),
    0, 0,
    0x0002, 1,
    0x0004, 2,
    0x0008, 3,
    0x0010, 4,
    0x0040, 5,
    0x0800, 6,
    NaN);
```

**Pogreške** — `Function SWITCH requires at least 4 parameters.`; `Invalid arguments for SWITCH function.` kod neparnog broja argumenata.

## Petlje WHILE i DO

`WHILE` ponavlja svoje naredbe dok je uvjet `TRUE`; `DO … LOOP WHILE` ih izvršava barem jednom. `CONTINUE;` preskače ostatak prolaza, `BREAK;` izlazi iz petlje; obje se pišu bez zagrada.

```text
WHILE condition
    statements;
LOOP

DO
    statements;
LOOP WHILE condition
```

Kao kod `IF`, uvjet završava prijelomom retka. Kada počinje znakom `(`, završava odgovarajućom `)`: `WHILE (a > 0) AND (b > 0)` uzima kao uvjet samo `(a > 0)`, pa napišite `WHILE (a > 0 AND b > 0)`.

```taphome
int i := 10;   # brojač počinje s 10
WHILE i > 0
    i := i - 1;   # odbrojavanje
    IF i > 5
        CONTINUE;   # preskoči ostatak prolaza dok je i iznad 5
    END
    BREAK;   # izađi iz petlje kad je i najviše 5
LOOP
i;
# Result: 5
```

```taphome
int n := 1;   # početna vrijednost
# tijelo se izvodi barem jednom, zatim dok je n < 100
DO
    n := n * 2;   # n se udvostručuje u svakom prolazu
LOOP WHILE n < 100
n;
# Result: 128
```

**Pogreške** — petlja se zaustavlja porukom `More than 1 000 000 loops, stopping loop`. `BREAK` ili `CONTINUE` izvan petlje završava pogreškom `Cannot use BREAK() outside of WHILE or DO-WHILE`. Znak `;` iza unutarnjeg `LOOP` ili `END` završava pogreškom `Unexpected character ';' in WHILE statement`.

> [!WARNING]
> Nazivi se razrješavaju prije ključnih riječi petlje. Varijabla ili kratica uređaja s nazivom `Do` ili `While` skriva ključnu riječ, a petlja završava pogreškom `Missing operator between 'DO' and …`.

## RETURN

`RETURN` odmah završava skriptu i zadanu vrijednost čini njezinim rezultatom.

```text
RETURN(value)
```

**Napomene** — bez `RETURN` rezultat je vrijednost posljednje naredbe. `RETURN` koristite za vraćanje vrijednosti iz bloka ili za prijevremeni završetak listener skripte kod poruka koje ne obrađuje.

```taphome
# završi skriptu s 0 kad je Te nepoznata
IF ISNAN(Te)
    RETURN(0);
END
# pretvorba temperature u °F
Te * 1.8 + 32;
# Result: the temperature in °F, or 0 when it is unknown
```

**Vidi također** — [Rezultat skripte](https://taphome.com/hr/docs/script/#script-result).
