GTA Közösség - A magyar GTA fórum

San Andreas Multiplayer (SA-MP) => SA-MP: Szerverfejlesztés => A témát indította: TengeriMalac - 2012. július 11. - 00:07:05

Cím: db_master - sampdb kezelõ függvénykönyvtár
Írta: TengeriMalac - 2012. július 11. - 00:07:05
DB_MASTER függvénykönyvtár
LEÍRÁS
Ez egy szimpla függvénykönyvtár, ami a sampdb függvénykönyvtár mûködését egyszerûsíti le.
Mivel nem sokat értek az SQL nyelvhez, funkciókhoz, ezáltal a sampdbhez sem, elég nehezen ment a megírása. Hála ennek, valamit már konyítok hozzá :)
Fõleg kezdõknek hasznos, akik annyira nem értik ezeket, mint én.
FÜGGVÉNYEK
Fõ Függvények
iDB_Open(adatbázis_név[]);



Megnyit egy adatbázist, ha ez nem létezik, akkor csinál egyet, ezzel a névvel
Ha egy adatbázis már meg van nyitva, akkor hibaüzenetet ír ki.
 


  • adatbázisnév - A megnyitni kívánt adatbázis neve

 
iDB_Cpen(\"database.db\");

 

iDB_Close();



Bezárja a megnyitott adatbázist.
Ha nincs megnyitva adatbázis, akkor hibaüzenetet ír ki.
 

  • Nincs megadott paraméter

 
iDB_Close();

 

iDB_Create(táblanév[]);


Létrehoz a megnyitott adatbázisban egy táblát.
 

  • táblanév - a létrehozni kívánt tábla neve

 
iDB_Create(\"users\");

 

iDB_Verify(táblanév[], oszlopnév[], oszloptipus);


Létrehoz egy új oszlopot a megnyitott adatbázis megadott táblájában.
 

  • táblanév - a kiválasztott tábla, amiben létre akarod hozni a megadott oszlopot


  • oszlopnév - a létrehozni kívánt oszlop neve


  • oszloptipus - a létrehozni kívánt oszlop típusa


Az oszloptipus lehet
 
  • iDB_TYPE_STRING - karakterlánc

  • iDB_TYPE_FLOAT - lebegõpontos változó

  • iDB_TYPE_INTEGER - egész szám változó


 
iDB_Verify(\"users\", \"name\", iDB_TYPE_STRING);

 

iDB_RegRow(táblanév[], bevitt_adat[])



Létrehoz egy új sort az adatbázis megadott táblájában.
A bevitt adat lesz a \'name\' oszlop értéke
 


  • táblanév - a kiválasztott tábla, amiben létre akarod hozni a megadott sort


  • bevitt_adat - a \'name\' oszlop adatának értéke


 
iDB_RegRow(\"users\", \"matyi_vok\");

 

iDB_SetInt(táblanév[], sornév[], adatnév[], szám);


beilleszt a megadott tábla oszlopába, az adatnévhez egy számot
 

  • táblanév - a kiválasztott tábla, neve, amibe az adatot szeretnéd írni


  • sornév - a keresett sor neve (name oszlop értéke)


  • adatnév - a módosítani kívánt adat neve


  • szám - a módosítani kívánt adat értéke


 
iDB_SetInt(\"users\", \"matyi_vok\", \"kills\", 12);

 

iDB_SetFloat(táblanév[], sornév[], adatnév[], Float:szám);


beilleszt a megadott tábla oszlopába, az adatnévhez egy lebegõpontos számot
 

  • táblanév - a kiválasztott tábla, neve, amibe az adatot szeretnéd írni


  • sornév - a keresett sor neve (name oszlop értéke)


  • adatnév - a módosítani kívánt adat neve


  • szám - a módosítani kívánt adat értéke


 
iDB_SetFloat(\"users\", \"matyi_vok\", \"magasság\", 1111.12);

 

iDB_SetString(táblanév[], sornév[], adatnév[], karakterlánc[]);


beilleszt a megadott tábla oszlopába, az adatnévhez egy karakterláncot
 

  • táblanév - a kiválasztott tábla, neve, amibe az adatot szeretnéd írni


  • sornév - a keresett sor neve (name oszlop értéke)


  • adatnév - a módosítani kívánt adat neve


  • karakterlánc - a módosítani kívánt adat értéke


 
iDB_SetString(\"users\", \"matyi_vok\", \"jelszó\", \"találd_ki\");

 

iDB_GetInt(táblanév[], sornév[], adatnév[]);


Lekérdezi a megadott tábla oszlopához, az adatnév sorban található szám adatot, és visszatérési értékként tárolja
 

  • táblanév - a kiválasztott tábla, neve, amiben az adatot szeretnéd keresni


  • sornév - a keresett sor neve (name oszlop értéke)


  • adatnév - a keresett adat neve


 
new kills = iDB_GetInt(\"users\", \"matyi_vok\", \"kills\");

 

Float:iDB_GetFloat(táblanév[], sornév[], adatnév[]);


Lekérdezi a megadott tábla oszlopához, az adatnév sorban található lebegõpontos szám adatot, és visszatérési értékként tárolja
 

  • táblanév - a kiválasztott tábla, neve, amiben az adatot szeretnéd keresni


  • sornév - a keresett sor neve (name oszlop értéke)


  • adatnév - a keresett adat neve


 
new Float:playerZ = iDB_GetFloat(\"users\", \"matyi_vok\", \"magasság\");

 

iDB_GetString(táblanév[], sornév[], adatnév[], kimenõ érték[], kimenõ érték hossza = (kimenõérték alap hossza));


Lekérdezi a megadott tábla oszlopához, az adatnév sorban található karakterlánc adatot
 

  • táblanév - a kiválasztott tábla, neve, amiben az adatot szeretnéd keresni


  • sornév - a keresett sor neve (name oszlop értéke)


  • adatnév - a keresett adat neve


  • kimenõ érték - mibe töltse be a kimenõ adatot


  • kimenõ érték hossza - a kimenõ adat maximális hossza


 
new string[32];
iDB_GetString(\"users\", \"matyi_vok\", \"jelszó\", string, sizeof(string)

 

iDB_DelRow(táblanév[], adatnév[]);


Törölni a táblából az oszlopnévhez megadott adatnevet
 

  • táblanév - a tábla neve, ahonnan törölni akarod a sort


  • adatnév - a törölni kívánt adat sorának neve (name oszlop értéke)


 
iDB_DelRow(\"users\", \"matyi_vok\");

 

bool:iDB_RowExist(táblanév[], adatid);


Ellenõrzi, hogy a megadott táblában létezik-e a megadott oszlop azonosító
 

  • táblanév - a tábla neve, ahol ellenõrizni akarod az adatot


  • adatid - az adat azonosítója, sorszáma (iDB_getnameid függvénnyel található meg)


 
if(iDB_RowExist(\"users\", iDB_getnameid(\"users\", \"matyi_vok\"))) print(\"matyi_vok létezik\");

 
Mellék Függvények (nem használatos)
iDB_getnameid(táblanév[], adatnév[])


Lekéri a megadott táblában a megadott adat nevének sorszámát
 

  • táblanév - az ellenõrizni kívánt tábla neve


  • adatnév - a keresett adat neve (name oszlop értéke)


 
new id = iDB_getnameid(\"users\", \"matyi_vok\");

 

iDB_check



Ellenõrzi, hogy meg van-e nyitva adatbázis.
Ha igen, akkor a visszatérési értéke true (igaz), ha nem, akkor false (hamis)
Igazából ez azért mellékfüggvény, mert használni nem nagyon lehet semmire, mert a függvénykönyvtár minden függvénye tartalmazza
 

  • Nincs használt paraméter

 
if(iDB_check) return print(\"Nyitva van egy adatbázis\");

 
ÚJÍTÁSOK
Várhatóan megpróbálok készíteni 2 függvényt, amik egyszerre több adat módosítását, illetve lekérdezését teszik lehetõvé
MEGJEGYZÉS
Mivel elsõ függvénykönyvtáram, lehetnek benne hibák.
HA HIBÁT TALÁLTOK, ÍRJÁTOK LE IDE. Köszönöm :)
LETÖLTÉS
Pastebin
[dload][/dload]
Cím: db_master - sampdb kezelõ függvénykönyvtár
Írta: smart - 2012. július 11. - 11:13:05
Szép leírás. :)
E: az ilyen lekérdezésekre nekem errort ir a pawno:
 
if(iDB_RowExist(\"users\", \"matyi_vok\")) print(\"matyi_vok létezik\");
error 035: argument type mismatch (argument 2)
Cím: db_master - sampdb kezelõ függvénykönyvtár
Írta: TengeriMalac - 2012. július 11. - 20:09:34
Kösz az észrevételt.
Szerkesztettem a fõposztot.
Cím: db_master - sampdb kezelõ függvénykönyvtár
Írta: Gentleman - 2012. november 18. - 07:21:00
[gmod]Hozzáadva a Sampforum függvénykönyvtárhoz.[/gmod]