--- title: "Kifejezések / Szkriptnyelv" description: "A TapHome szkriptnyelv referenciája: smart rule-ok, értesítések, Modbus és Packet parser, a szkript eredménye, adattípusok, operátorok és mind a 104 függvény." url: "https://taphome.com/hu/docs/script/" language: hu lastmod: 2026-11-06 generator: hugo ai: topics: ["scripting-language","expressions","functions","data-types","smart-rules","parsing"] questions: ["Hogyan írhatok többsoros szkripteket a TapHome-ban?","Hol használhatom a TapHome szkriptnyelvét?","Hogyan használom az IF/ELSE utasításokat a TapHome kifejezésekben?","Hogyan dolgozhatok fel JSON adatokat TapHome szkriptben?","Mi a különbség a MIN és a MINSTRICT függvény között?","Hogyan dolgozhatok dátummal és idővel a TapHome szkriptekben?","Hogyan használom a LINEAR függvényt értékek interpolálására?","Milyen értéket ad vissza egy TapHome szkript?","Mit adhat vissza egy eszköz olvasó szkriptje?"] --- # Kifejezések / Szkriptnyelv Utoljára frissítve: 2026-11-06 ![TapHome Icon](https://taphome.com/documentation/script/script-icon.png) A TapHome egyetlen szkriptnyelvet használ a smart rule-okhoz, az értesítésekhez és az eszközintegrációkhoz. A szintaxis és a függvények mindenhol azonosak; csak az elérhető változók, konstansok és függvények függnek attól, hol fut a szkript. Az Android, Windows és macOS rendszerre készült alkalmazás a szkriptszerkesztőben kiemeli a szintaxist; az iOS rendszerre készült alkalmazás kiemelés nélkül jeleníti meg a szkriptet. ## Hol használhatók a szkriptek Ugyanaz a szkriptnyelv fut a smart rule-okban, az értesítésekben, valamint a Modbus és a Packet parser integrációban: | Környezet | Mit csinál a szkript | Mi jellemző a környezetre | |---|---|---| | **Egyenlet** smart rule | Egyetlen kifejezés az eszközök értékei felett. `TRUE` esetén az igaz műveletek, `FALSE` esetén a hamis műveletek futnak le. | `LastState`, `TriggerName` | | **Képlet** smart rule | Kiszámít egy értéket, amely minden kimeneti eszközbe beíródik. | `LastState`, `TriggerName` | | **Szkript** smart rule | Beolvassa az eszközök értékeit és újakat rendel hozzájuk; minden értékadásból az eszköz egy művelete lesz. | Olvasható/írható változók, `TriggerName` | | **Képlet** korlátozó feltétel | Eldönti, hogy a smart rule lefuthat-e. | `TRUE` engedi lefutni a szabályt | | **Értesítés** címe és üzenete | Összeállítja az értesítés szövegét. | Szöveget kell visszaadnia; az értesítés konstansai | | Modbus **modul olvasó szkriptje** | Lekérdezi a modult, jellemzően azért, hogy eszközhibákat jelezzen. | `MODBUS*` függvények | | Modbus **eszköz olvasó és író szkriptje** | A regiszterekből az eszköz értékét állítja elő, a kért értéket pedig visszaalakítja regiszterekké. | Az olvasás eredményéből lesz az eszköz értéke | | Modbus **inicializáló szkript** | Egyszer fut le, miután a modul csatlakozott. | Jellemzően `MODBUSWNE` | | Packet parser **olvasó és író szkriptek** | Kérést vagy parancsot küld HTTP, FTP, TCP, UDP vagy MQTT protokollon; HTTP és FTP esetén a választ is feldolgozza. | `SENDHTTPREQUEST`, `SENDDATA`, `MQTTPUBLISH` | | Packet parser **listener szkript** | Feldolgoz minden beérkező TCP- vagy UDP-csomagot és MQTT-üzenetet. | `RECEIVEDMSG` | | **Szolgáltatási attribútumok és szolgáltatási műveletek** (Modbus, Packet parser) | Diagnosztikai sorok és paraméterezhető gombok az alkalmazásban. | A művelet paraméterei a rövidítésük alapján | A `SLEEP` függvényt a smart rule-ok és az értesítések elutasítják (kivétel a Képlet korlátozó feltétel). Az `ADDERROR`, `ADDWARNING` és `ADDINFO` csak az eszközök szkriptjeiben működik. Hogy az egyes smart rule-ok mit adnak át a szkriptjüknek, azt a [Szkriptek a smart rule-okban és az értesítésekben](https://taphome.com/hu/docs/script/smart-rules/) oldal írja le; az integrációknak saját oldaluk van: [Modbus függvények](https://taphome.com/hu/docs/script/modbus/) és [Packet parser függvények](https://taphome.com/hu/docs/script/packet-parser/). ## A szkript eredménye A szkript utasítások listája. Az utoljára kiértékelt utasítás értéke a szkript eredménye. A [`RETURN`](https://taphome.com/hu/docs/script/basics/#return) a megadott értékkel idő előtt befejezi a szkriptet. ```taphome VAR a := 1; VAR b := 2; a + b; # Result: 3 ``` Az eszköz olvasó szkriptjének eredménye illeszkedjen az eszköz értékéhez, különben a szkript a `Return value 'X' does not match required return type constraint` hibával leáll: | Az eszköz értéke | Megengedett eredmény | |---|---| | Kapcsoló állapota, reed érintkező | `TRUE` vagy `FALSE` (számokat is elfogad), `NaN`, `Null` | | Többállású kapcsoló állapota | Szám (az egész szám választja ki az állapotot; a tizedes értéket nem utasítja el), `NaN`, `Null` | | Bármely más érték | Szám, `NaN`, `Null` | A `NaN` jelentése „az érték ismeretlen”, a `Null` jelentése „nincs érték”. Hogy a kettő hogyan viselkedik a kifejezésekben, azt a [Null és NaN](https://taphome.com/hu/docs/script/data-types/#null-and-nan) szakasz írja le. ## Referenciaoldalak ### A nyelv alapjai - [Szintaxis és vezérlési szerkezetek](https://taphome.com/hu/docs/script/basics/) — Utasítások, megjegyzések, literálok, `IF`, `SWITCH`, `WHILE` és `DO` ciklusok, `RETURN` - [Adattípusok](https://taphome.com/hu/docs/script/data-types/) — Számok, szöveg, strukturált és felsorolt típusok, gyűjtemények, `.Type`, típuskiterjesztés, `Null` és `NaN` - [Változók és konstansok](https://taphome.com/hu/docs/script/variables/) — Eszközváltozók, csoportértékek, modulváltozók, `VAR` és típusos deklarációk, tulajdonságok, a környezet konstansai - [Operátorok](https://taphome.com/hu/docs/script/operators/) — Az operátorok listája, precedencia, rövidzáras kiértékelés, Excel megfelelők ### Smart rule-ok és diagnosztika - [Smart rule-ok és értesítések](https://taphome.com/hu/docs/script/smart-rules/) — Egyenlet, Képlet, Szkript, a Képlet korlátozó feltétel és az értesítések - [Logika és diagnosztika](https://taphome.com/hu/docs/script/logic-and-diagnostics/) — `ISNULL`, `ISNAN`, `EQUALS`, `SLEEP`, `ADDERROR`, `ADDWARNING`, `ADDINFO`, `DEBOUNCE` - [Hibák](https://taphome.com/hu/docs/script/errors/) — Elemzési és futásidejű hibaüzenetek és a javításuk ### Számok és idő - [Statisztikák és Value info](https://taphome.com/hu/docs/script/value-info/) — Az eszköz statisztikái, Value info az utolsó változás idejével, az előző értékkel és a lezárt időszakok értékeivel - [Matematikai függvények](https://taphome.com/hu/docs/script/mathematical-functions/) — `MIN`, `MAX`, `AVG` (kihagyják az ismeretlen értékeket, a `…STRICT` változatok nem), `ABS`, `SIGN`, `SQRT`, `POWER`, `MOD`, `LOG`, `LN`, `DEWPOINT` - [Kerekítés és véletlenszámok](https://taphome.com/hu/docs/script/rounding-and-random/) — `ROUND`, `CEIL`, `FLOOR`, `RAND`, `RANDINT` - [Interpoláció és küszöbértékek](https://taphome.com/hu/docs/script/interpolation-and-thresholds/) — A `LINEAR` egy értéket az egyik tartományból a másikba képez le (például egy fényerő-szabályozási görbe), `HYSTERESIS` - [Dátum és idő](https://taphome.com/hu/docs/script/date-and-time/) — `NOW`, `DATETIME`, `DATETIMEADD`, `TIMESPAN`, `LOCALTIMEZONE` ### Szöveg, gyűjtemények és színek - [Szöveg és gyűjtemények](https://taphome.com/hu/docs/script/text-string-and-byte-array/) — `LENGTH`, `GETAT`, `SETAT`, `APPEND`, `INSERT`, `REMOVEAT`, `COPY`, `INDEXOF`, `REPLACE`, `SPLIT`, `COMPARE`, `BYTECOLLECTION`, `UINT16COLLECTION`, `BOOLCOLLECTION` - [Rendezés](https://taphome.com/hu/docs/script/sorting/) — `ORDER`, `ORDERINDEX` és ezek csökkenő és szigorú változatai - [Adattípus-konverziók](https://taphome.com/hu/docs/script/data-type-conversions/) — `TOSTRING`, `TODOUBLE`, `TOBYTES`, `ENCODE`, `DECODE` - [Színek](https://taphome.com/hu/docs/script/colours/) — `HSVTORGB`, `RGBTOHSV` - [Elemző függvények](https://taphome.com/hu/docs/script/parsing-functions/) — `PARSETEXT`, `PARSEJSON` (értéket olvas ki a JSON-ból az útvonala alapján), `PARSEXML` ### Bináris adatok és biztonság - [Bitműveletek](https://taphome.com/hu/docs/script/bit-operations/) — `GETBIT`, `GETBITS`, `SETBIT`, `SETBITS`, `GETBYTE`, `SETBYTE`, `TOBCD`, `FROMBCD` - [Bináris adatok](https://taphome.com/hu/docs/script/binary-data/) — `PACKVALUE`, `UNPACKVALUE` - [Titkosítás és hash-ek](https://taphome.com/hu/docs/script/encryption-and-hashes/) — `AESENCRYPT`, `AESDECRYPT`, `HASH`, `HMAC`, `RANDBYTES` - [Bájtkódolások és ellenőrzőösszegek](https://taphome.com/hu/docs/script/byte-encodings/) — `TOBASE64`, `FROMBASE64`, `TOHEX`, `FROMHEX`, `CRC16`, `CRC32` ### Eszközintegrációk - [Modbus függvények](https://taphome.com/hu/docs/script/modbus/) — Regisztertípusok, `MODBUSR`, `MODBUSW`, `MODBUSWNE`, `MODBUSRBLOCK`, `MODBUSWBLOCK`, `MODBUSWBLOCKNE` - [Modbus szkriptek](https://taphome.com/hu/docs/script/modbus-scripts/) — Milyen szkriptjei vannak egy Modbus modulnak és eszköznek, mikor futnak, prefetch és gyorsítótárazás - [Modbus adattípusok](https://taphome.com/hu/docs/script/modbus-data-types/) — A Modbus függvények adattípusai, bájtsorrend-változatok, 64 bites típusok, szöveg - [Packet parser függvények](https://taphome.com/hu/docs/script/packet-parser/) — `HTTPREQUEST`, `SENDHTTPREQUEST`, `SENDDATA`, `MQTTPUBLISH`, `FTPDOWNLOAD`, `FTPUPLOAD`, `COMPLETESERVICEATTRIBUTE`, `COMPLETESERVICEACTION` - [Listener szkriptek](https://taphome.com/hu/docs/script/listener-scripts/) — A Packet parser modul listener szkriptje, `RECEIVEDMSG` és `RECEIVEDBYTES` ### Példák és referencia - [Példák](https://taphome.com/hu/docs/script/examples/) — Teljes szkriptek valódi eszközsablonokból - [Verziókövetelmények](https://taphome.com/hu/docs/script/version-requirements/) — Melyik Core buildre van szüksége az egyes függvényeknek - [Függvények A–Z](https://taphome.com/hu/docs/script/functions-a-z/) — Minden függvény egy mondattal és hivatkozással