A Cor4 belső függvényei

A Cor4 megjelenítéssel kapcsolatos függvényei

A Cor4 függvényei

void addcacheabledatasource(int cachetime, string name, string fields [, string from [, string where [, string groupby [, string having [, string orderby]]]]])

Új adatforrást ad a megadott néven hozzá. Amennyiben ezzel a függvénnyel hozunk létre adatforrást, akkor a rendszer a cachetime paraméterben megadott ideig (másodpercben) tárolja azt, és ha ezen idő alatt újabb kérés érkezik az adatforrásra, akkor adatbázisművelet nélkül visszaadja a tárolt változatot.

Az AddCacheableDatasource(0,name,…) hívás egyenértékű az AddDatasource(name,…) hívással.

A további paraméterek az SQL lekérdezés megfelelő részei. Amennyiben a from paraméter üres, akkor a fields paraméterben a teljes lekérdezést várja.

Amennyiben már létezik ilyen, akkor egy ModifyCacheableDataSource() hívást eredményez.

void adddatasource(string name, string fields [, string from [, string where [, string groupby [, string having [, string orderby]]]]])

Új adatforrást ad a megadott néven hozzá. A további paraméterek az SQL lekérdezés megfelelő részei. Amennyiben a from paraméter üres, akkor a fields paraméterben a teljes lekérdezést várja.

Amennyiben már létezik ilyen, akkor egy ModifyDataSource() hívást eredményez.

void addevent(string name,string handler,string expression,int interval)

Hatására egy olyan eseménykezelő jön létre, amely minden interval másodpercben megvizsgálja, hogy az expression változott-e. Ha változott, akkor végrehajtja a handler-t. A futás után nem fut le az Onload handler! Első lefutásakor nem fut le a handler bármilyen értéket is ad az expression!

A name paraméter segítségével hivatkozhatunk rá a DelEvent függvényben.

void addopdata(string key, mixed value)

Csak COMPAT fordítású kliensben. Egyenértékű az OperationData[key] = value hívással. Használata kerülendő, mivel egyszerűen helyettesíthető és a régi webes CORE érdekesen hajtotta végre.

string arabic2roman(int value)

Visszaadja a megadott egész számot római számokkal leírva. Nem pozitív számokra üres sztringgel tér vissza.

Nagy számok irányában ellenőrzés nincs: az 1 000 000-ra 1000db “M” karaktert fog visszaadni.

mixed arrayprepare(mixed param)

Elavult függvényhívás! Csak a COMPAT fordítású kliensben. ¹⁾

Jelen megvalósításban a paramétert változatlanul visszaadja.

string cap(string str)

A paraméterben megadott szöveget átalakítja úgy, hogy csak az első betű legyen nagy betű, a többi kicsi.

void close()

Bezárja a futó alkalmazást, de nem szakítja meg az éppen aktuális handler futását! (amennyiben erre mégis szükség lenne egy exit paranccsal ezt megtehetjük)

string cor4encode(string str1 [,string str2 [, … ]])

A megadott karaktersorozatokból egy speciális algoritmus szerint 32 karakteres hash kódot generál. A kód (természetesen) nem visszafejthető.

bool createshortcut(int shift_state, int key_code, string condition, string jumpto)

A függvény új gyorsbillentyűt hoz létre. A megadott shift_state-key_code lenyomása esetén a condition paraméterben átadott kifejezés kiértékelésre kerül, és amennyiben az értéke igaz, akkor a jumpto paraméterben megadott helyre átugrik a vezérlés.

Amennyiben a megadott shift_state-key_code párossal már létezik gyorsbillentyű, akkor felülírja azt. Ha létezett már ilyen kombinációval gyors-billentyű, akkor a visszatérési érték true ellenkező esetben false.

A jumpto paraméterben minden lehetőség használható, ami a JumpTo változó esetében használható. A handler:… lehetőséggel és a DropShortCut függvény alkalmazásával elérhető, hogy egy adott oldalon tetszőleges gyors-billentyűt használjunk.

A függvényhez a következő konstansokat lehet használni:

A shift_state paraméterben:

A key_code paraméterben:

mixed datediff(string date1, string date2)

A megadott két paraméter dátumként értelmezett különbségét adja meg napban. A dátum formátuma megegyezik a DateStr2SQLDate függvénynél leírtakkal.

Amennyiben valamelyik paraméterében megadott karaktersorozat nem értelmezhető dátumként, akkor a visszaadott érték false.

mixed dateplus(string date, int delta)

Az első paraméterben megadott dátumhoz hozzáadja a delta paraméter értékét. A paraméterként átadott dátum formátuma megegyezik a DateStr2SQLDate függvénynél elfogadott formátummal, a visszaadott érték viszont mindig ”-”-et tartalmaz elválasztó jelként! A delta paraméter lehet negatív is.

Amennyiben a date paraméterben megadott karaktersorozat nem értelmezhető dátumként, akkor a visszaadott érték false.

mixed datestr2sqldate(string date)

A függvény a megadott stringből próbál az SQL számára emészthető formátumú dátum stringet fabrikálni.

Az elfogadott dátumnak három részből kell állnia (év, hónap, nap sorrendben), melyek között elválasztójelnek kell szerepelnie. Elválasztójel a következő karakterek közül lehet egy, vagy több: ”-”, ”/”, ”.”, ”:” és a ”,”. Az elválasztójeleket a string elejéről és végéről levágja.

Amennyiben a fenti módon nem három rész alakul ki, akkor a visszatérési érték false. Ha az év két jegyű, akkor kiegészíti 19xx / 20xx alakúra oly módon, hogy az 50 előttiek 20xx alakúak, az 50 illetve az utániak 19xx alakúak lesznek.

Amennyiben az év, hónap, nap hármas nem létező dátumot határoz meg, a visszatérési érték false.

Példák:

  // '1950-01-01'
  var_dump(datestr2sqldate('50-1-1'));
  // '1977-06-02'
  var_dump(datestr2sqldate('1977-06/2'));
  // '2047-02-05'
  var_dump(datestr2sqldate('47 2,5'));

bool define(string name, mixed value)

Az alapvető funkciója megegyezik a hasonló nevű PHP függvénnyel, de vannak apróbb, de lényeges különbségek. Egyrészt a PHPban létező harmadik paraméter nem megadható: a függvény úgy viselkedik, mintha a harmadik paraméter mindig igaz lenne, azaz Cor4-ben egy konstans sem érzékeny a kis-nagy betűs írásmódra. Másrészt a value paraméter bármilyen érték lehet, akár tömb is. Elfogad objektumot is, de nem túl szép konstansként definiálni objektumot.

bool delevent(string name)

Az AddEvent függvénnyel létrehozott eseménykezelőt törölhetjük vele. Amennyiben létezett olyan nevű eseménykezelő, akkor a visszatérési érték true, ellenkező esetben false.

void delopdata(string key [, string subkey])

Csak COMPAT fordítású kliensben.

Egy paraméterrel meghíva a hatása megegyezik az unset(OperationData[key]) hívással, míg két paraméter esetén egyenértékű az unset(OperationData[key][subkey]) hívással.

Igazából erre a függvényre sincs szükség az egyszerű helyettesíthetőség miatt.

bool deltree(string dir)

A megadott könyvtárat teljes tartalmával együtt törli. Siker esetén true értékkel tér vissza, ellenkező esetben false-al.

void disableauthorization()

Kikapcsolja az éppen aktuális jogosítást. Az összes paraméter nélküli konstruktorral létrehozott CAuthority objektum érvénytelen lesz és használatuk hibát okoz!

bool dropdatasource(string name)

A megadott nevű datasource-ot törli. A visszaadott érték igaz, ha a megadott néven létezett datasource, ellenkező esetben hamis.

bool dropshortcut(int shift_state,int key_code)

A CreateShortCut függvényben létrehozott gyorsbillentyűt törölhetjük vele ki. A két paraméter jelentése megegyezik az ott leírtakkal.

Ha létezett a megadott kombináció, akkor a visszatérési érték true, ellenkező esetben false.

void endalloperation()

Minden nyitott (sub)operation-t lezár. Ezt a függvényt főleg a menübe/főmenübe visszatérő handler-ekben használjuk, amikor le kell zárni az esetlegesen nyitott suboperation-okat. Az éppen aktuálisan nyitott operation is lezáródik.

bool endoperation()

Az éppen aktuálisan nyitott operation-t lezárja. Ezzel nem törlődnek az OperationData tömb elemei, csak nem lesznek átvíve a következő handler-be.

A visszaadott érték akkor true, ha a hívást megelőzően operation-ön belül voltunk, ellenkező esetben false.

bool execute(string cmdline)

Csak a natív verzióban létezik!

A paraméterben megadott (Windows^®-os) programot végrehajtja. Hasznos ilyenkor az INTERPRETER konstans ismerete, amely a jelenleg futó program teljes elérési útját tartalmazza.

A visszatérési érték akkor true, ha a megadott program futtatása sikeres volt, ellenkező esetben false.

bool executeandwait(string cmdline)

Annyiban különbözik az execute függvénytől, hogy addig vár, amíg a meghívott program le nem futott.

int file_put_contents(string filename, mixed data)

A filename fájlba írja a data értéket. Ha a data tömb, akkor az eredmény megegyezik a file_put_contents(filename, implode(””, data)) hívással. Annyiban különbözik a PHPs függvénytől, hogy a flags paraméter nem került megvalósításra.

array fileinformation(string filename)

Egy asszociatív tömböt ad vissza a megadott fájl adataival. A visszaadott tömb a következő kulcsokat tartalmazza:

• FileAttributes, integer: a fájl attribútumai; az érték a FILE_ATTRIBUTE_ kezdetű konstansokból áll össze
• CreationTime, integer: a fájl létrehozásának időpontja UNIX timestamp formátumban
• LastAccessTime, integer: a fájlhoz történő utolsó hozzáférés (írás vagy olvasás) időpontja UNIX timestamp formátumban
• LastWriteTime, integer: a fájlba történő utolsó írás időpontja UNIX timestamp formátumban
• FileSize, float: a fájl mérete bájtban (a típus azért nem integer, mert elképzelhetőek olyan méretű fájlok, amelyek mérete nem ábrázolható 32 bites egészként)
• FileName, string: a fájl neve az elérési út nélkül
• AlternateFileName, string: a fájl 8.3 tagolású neve

void fillform()

Az OperationData alapján kitölti a form mezőit. A gombnyomáskor automatikusan lefutó értékadás (amely az OperationData-ba másolja a form adatait) ellentettje.

mixed getdata(strig cell)

A cell paraméterben meghatározott komponenshez rendelt adatot adja vissza. A hozzárendelést a SetData az AddElement illetve az AddElementTo függvényekkel lehet megtenni.

array getips()

Egy numerikusan indexelt tömbben visszaadja az adott gépen regisztrált összes hálózati kártya IP címét (A 127.0.0.1-et nem, mert olyan hálókártya nincs, de például a VPN virtuális hálókártyájának IP címét igen)

string getnumastext(int num)

A megadott számot a langpack-ban definiált módon szövegesen adja vissza.

mixed getparams()

A SubOperation függvényben átadott paramétert adja vissza. A paraméter csak egy adott végrehajtási ciklusban létezik.

mixed getsystemvalue(string param)

A rendszer belső paramétereit lehet a függvény segítségével lekérdezni. A param a megfelelő rendszer beállítás neve a következő táblázat szerint:

array getusbserials()

A függvény visszaadja a csatlakoztatott USB pendrive(ok) azonosító számát (ha van nekik ilyen). Amennyiben az pendrive nem rendelkezik azonosítóval, a függvény azt a pendrive-ot figyelmen kívül hagyja. A tömb numerikusan indexelve tartalmazza a kiolvasott azonosítókat, ezért az ellenőrzést érdemes az in_array függvénnyel elvégezni. A függvényt főleg arra lehet használni, hogy egy adott program működését egy USB kulcs meglétéhez kössük, így akadályozva az illetéktelen használatot.

mixed getvalue(string element [, string param=””])

A függvény a form egy elemének értékét adja vissza. Ritkán használt, mert a rendszer az értékeket minden gombnyomáskor automatikusan az OperationData-ba másolja.

Egyetlen esetben van értelme használni, éspedig a list tipusnál a listában lévő elemek tömbjét adja vissza.

string getvolumeserial()

Visszaadja a rendszer meghajtó azonosító számát 8 karakteres hexadecimális alakban.

void insert(string filename)

A megadott file-t includolja. Hatása teljesen megegyezik az include PHP utasítással, de az itt nem alkalmazható.

A filename relatív címet kell tartalmazzon az alkalmazás gyökeréhez viszonyítva.

boolean mailto(string address [, string subject [, string body]])

Az alapértelmezett levelezőprogram levélküldő ablakát dobja fel. Az address lesz a cím, a subject a tárgy a body pedig a szöveg. A visszatérési érték siker esetén true.

bool mergeparams()

Ha a SubOperation függvényben átadott paraméter tömb, akkor a hatás egyenértékű az array_merge(OperationData,GetParams()) hívással és a visszatérési érték true, ellenkező esetben a visszatérési érték false és az utasításnak más hatása nincs.

void modifycacheabledatasource(int cachetime, string name, string fields [, string from [, string where [, string groupby [, string having [, string orderby]]]]])

Hatása annyiban tér el a ModifyDataSource függvényétől, hogy engedélyezi a módosított adatforrás tárolását a (másodpercben) megadott ideig.

Az előzőleg tárolt adatokat törli, ezért következő alkalommal újra letölti az adatbázisból az adatokat.

void modifydatasource(string name, string fields [, string from [, string where [, string groupby [, string having [, string orderby]]]]])

Módosítja a megadott nevű adatforrást. A további paraméterek esetén amennyiben a paraméter '_', az a paraméter változatlan marad. Amennyiben a paraméter '+' jellel kezdődik, akkor a megadott szöveget hozzáfűzi az eddigi értékhez (természetesen a '+' jel nélkül és a megfelelő SQL szintaxissal pl: ha a where paraméter '+id=2', akkor amennyiben a where paraméter eddig nem volt üres, akkor egy 'and id=2' szöveget fűz hozzá)

A megadott adatforrás akkor sem lesz tárolható, ha eddig az volt!

Amennyiben a megadott néven nem létezik még adatforrás egy AddDataSource hívást kezdeményez.

Hatása teljes mértékben megegyezik az AddDataSource függvény hívásával.

mixed opendialog(string mode, string initialdir [, string filter = “Minden fájl|*.*”])

A mode paremétertől függő dialógus ablakot jelenít meg, majd a kiválasztott fájl vagy könyvtár elérési útjával tér vissza. Amennyiben a dialógus ablakban a Mégsem gombra kattintunk, akkor a visszatérési érték false. A mode paraméter a következő értékeket vehet fel:

• open: egy fájl megnyitására szolgáló dialógus ablakot nyit
• save: egy fájl megnyitására szolgáló dialógus ablakot nyit
• dir: egy könyvtár tallózására szolgáló ablakot nyit

A filter paraméterben lehet megadni, hogy milyen szűrések lehetségesek az adott ablakban (dir módban nincs hatása). Egy szűrési lehetőség megadása egy olyan stringgel lehetséges, ahol először megadjuk a szűrő nevét, majd |-el elválasztva a szűrést (pl: Text fájl|*.txt). A szűrésnél lehet több különböző lehetőséget is megadni, ekkor a lehetőségeket pontosvesszővel választjuk el (pl: HTML fájl|*.html;*.htm). Végül a filter paraméterben a szűrési lehetőségeket soroljuk fel újfent |-el elválasztva (pl: Text fájl|*.txt|HTML fájl|*.html;*.htm|Minden fájl|*.*)

void popupoperation(string proc, mixed param [, string display=””])

A megadott proc-t hívja meg egy új ablakban. A param a SubOperation-hoz hasonlóan a hívás paramétere. Az OnSub eseménykezelő ebben az esetben is lefut. A display paraméterrel befolyásolhatjuk a megjelenő ablak méretét az ini fájlban megadható módon; ha üresen marad, akkor az ini fájl beállításai lesznek érvényesek.

bool print_array(array arr [, string printer_name = 'printer1' [, bool landscape = false ]] )

Kinyomtatja az arr paraméterben megadott egy dimenziós tömböt. A printer_name paraméterrel a nyomtatót módosíthatjuk, míg a landscape paraméterrel az álló és a fekvő lap között választhatunk.

bool print_file(string file_name [, string printer_name = 'printer1' [, bool landscape = false ]] )

Kinyomtatja a file_name paraméterben megadott (szöveges) fájl tartalmát. A printer_name paraméterrel a nyomtatót módosíthatjuk, míg a landscape paraméterrel az álló és a fekvő lap között választhatunk.

string rc6decode(string value, string code)

A code alapján generált 256 bites kód alapján visszafejti a value-ban tárolt RC6-al kódolt stringet. Az RC6Encode függvény ellentéte.

string rc6encode(string value, string code)

A code alapján generált 256 bites kód alapján RC6 kódolja a value-ban tárolt stringet. Az RC6Decode függvény ellentéte.

bool readdbsettings(string file_name)

A megadott fájlból beolvassa az adatbázis konfigurációt. Ha a fájl nem létezik, akkor feldob egy kis beállító ablakot, ahol megadhatók a szükséges paraméterek. A konfigurációs fájl kódolt, ezért kézzel nem szerkeszthető. A visszaadott érték true, ha a konfiguráció beolvasása sikeres, false különben. Célszerű az appconfig.inc.php-ben meghívni a következő módon:

  if (!readdbsettings("config.cfg")) Close();

bool refreshdatasource(string name)

A name datasource-t “frissíti”, ami annyit tesz, hogy a cache-elt tartalmat törli, így nem cache-elhető datasource-ok esetén nincs hatása.

int roman2arabic(string roman_number)

A roman_number római számot egésszé alakítja. Hiba esetén -1-et ad vissza (ami római számokkal nem írható le, tehát helyes szám esetén nem jöhet ki).

A helyesen leírt római számokon a helyes eredményt adja, de valamennyivel elfogadóbb, mint a szigorú római szabályok. Minden hibás római számot ez sem tud számmá alakítani (pl: a MIM-et nem tudja, ami 1999-ként értelmezhető lenne).

void setdata(string cell, mixed data)

A cell paraméterben megadott komponenshez rendeli a data értéket, amelyet aztán a GetData függvénnyel kérhetünk le.

void setdefaultwatermark(string caption)

A caption-ben megadott szöveg lesz a vízjel minden nyomtatáson (a listák nyomtatásán is). DEMO verziójú kliens esetén az alapérték “Demó verzió”, egyébként üres szöveg. Egyenértékű a SetSystemValue('PRINT_WATERMARK',caption) függvényhívással.

void setelementattribute(mixed cell, string attr, mixed value)

A cell paraméterben megadott komponens attr paraméterét állítja value-ra. A cell lehet tömb is, ekkor minden benne szereplő komponens megadott paraméterét beállítja.

void setelementattribute(mixed cell, array values)

Ebben a hívási formában a values egy asszociatív tömb, ahol a kulcsok adják meg a beállítandó tulajdonságot, az értékek pedig az értékét. Ebben a módban is lehet a cell tömb, ekkor itt is a benne szereplő komponensek értékeit állítja be.

void sethelp(string helpfile, string helpcontextfile)

A helpfile-ban megadott WinHelp fájl lesz az alkalmazáshoz rendelt help fájl. A második paraméterben megadható az SHM által generált txt fájl, ami a context number-ek és a lapok megnevezéseit segít összekapcsolni.

bool setsystemvalue(string param, string value)

A param-ban megadott nevű rendszer paraméter értékét value-ra állítja. Ha a megadott nevű paraméter nem létezik, a visszaadott érték false, ellenkező esetben true. A rendszer paraméterek neveit lásd a GetSystemValue függvény leírásánál.

bool startoperation()

Nyit egy új operationt. A visszaadott érték akkor true, ha a hívást megelőzően is operation-ön belül voltunk, ha csak ezzel a hívással kerültünk operation-on belülre, akkor false.

void stop()

Csak DEBUG fordítású kliensben.

Ha a WatchList aktív, akkor a program futását megállítja (a következő utasítás előtt). Ha a WatchList nem aktív, akkor hatástalan.

void suboperation(string jump, mixed param)

Először beállítja a JumpTo értékét jump-ra, és beállítja paraméternek a param értékét, amelyet aztán a GetParams vagy MergeParams függvényekkel kérhetünk le.

string toidentifier(string str [, bool normalize = false])

A megadott string-et kisbetűssé alakítja, majd lecseréli benne az összes ékezetes karaktert az ékezet nélküli párjára, ezekután az összes nem alfanumerikus karakter “_”-ra cserél. Ha a normalize paraméter igaz, akkor az eredményből még kitörli az “_”-okat.

Ha a normalize paraméter false, akkor az eredmény string ugyanolyan hosszú mint az eredeti és csak kisbetűket, számokat valamint “_” jelet tartalmaz.

Ha a normalize paraméter true, akkor az eredmény string csak kisbetűket és számokat tartalmaz, minden egyéb karakter kimarad.

Például:

$a = toidentifier("Win'98, OS/2 & Linux");
// $a értéke "win_98__os_2___linux"
$b = toidentifier("Win'98, OS/2 & Linux",true);
// $b értéke "win98os2linux"

int usedmemory(mixed var)

A paraméterként megadott kifejezés által felhasznált memória méretét adja vissza bájtban. A visszaadott érték nem tartalmazza az objektumok által elfoglalt memória méretét. Csak DEBUG kliens esetén létezik.