kgergely Thu Sep 13 03:32:24 2001 EDT Modified files: /phpdoc/hu/functions pgsql.xml Log: Adding Hungarian translation... Version is not known, but let people read Hungarian version, will be synchronized soon...
Index: phpdoc/hu/functions/pgsql.xml diff -u /dev/null phpdoc/hu/functions/pgsql.xml:1.4 --- /dev/null Thu Sep 13 03:32:23 2001 +++ phpdoc/hu/functions/pgsql.xml Thu Sep 13 03:32:23 2001 @@ -0,0 +1,1218 @@ +<?xml encoding="iso-8859-2"?> +<!-- EN-Revision: n/a Maintainer: kgergely Status: ready, but not updated... --> + <reference id="ref.pgsql"> + <title>PostgreSQL függvények</title> + <titleabbrev>PostgreSQL</titleabbrev> + + <partintro> + <para> + Postgres, amit eredetileg a UC Berkeley Computer Science + Department fejlesztett ki, úttörő volt az objektum-relációs adatmodellek +területén, és most elérhetővé válik több kereskedelmi adatbázisban is. + Támogatja az SQL92/SQL3 nyelv használatát, tranzakciók integritását és a + típusok kiterjeszthetőségét. A PostgreSQL egy public-domain, + nyílt forrású leszármazottja ennek az eredeti Berkeley kódnak. + </para> + <para> + A PostgreSQL ingyenes. A legújabb verzió a + <ulink url="&url.pgsql;">www.PostgreSQL.org</ulink> címen érhető el. + </para> + <para> + A 6.3 verzió óta (03/02/1998) a PostgreSQL unix socketeket használ. + A lenti táblázat mutatja az új kapcsolatteremtési lehetőségeket. + Ez a socket a <filename>/tmp/.s.PGSQL.5432</filename> néven érhető el. + Ezt az opciót a <command>postmaster</command> parancs '-i' + kapcsolójával érheted el, a jelentése pedig: + "figyeld a TCP/IP socketeket is úgy, mint a unix socketeket". + <table> + <title>Postmaster és a PHP</title> + <tgroup cols="3"> + <thead> + <row> + <entry>Postmaster</entry> + <entry>PHP</entry> + <entry>Állapot</entry> + </row> + </thead> + <tbody> + <row> + <entry>postmaster &</entry> + <entry>pg_connect("", "", "", "", "dbname");</entry> + <entry>OK</entry> + </row> + <row> + <entry>postmaster -i &</entry> + <entry>pg_connect("", "", "", "", "dbname");</entry> + <entry>OK</entry> + </row> + <row> + <entry>postmaster &</entry> + <entry>pg_connect("localhost", "", "", "", "dbname");</entry> + <entry> + Unable to connect to PostgreSQL server: connectDB() failed: + Is the postmaster running and accepting TCP/IP (with -i) + connection at 'localhost' on port '5432'? in + /path/to/file.php3 on line 20. + vagyis: + Nem lehet kapcsolódni a PostgreSQL szerverhez: a connectDB() hívás + meghiúsult. Fut a postmaster, és fogadja a TCP/IP kapcsolatokat (-i) + a helyi gépen az 5432-es porton? a + /elérési_út/a/file.php3 a 20-as sorban + </entry> + </row> + <row> + <entry>postmaster -i &</entry> + <entry>pg_connect("localhost", "", "", "", "dbname");</entry> + <entry>OK</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + A következőképp is kezdhetsz kapcsolatot: + <command>$conn = pg_Connect("host=localhost port=5432 + dbname=chris");</command> + </para> + <para> + Annak érdekében, hogy használhassunk nagy objektum felületet (lo), + szükséges az egészet egy tranzakciós blokkba foglalni. A tranzakciós + blokk egy <command>begin</command>-nel kezdődik, és ha a tranzakció + érvényes, egy <command>commit</command>-tal vagy egy + <command>end</command>-del végződik. Ha a tranzakció meghiúsul, akkor + <command>rollback</command> vagy <command>abort</command> paranccsal + kell végződnie. + + <example> + <title>Nagy objektumok használata</title> + <programlisting role="php"> +<?php + $database = pg_Connect ("", "", "", "", "jacarta"); + pg_exec ($database, "begin"); + $oid = pg_locreate ($database); + echo ("$oid\n"); + $handle = pg_loopen ($database, $oid, "w"); + echo ("$handle\n"); + pg_lowrite ($handle, "gaga"); + pg_loclose ($handle); + pg_exec ($database, "commit"); +?> + </programlisting> + </example> + </para> + </partintro> + + <refentry id="function.pg-close"> + <refnamediv> + <refname>pg_Close</refname> + <refpurpose>lezár egy PostgreSQL kapcsolatot</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>pg_close</function></funcdef> + <paramdef>int <parameter>connection</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Hamissal tér vissza, ha a connection érvénytelen kapcsolatazonosító, + egyébként igazzal. Lezárja az adott azonosítójú kapcsolatot a + PostgreSQL adatbázissal. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-cmdtuples"> + <refnamediv> + <refname>pg_cmdTuples</refname> + <refpurpose>az érintett sorok számát adja vissza</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pg_cmdtuples</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>pg_cmdTuples</function> az INSERT, UPDATE vagy DELETE + kérések által érintett sorokat adja vissza. Ha egyetlen sor sem + érintett, az eredmény 0 lesz. + <example> + <title>pg_cmdtuples</title> + <programlisting role="php"> +<?php +$result = pg_exec($conn, "INSERT INTO verlag VALUES ('Autor')"); +$cmdtuples = pg_cmdtuples($result); +echo $cmdtuples . " <- cmdtuples affected."; +?> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-connect"> + <refnamediv> + <refname>pg_Connect</refname> + <refpurpose>megnyit egy kapcsolatot</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pg_connect</function></funcdef> + <paramdef>string <parameter>host</parameter></paramdef> + <paramdef>string <parameter>port</parameter></paramdef> + <paramdef>string <parameter>options</parameter></paramdef> + <paramdef>string <parameter>tty</parameter></paramdef> + <paramdef>string <parameter>dbname</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Sikeres végrehajtás esetén egy kapcsolat-azonosítóval tér vissza, + vagy hamissal, ha a kapcsolat nem hozható létre. Kapcsolatot nyit + egy PostgreSQL adatbázishoz. Az összes argumentum változó-interpolált, + beleértve a porszámot is. Az options és a tty argumentumok opcionálisak, + vagyis elhagyhatók. Ez a függvény egy kapcsolat-azonosítóval tér vissza, + mely más PostgreSQL függvények használatához szükséges. Egyszerre + több kapcsolatot is tudsz nyitni. + </para> + <para> + Kapcsolat létrehozására alkalmas az alábbi parancs is: + <command>$conn = pg_connect("dbname=marliese port=5432");</command> + A <parameter>dbname</parameter> és a + <parameter>port</parameter> paraméter mellett még használható a + <parameter>host</parameter>, + <parameter>tty</parameter>, + <parameter>options</parameter>, + <parameter>user</parameter> és a + <parameter>password</parameter>. + </para> + <para> + Lásd még a <function>pg_pConnect</function> függvényt. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-dbname"> + <refnamediv> + <refname>pg_DBname</refname> + <refpurpose>adatbázis neve</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>pg_dbname</function></funcdef> + <paramdef>int <parameter>connection</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az adott kapcsolatazonosítójú PostgreSQL adatbázisnevével tér vissza, vagy +hamissal, ha a kapcsolat-azonosító érvénytelen. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-errormessage"> + <refnamediv> + <refname>pg_ErrorMessage</refname> + <refpurpose>hibaüzenet</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>pg_errormessage</function></funcdef> + <paramdef>int <parameter>connection</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Egy hibaüzenetet tartalmazó stringgel tér vissza, vagy hamissal, ha gáz van. + Returns a string containing the error message, false on failure. + A hibáról részletes leírást valószínűleg nem sikerül kapnod ezzel a + <function>pg_errormessage</function> függvénnyel, ha egy hiba történt a +legutolsó adatbázisművelet során, amely számára létezik egy érvényes kapcsolat, ez a +függvény a backend server által generált üzenetet írja ki. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-exec"> + <refnamediv> + <refname>pg_Exec</refname> + <refpurpose>végrehajt egy kérést</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pg_exec</function></funcdef> + <paramdef>int <parameter>connection</parameter></paramdef> + <paramdef>string <parameter>query</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Egy eredményindexszel tér vissza, ha a kérés teljesíthető, vagy hamissal, ha a + kapcsolat-azonosító érvénytelen, vagy nem teljesíthető a kérés. + A hibára vonatkozó részleteket a + <function>pg_ErrorMessage</function> függvény segítségével + nyerhetünk, ha a kapcsolat létezik. + Egy SQL kérést küld a kapcsolat-azonosítóban meghatározott + PostgreSQL adatbázisnak. A kapcsolat-azonosítónak egy valós + <function>pg_Connect</function> által visszaadott azonosítónak + kell lennie. E függvény visszatérési értéke indexül szolgál más + PostgreSQL függvények segítségével történő információeléréshez. + <note> + <simpara> + A PHP/FI 1-gyel tért vissza, ha a kérés nem szolgáltatott adatot. + (pl.: insert vagy update) és 1-nél nagyobb számot olyan selecteknél + is, ami üres halmazzal tért vissza. + No such assumption can be made in PHP. [Nincs ilyen feltételezés a PHP-ben???] + </simpara> + </note> + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-fetch-array"> + <refnamediv> + <refname>pg_Fetch_Array</refname> + <refpurpose>beolvas egy sort egy tömbbe</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>pg_fetch_array</function></funcdef> + <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>int <parameter>row</parameter></paramdef> + <paramdef>int + <parameter><optional>result_type</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az adatbázis következő sorával tér vissza tömb formában, vagy hamissal, + ha már nincs több sor. + </para> + <para> + A <function>pg_fetch_array</function> függvény a + <function>pg_fetch_row</function> kiterjesztett változata. + Amellett, hogy a tömb numerikusan indexelhető, az adatokat asszociatív + indexszel is tárolja a mezőneveket használva kulcsnak. + </para> + <para> + A harmadik, <parameter>result_type</parameter> nevű argumentum a következő + értékeket veheti fel: PGSQL_ASSOC, PGSQL_NUM, and PGSQL_BOTH. + <note> + <para> + A <parameter>result_type</parameter> paraméter a PHP 4.0-ás + változatában került a nyelvbe. + </para> + </note> + </para> + <para> + Jó tudni, hogy a + <function>pg_fetch_array</function> használata NEM jelentősen lassabb, + mint a <function>pg_fetch_row</function> használata, míg az eredmény érthetőbb. + </para> + <para> + További részletekért lásd még a + <function>pg_fetch_row</function> + függvényt. + </para> + <example> + <title>A pg_fetch_array használata</title> + <programlisting role="php"> +<?php +$conn = pg_pconnect("","","","","publisher"); +if (!$conn) { + echo "Hiba történt.\n"; + exit; +} + +$result = pg_Exec ($conn, "SELECT * FROM authors"); +if (!$result) { + echo "Hiba történt.\n"; + exit; +} + +$arr = pg_fetch_array ($result, 0); +echo $arr[0] . " <- array\n"; #hiba < kell!!! + +$arr = pg_fetch_array ($result, 1); +echo $arr["author"] . " <- array\n"; # itt is +?> + </programlisting> + </example> + </refsect1> + </refentry> + + <refentry id="function.pg-fetch-object"> + <refnamediv> + <refname>pg_Fetch_Object</refname> + <refpurpose>sor beolvasása objektumként</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>object <function>pg_fetch_object</function></funcdef> + <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>int <parameter>row</parameter></paramdef> + <paramdef>int + <parameter><optional>result_type</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Egy objektummal tér vissza, aminek a tulajdonságai megegyeznek a beolvasott + sor mezőivel, hamissal, ha nincs több sor. + </para> + <para> + <function>pg_fetch_object</function> hasonló a + <function>pg_fetch_array</function>-hoz, egy különbséget kivéve - + objektummal tér vissza, nem tömbbel. Vagyis adatot csak mezőnevekkel érhetsz + el, indexszel (számokkal) nem (a számok ugyanis illegális mezőnevek). + </para> + <para> + A harmadik, <parameter>result_type</parameter> nevű argumentum a következő + értékeket veheti fel: PGSQL_ASSOC, PGSQL_NUM, and PGSQL_BOTH. + <note> + <para> + A <parameter>result_type</parameter> paraméter a PHP 4.0-ás + változatában került a nyelvbe. + </para> + </note> + </para> + <para> + Sebesség szempontjából, a függvény azonos a + <function>pg_fetch_array</function> függvénnyel, és majdnem olyan gyors, mint a + <function>pg_fetch_row</function> (a különbség jelentéktelen). + </para> + <para> + Lásd még a <function>pg_fetch_array</function> és a + <function>pg_fetch_row</function> függvényeket. + <example> + <title>pg_fetch_object alkalmazása</title> + <programlisting role="php"> +<?php +$database = "verlag"; +$db_conn = pg_connect ("localhost", "5432", "", "", $database); +if (!$db_conn): ?> + <H1>Nem lehet kapcsolódni a <? echo $database ?> nevű adatbázishoz.</H1> +<? + exit; +endif; + +$qu = pg_exec ($db_conn, "SELECT * FROM verlag ORDER BY autor"); +$row = 0; // A postgresnek kell egy sorszámláló, ami más adatbáziskezelőnél talán nem + +while ($data = pg_fetch_object ($qu, $row)): + echo $data->autor." ("; + echo $data->jahr ."): "; + echo $data->titel."<BR>"; + $row++; +endwhile; ?> + +<PRE><?php +$fields[] = Array ("autor", "Author"); +$fields[] = Array ("jahr", " Year"); +$fields[] = Array ("titel", " Title"); + +$row= 0; // A postgresnek kell egy sorszámláló, ami más adatbáziskezelőnél talán nem +while ($data = pg_fetch_object ($qu, $row)): + echo "----------\n"; + reset ($fields); + while (list (,$item) = each ($fields)): + echo $item[1].": ".$data->$item[0]."\n"; + endwhile; + $row++; +endwhile; +echo "----------\n"; ?> +</PRE> <?php +pg_freeResult ($qu); +pg_close ($db_conn); +?> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-fetch-row"> + <refnamediv> + <refname>pg_Fetch_Row</refname> + <refpurpose>következő sor beolvasása numerikusan indexelt tömbbe</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>array <function>pg_fetch_row</function></funcdef> + <paramdef>int <parameter>result</parameter></paramdef> + <paramdef>int <parameter>row</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A beolvasott sorral tér vissza numerikusan indexelt (hagyományos) + tömb formájában, vagy hamissal, ha nincs több sor. + </para> + <para> + A <function>pg_fetch_row</function> függvény betölti a megadott + eredmény-azonosítónak megfelelő sort. Az eredményt eredmény formában + adja vissza. Az egyes oszlopokat indexszel (számmal) lehet elérni. + Az első oszlop indexe 0. + </para> + <para> + A <function>pg_fetch_row</function> egymás utáni alkalmazásával az + eredményhalmaz következő sorát kapjuk, amíg van következő sor, majd + hamist, ha már nincs több sor. + </para> + <para> + Lásd még a <function>pg_fetch_array</function>, + <function>pg_fetch_object</function> és a + <function>pg_result</function> függvényeket. + <example> + <title>pg_fetch_row alkalmazás</title> + <programlisting role="php"> +<?php +$conn = pg_pconnect("","","","","publisher"); +if (!$conn) { + echo "Gáz van.\n"; + exit; +} + +$result = pg_Exec ($conn, "SELECT * FROM authors"); +if (!$result) { + echo "Baj van, nagy baj van.\n"; + exit; +} + +$row = pg_fetch_row ($result, 0); +echo $row[0] . " <- row\n"; # < helyett valami más kell + +$row = pg_fetch_row ($result, 1); +echo $row[0] . " <- row\n"; # itt is + +$row = pg_fetch_row ($result, 2); +echo $row[1] . " <- row\n"; # detto +?> + </programlisting> + </example> + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-fieldisnull"> + <refnamediv> + <refname>pg_FieldIsNull</refname> + <refpurpose>Megvizsgálja, hogy egy mező NULL-e</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pg_fieldisnull</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>int <parameter>row</parameter></paramdef> + <paramdef>mixed <parameter>field</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Megviszgálja, hogy egy adott sorban az adott mező NULL-e, vagy sem. + 0-t ad vissza, ha a mező nem NULL, 1-et, ha NULL. A mező számmal, + vagy mezőnévvel adható meg. A sorok számozása 0-val kezdődik. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-fieldname"> + <refnamediv> + <refname>pg_FieldName</refname> + <refpurpose>Egy mező nevét mondja meg</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>pg_fieldname</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>int <parameter>field_number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>pg_FieldName</function> függvény az adott eredményazonosító + és oszlopszám alapján megmondja az oszlop nevét. Az oszlopszámozás + 0-val kezdődik. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-fieldnum"> + <refnamediv> + <refname>pg_FieldNum</refname> + <refpurpose>Adott mező oszlopszámát mondja meg</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pg_fieldnum</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>string <parameter>field_name</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>pg_FieldNum</function> függvény adott eredmény-azonosítójú + eredmény adott nevű oszlopának a sorszámát adja vissza. A sorszámozás + 0-tól indul. Hiba esetén -1-gyel tér vissza. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-fieldprtlen"> + <refnamediv> + <refname>pg_FieldPrtLen</refname> + <refpurpose>Nyomtatott hosszal tér vissza</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pg_fieldprtlen</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>int <parameter>row_number</parameter></paramdef> + <paramdef>string <parameter>field_name</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>pg_FieldPrtLen</function> függvény egy eredmény adott + sorának, adott mezejének nyomtatott hosszát (hány darab karakter) + adja vissza. A sorok számozása 0-val kezdődik. A függvény -1-gyel + tér vissza hiba esetén. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-fieldsize"> + <refnamediv> + <refname>pg_FieldSize</refname> + <refpurpose> + Adott mező belső tárolási méretét adja + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pg_fieldsize</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>int <parameter>field_number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>pg_FieldSize</function> az adott eredmény adott mezejének + belső tárolási méretét (byteban) adja vissza. A mezők számozása 0-val + kezdődik. A -1 hosszú mező változó hosszúságú mezőt jelent. A függvény + hiba esetén hamisat ad vissza. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-fieldtype"> + <refnamediv> + <refname>pg_FieldType</refname> + <refpurpose> + Az adott mezú típusát adja vissza + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pg_fieldtype</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>int <parameter>field_number</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>pg_FieldType</function> függvény az adott azonosítójú + eredményhalmaz adott mezejének típusát leíró stringgel tér vissza. + A mezők számozása 0-tól indul. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-freeresult"> + <refnamediv> + <refname>pg_FreeResult</refname> + <refpurpose>Adatbázishoz kapcsolódó memória felszabadítása</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pg_freeresult</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>pg_FreeResult</function> függvényt csak akkor kell + meghívnod, ha félsz attól, hogy túl sok memóriát használ a + scripted, míg fut. Az összes felhasznált memória automatikusan + felszabadul, amikor a script futása véget ér. Azonban, ha + biztos vagy benne, hogy az eredény már nem fog kelleni, + meghívhatod a + <function>pg_FreeResult</function> függvényt az eredmény-azonosítóval, + és az eredményhalmazhoz tartalmazó memória felszabadul. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-getlastoid"> + <refnamediv> + <refname>pg_GetLastOid</refname> + <refpurpose>Az utolsó objektumazonosítót adja</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pg_getlastoid</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>pg_GetLastOid</function> függvény egy + <function>pg_Exec</function>-kel végrehajtott SQL INSERT-hez + rendelt Oid (Object identifier - objektum azonosító) visszanyerésére + használható. Ez a függvény pozitív egésszel tér vissza, ha egy valós + Oid-ről van szó. Ha hiba történt, vagy az utolsó művelet, amit a + <function>pg_Exec</function>-kel végeztek nem INSERT, a függvény -1-gyel + tér vissza. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-host"> + <refnamediv> + <refname>pg_Host</refname> + <refpurpose>A hostnevet adja vissza</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>pg_host</function></funcdef> + <paramdef>int <parameter>connection_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>pg_Host</function> függvény az adott kapcsolat-azonosítójú + PostgreSQL host nevét adja vissza. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-loclose"> + <refnamediv> + <refname>pg_loclose</refname> + <refpurpose>Bezár egy nagy objektumot</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>pg_loclose</function></funcdef> + <paramdef>int <parameter>fd</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>pg_loclose</function> bezár egy Inversion Large + Object-et. Az <parameter>fd</parameter> paraméter a + <function>pg_loopen</function>-ből származó nagy objektum leírója. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-locreate"> + <refnamediv> + <refname>pg_locreate</refname> + <refpurpose>létrehoz egy nagy objektumot</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pg_locreate</function></funcdef> + <paramdef>int <parameter>conn</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>pg_locreate</function> létrehoz egy + Inversion Large Object-et és a nagy objektum oid-jével tér vissza. + A <parameter>conn</parameter> paraméter határozza meg a kapcsolat + azonosítóját. A PostgreSQL hozzáférési módok: INV_READ, INV_WRITE, és + INV_ARCHIVE nem támokatottak, az objektum mindig írási és olvasási + joggal kerülnek létrehozásra. Az INV_ARCHIVE pedig el lett távolítva + a nyelvből (a 6.3-as verziótól). + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-loexport"> + <refnamediv> + <refname>pg_loexport</refname> + <refpurpose>Nagy objektumot file-ba exportál</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>pg_loexport</function></funcdef> + <paramdef>int + <parameter>oid</parameter> + </paramdef> + <paramdef>int + <parameter>file</parameter> + </paramdef> + <paramdef>int + <parameter><optional>connection_id</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Az <parameter>oid</parameter> argumentum határozza meg az exportálandó + objektum azonosítóját, és a <parameter>filename</parameter> argumentum + határozza meg a file útvonalát és nevét. FALSE-szal tér vissza hiba esetén, + egyébként TRUE-val. Ne feledd, hogy a PostgreSQL-ben nagy objektumokat + csak tranzakciókon belül lehet kezelni. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-loimport"> + <refnamediv> + <refname>pg_loimport</refname> + <refpurpose>nagy objektumot importál fileból</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pg_loimport</function></funcdef> + <paramdef>int + <parameter>file</parameter> + </paramdef> + <paramdef>int + <parameter><optional>connection_id</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <parameter>filename</parameter> paraméter határozal meg az importálandó + file útvonalát és nevét. FALSE-szal tér vissza, ha hiba történt, + az éppen most létrehozott objektum azonosítójával, ha a művelet sikerült. + Ne feledd, hogy a PostgreSQL-ben nagy objektumokat + csak tranzakciókon belül lehet kezelni. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-loopen"> + <refnamediv> + <refname>pg_loopen</refname> + <refpurpose>megnyit egy nagy objektumot</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pg_loopen</function></funcdef> + <paramdef>int <parameter>conn</parameter></paramdef> + <paramdef>int <parameter>objoid</parameter></paramdef> + <paramdef>string <parameter>mode</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>pg_loopen</function> megnyit egy Inversion Large Object-et + és a nagy objektum file leírójával tér vissza. A file leíróban információ + van a kapcsolatról. Ne zárd le a kapcsolatot, míg le nem zárod a nagy objektum + file leíróját. + Az <parameter>objoid</parameter> paraméter egy valós nagy objektum oid-jét + határozza meg, és a <parameter>mode</parameter> paraméter lehet + "r", "w", vagy "rw". + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-loread"> + <refnamediv> + <refname>pg_loread</refname> + <refpurpose>nagy objektumot olvas be</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>pg_loread</function></funcdef> + <paramdef>int <parameter>fd</parameter></paramdef> + <paramdef>int <parameter>len</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>pg_loread</function> beolvas legfeljebb + <parameter>len</parameter> byte-ot olvas be a nagy objektumból, + és stringként adja vissza. + Az <parameter>fd</parameter> paraméter a file leírót határozza meg + és a <parameter>len</parameter> ##parameter előtt hiányzik egy space + paraméter határozza meg a maximális + megengedett nagy objektum szegmens méretét. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-loreadall"> + <refnamediv> + <refname>pg_loreadall</refname> + <refpurpose>egy egész nagy objektumot olvas be</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>pg_loreadall</function></funcdef> + <paramdef>int <parameter>fd</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>pg_loreadall</function> fügvény egy nagy objektumot olvas + be, és közvetlenül kiírja a böngészőbe, miután minden szükséges + fejlécet kiírt. Főleg bináris jellegű adat kiírására szánták. (pl.: képek, hang) + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-lounlink"> + <refnamediv> + <refname>pg_lounlink</refname> + <refpurpose>töröl egy nagy objektumot</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>pg_lounlink</function></funcdef> + <paramdef>int <parameter>conn</parameter></paramdef> + <paramdef>int <parameter>lobjid</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>pg_lounlink</function> függvény törli a + <parameter>lobjid</parameter>-vel azonosított nagy objektumot. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-lowrite"> + <refnamediv> + <refname>pg_lowrite</refname> + <refpurpose>nagy objektumot ír</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pg_lowrite</function></funcdef> + <paramdef>int <parameter>fd</parameter></paramdef> + <paramdef>string <parameter>buf</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>pg_lowrite</function> függvény kiír egy nagy objektumba + egy változóból maximum <parameter>buf</parameter> bytetot, és a + ténylegesen kiírt byteok számával tér vissza, vagy false-szal, ha hiba történt. + Az <parameter>fd</parameter> paraméter a nagy objektum + <function>pg_loopen</function> hívásából származó file azonosító. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-numfields"> + <refnamediv> + <refname>pg_NumFields</refname> + <refpurpose>Mezők száma</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pg_numfields</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>pg_NumFields</function> függvény a PostgreSQL eredményben + levő mezők (oszlopok) számát adja vissza. Az argumentumnak valós, + <function>pg_Exec</function>-ből származó eredmény-azonosítónak kell + lennie. A függvény hiba esetén -1-gyel tér vissza. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-numrows"> + <refnamediv> + <refname>pg_NumRows</refname> + <refpurpose>Sorok száma</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pg_numrows</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>pg_NumRows</function> függvény a PostgreSQL eredményhalmaz + sorainak számát adja vissza. Az argumentumnak valós, + <function>pg_Exec</function>-ből származó eredmény-azonosítónak kell + lennie. A függvény hiba esetén -1-gyel tér vissza. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-options"> + <refnamediv> + <refname>pg_Options</refname> + <refpurpose>Returns options</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>pg_options</function></funcdef> + <paramdef>int <parameter>connection_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>pg_Options</function> függvény egy stringgel tér vissza, + amiben az adott PostgreSQL azonosító kapcsolat opcióit tartalmazza. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-pconnect"> + <refnamediv> + <refname>pg_pConnect</refname> + <refpurpose> + Tartós adatbázis-kapcsolatot hoz létre + </refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pg_pconnect</function></funcdef> + <paramdef>string <parameter>host</parameter></paramdef> + <paramdef>string <parameter>port</parameter></paramdef> + <paramdef>string <parameter>options</parameter></paramdef> + <paramdef>string <parameter>tty</parameter></paramdef> + <paramdef>string <parameter>dbname</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + Siker esetén egy kapcsolat-indexszel tér vissza, vagy hamissal, + ha a kapcsolat nem hozható létre. Tartós kapcsolatot nyit a + PostgreSQL adatbázishoz. Minden paraméternek idézőjelezettnek + kell lennie, beleértve a portszámot. Az options és a tty paraméterek + elhagyhatók. A függvény egy olyan kapcsolat-azonosítóval tér vissza, + amely szükséges más PostgreSQL függvények végrehajtásához. + Egyszerre több tartós kapcsolatod is lehet nyitva egyszerre. [Hát igen, + ez a Postgres még a valós életet is túlszárnyalja...] + Lásd még a <function>pg_Connect</function> függvényt. + </para> + <para> + Kapcsolat a következő módon is létrehozható: + <command>$conn = pg_pconnect("dbname=marliese port=5432");</command> + Egyéb paraméterek <parameter>dbname</parameter> és + <parameter>port</parameter> are[???] <parameter>host</parameter>, + <parameter>tty</parameter>, <parameter>options</parameter>, + <parameter>user</parameter> és <parameter>password</parameter>. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-port"> + <refnamediv> + <refname>pg_Port</refname> + <refpurpose>Melyik porton van a kapcsolat</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>pg_port</function></funcdef> + <paramdef>int <parameter>connection_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>pg_Port</function> függvény az adott PostgreSQL kapcsolat-azonosítójú + összeköttetés portszámát adja meg. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-result"> + <refnamediv> + <refname>pg_Result</refname> + <refpurpose>Egy eredényazonosító alapján ad vissza értékeket</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>pg_result</function></funcdef> + <paramdef>int <parameter>result_id</parameter></paramdef> + <paramdef>int <parameter>row_number</parameter></paramdef> + <paramdef>mixed <parameter>fieldname</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>pg_Result</function> függvény a <function>pg_Exec</function>-ból + származó értékeket szolgáltat. + A <parameter>row_number</parameter> és a + <parameter>fieldname</parameter> paraméterek határozzák meg, hogy az + eredmény mely oszlopát adja vissza a függvény. A sorok számozása 0-val + kezdődik. A mezők megnevezése helyett a mezők sorszámát is használhatjuk. + Ekkor számként kell megadni az oszlopszámot (nem idézőjelben). A mezők számozása + is 0-val kezdődik. + </para> + <para> + A PostgreSQL-nek nagyon sok beépített típusa van, és csak a legalapvetőbbekre + van támogatás. Az integerek, booleanok, és oid-ek minden fajtája egészként + adódik vissza. A floatok, realek pedig double-ként jelennek meg. + Minden egyéb típus, beleértve a tömböket is, formázott stringként adódnak vissza. + A stringek ugyanolyan formában adja vissza, mint azt a <command>psql</command> + program [az alapértelmezett PostgreSQL program]. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-trace"> + <refnamediv> + <refname>pg_trace</refname> + <refpurpose>PostgreSQL szerver kapcsolatot követ nyomon</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>pg_trace</function></funcdef> + <paramdef>string + <parameter>filename</parameter> + </paramdef> + <paramdef>string + <parameter><optional>mode</optional></parameter> + </paramdef> + <paramdef>int + <parameter><optional>connection</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Engedélyezi a PostgreSQL felület kommunikációinak nyomkövetését egy + fileba. Ahhoz, hogy megértsd az eredményeket, meg kell barátkoznod + a PostgreSQL kommunikációs protokolljával. + Ha nem ismeret a protokollt, hasznos lehet akkor is nyomon követni + a szerverhez küldött kérések hibáit; például + 'grep '^To backend' trace.log' paranccsal megnézni, hogy milyen kéréseket + küldtek a PostgreSQL szervernek. + </para> + <para> + A <parameter>filename</parameter> és a <parameter>mode</parameter> paraméterek + azonosak a <function>fopen</function> függvényéhez + (a <parameter>mode</parameter> alapértelmezése 'w'), + <parameter>connection</parameter> határozza meg a nyomon követendő + kapcsolatot; az utoljára megnyitot kapcsolat az alapértelmezett. + </para> + <para> + TRUE-val tér vissza, ha a <parameter>filename</parameter> paraméterben + megadott filet meg lehet nyitni loggolásra, egyébként FALSE-szal tér vissza. + </para> + <para> + Lásd még a <function>fopen</function> és a <function>pg_untrace</function> + függvényeket. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-tty"> + <refnamediv> + <refname>pg_tty</refname> + <refpurpose>A tty nevét adja vissza</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>pg_tty</function></funcdef> + <paramdef>int <parameter>connection_id</parameter></paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>pg_tty</function> függvény a tty nevét adja vissza, amelyre + az adott azonosítójú kapcsolat + szerver oldali nyomkövetésének kimenete kerül. + </para> + </refsect1> + </refentry> + + <refentry id="function.pg-untrace"> + <refnamediv> + <refname>pg_untrace</refname> + <refpurpose>Abbahagyja az adott kapcsolat nyomkövetését</refpurpose> + </refnamediv> + <refsect1> + <title>Leírás</title> + <funcsynopsis> + <funcprototype> + <funcdef>bool <function>pg_untrace</function></funcdef> + <paramdef>int + <parameter><optional>connection</optional></parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + A <function>pg_trace</function> által elindított nyomkövetést szünteti meg. + A <parameter>connection</parameter> paraméter határozza meg, hogy mely + kapcsolat nyomkövetését kell abbahagyni. Az alapértelmezés az utoljára + megnyitott kapcsolat. + </para> + <para> + Mindig TRUE-val tér vissza. + </para> + <para> + Lásd még a <function>pg_trace</function> függvényt. + </para> + </refsect1> + </refentry> + + </reference> + +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +sgml-parent-document:nil +sgml-default-dtd-file:"../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +-->