gerzson Sun Feb 17 10:05:22 2002 EDT
Modified files:
/phpdoc/hu/functions dbx.xml
Log:
sync with EN revision
Index: phpdoc/hu/functions/dbx.xml
diff -u phpdoc/hu/functions/dbx.xml:1.2 phpdoc/hu/functions/dbx.xml:1.3
--- phpdoc/hu/functions/dbx.xml:1.2 Fri Feb 15 05:48:01 2002
+++ phpdoc/hu/functions/dbx.xml Sun Feb 17 10:05:22 2002
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.24 Maintainer: gerzson Status: ready / new layout -->
+<!-- EN-Revision: 1.26 Maintainer: gerzson Status: ready -->
<reference id="ref.dbx">
<title>dbx f�ggv�nyek</title>
<titleabbrev>dbx</titleabbrev>
@@ -38,7 +38,7 @@
<title>Le�r�s</title>
<methodsynopsis>
<type>bool</type><methodname>dbx_close</methodname>
-
<methodparam><type>dbx_link_object</type><parameter>link_identifier</parameter></methodparam>
+
+<methodparam><type>object</type><parameter>link_identifier</parameter></methodparam>
</methodsynopsis>
<para>
Sikeres v�grehajt�s eset�n &true;-val t�r vissza, egy�bk�nt hiba
@@ -49,7 +49,7 @@
<programlisting role="php">
<![CDATA[
<?php
-$link = dbx_connect ("mysql", "localhost", "db", "username", "password")
+$link = dbx_connect (DBX_MYSQL, "localhost", "db", "username", "password")
or die ("Nem siker�lt kapcsol�dni.");
print("Sikeresen kapcsol�dtam.");
@@ -77,8 +77,8 @@
<refsect1>
<title>Le�r�s</title>
<methodsynopsis>
- <type>dbx_link_object</type><methodname>dbx_connect</methodname>
- <methodparam><type>string</type><parameter>module</parameter></methodparam>
+ <type>object</type><methodname>dbx_connect</methodname>
+ <methodparam><type>mixed</type><parameter>module</parameter></methodparam>
<methodparam><type>string</type><parameter>host</parameter></methodparam>
<methodparam><type>string</type><parameter>database</parameter></methodparam>
<methodparam><type>string</type><parameter>username</parameter></methodparam>
@@ -86,66 +86,93 @@
<methodparam
choice="opt"><type>int</type><parameter>persistent</parameter></methodparam>
</methodsynopsis>
<para>
- Sikeres csatlakoz�skor egy �n. dbx_link_object-et ad vissza, hiba eset�n
- pedig &false;-t. Ha siker�lt a kapcsolatot felvenni, de a megadott adatb�zis
+ Sikeres csatlakoz�skor egy <type>object</type>-et ad vissza, hiba eset�n
+ pedig &false;-t. Ha siker�lt a kapcsolatot l�tes�teni, de a megadott adatb�zis
nem el�rhet�, akkor a kapcsolatot lez�rja �s &false;-t ad vissza.
A <parameter>persistent</parameter> param�ternek
<constant>DBX_PERSISTENT</constant>
- �rt�ket adva tart�s / perzisztens adatb�zis kapcsolatot nyit.
+ �rt�ket adva perzisztens adatb�zis kapcsolatot nyit.
</para>
<para>
- A <parameter>module</parameter> param�ter lehet sztring �s egy �lland� is.
- A lehets�ges �rt�kek al�bb l�that�k, de figyelembe veend�, hogy csak akkor
- m�k�dnek, ha az adott modul be van t�ltve.
+ A <parameter>module</parameter> param�ter lehet sztring is, de ink�bb a
+ felsorolt �lland�k valamelyike haszn�land�. A lehets�ges �rt�kek al�bb
+ l�that�k, de figyelembe veend�, hogy csak akkor m�k�dnek, ha az adott
+ modul be van t�ltve.
</para>
<para>
<itemizedlist>
<listitem>
<simpara>
- DBX_MYSQL : "mysql"
+ <constant>DBX_MYSQL</constant> vagy "mysql"
</simpara>
</listitem>
<listitem>
<simpara>
- DBX_ODBC : "odbc"
+ <constant>DBX_ODBC</constant> vagy "odbc"
</simpara>
</listitem>
<listitem>
<simpara>
- DBX_PGSQL : "pgsql"
+ <constant>DBX_PGSQL</constant> vagy "pgsql"
</simpara>
</listitem>
<listitem>
<simpara>
- DBX_MSSQL : "mssql"
+ <constant>DBX_MSSQL</constant> vagy "mssql"
</simpara>
</listitem>
<listitem>
<simpara>
- DBX_FBSQL : "fbsql" (csak CVS verzi�ban)
+ <constant>DBX_FBSQL</constant> vagy "fbsql" (PHP 4.1.1-t�l kezdve)
</simpara>
</listitem>
</itemizedlist>
</para>
<para>
- A dbx_link_object h�rom tagv�ltoz�val rendelkezik: <varname>handle</varname>,
- <varname>module</varname> �s <varname>database</varname>. A
- <varname>database</varname> tagv�ltoz� az aktu�lisan kiv�lasztott adatb�zis
- neve. A <varname>module</varname> tartalmazza a fent eml�tett �s �ppen
- haszn�lt modul sz�m�t. A <varname>handle</varname> az �rv�nyes
- kapcsolatazonos�t� az adatb�zishoz, �s �gy sz�ks�g eset�n az adott modulra
- jellemz� f�ggv�nyek h�v�sakor haszn�lhat�.
- </para>
- <para>
- <informalexample>
- <programlisting role="php">
+ A visszaadott objektum h�rom tagv�ltoz�val rendelkezik:
+ <variablelist>
+ <varlistentry>
+ <term>
+ <property>database</property>
+ </term>
+ <listitem>
+ <simpara>
+ Az aktu�lisan kiv�lasztott adatb�zis nev�t tartalmazza.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <property>handle</property>
+ </term>
+ <listitem>
+ <para>
+ Ennek a kapcsolatazonos�t�nak a seg�ts�g�vel sz�ks�g eset�n az adott
+ modulra jellemz� f�ggv�nyek valamelyike h�vhat� meg.
+ <informalexample>
+ <programlisting role="php">
<![CDATA[
<?php
-$link = dbx_connect ("mysql", "localhost", "db", "username", "password");
+$link = dbx_connect (DBX_MYSQL, "localhost", "db", "username", "password");
mysql_close ($link->handle); // dbx_close($link) haszn�lata itt sokkal jobb lenne...
?>
]]>
- </programlisting>
- </informalexample>
+ </programlisting>
+ </informalexample>
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <property>module</property>
+ </term>
+ <listitem>
+ <simpara>
+ Ezt a dbx kiterjeszt�s tartja fenn bels� haszn�latra, az �ppen
+ haszn�lt modul sz�m�t t�rolja.
+ </simpara>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</para>
<para>
A <parameter>host</parameter>, <parameter>database</parameter>,
@@ -159,7 +186,7 @@
<programlisting role="php">
<![CDATA[
<?php
-$link = dbx_connect ("odbc", "", "db", "username", "password", DBX_PERSISTENT)
+$link = dbx_connect (DBX_ODBC, "", "db", "username", "password", DBX_PERSISTENT)
or die ("Nem siker�lt kapcsol�dni.");
print ("Sikeresen kapcsol�dtam.");
dbx_close ($link);
@@ -191,7 +218,7 @@
<title>Le�r�s</title>
<methodsynopsis>
<type>string</type><methodname>dbx_error</methodname>
-
<methodparam><type>dbx_link_object</type><parameter>link_identifier</parameter></methodparam>
+
+<methodparam><type>object</type><parameter>link_identifier</parameter></methodparam>
</methodsynopsis>
<para>
A hiba sz�veg�t tartalmaz� sztringgel t�r vissza, amely a modulban
@@ -201,17 +228,12 @@
a <parameter>link_identifier</parameter> �ltal meghat�rozott modul utols�
hiba�zenet�t adja vissza.
</para>
- <note>
- <simpara>
- Az ODBC modul jelen pillanatban nem t�mogatja a hiba jelz� f�ggv�nyt.
- </simpara>
- </note>
<example>
<title><function>dbx_error</function> p�lda</title>
<programlisting role="php">
<![CDATA[
<?php
-$link = dbx_connect ("mysql", "localhost", "db", "username", "password")
+$link = dbx_connect (DBX_MYSQL, "localhost", "db", "username", "password")
or die ("Nem siker�lt kapcsol�dni.");
$result = dbx_query ($link, "select id from nem_letezo_tabla");
@@ -246,17 +268,44 @@
<refsect1>
<title>Le�r�s</title>
<methodsynopsis>
- <type>dbx_result_object</type><methodname>dbx_query</methodname>
-
<methodparam><type>dbx_link_object</type><parameter>link_identifier</parameter></methodparam>
+ <type>object</type><methodname>dbx_query</methodname>
+
+<methodparam><type>object</type><parameter>link_identifier</parameter></methodparam>
<methodparam><type>string</type><parameter>sql_statement</parameter></methodparam>
<methodparam
choice="opt"><type>long</type><parameter>flags</parameter></methodparam>
</methodsynopsis>
- <para>
+ <simpara>
Az <parameter>sql_statement</parameter> sikeres v�grehajt�sakor
- <literal>1</literal>-gyel vagy <type>dbx_result_object</type> t�pussal t�r
- vissza, ez ut�bbival csak olyan esetben, ha SQL utas�t�snak van
- v�geredm�nye. Hiba eset�n <literal>0</literal>-t ad vissza.
- </para>
+ <literal>1</literal>-gyel vagy egy objektummal t�r vissza, ez ut�bbival
+ csak olyan esetben, ha SQL utas�t�snak van v�geredm�nye.
+ Hiba eset�n <literal>0</literal>-t ad vissza.
+ </simpara>
+ <example>
+ <title>A visszat�r�si �rt�k lekezel�s�re</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$link = dbx_connect(DBX_ODBC, "", "db", "username", "password")
+ or die("Could not connect");
+
+$result = dbx_query($link, 'SELECT id, szulo_id, leiras FROM tabla');
+
+if ( is_object($result) ) {
+ // ... n�h�ny tov�bbi m�velet, l�sd m�g a lenti p�ld�kat ...
+ // el�sz�r, a mez�nevek �s t�pusaik ki�r�sa
+ // azut�n, egy t�bl�ba ki�rni a kapott v�geredm�nyt
+}
+else if ( $result == 1 ) {
+ echo("A lek�rdez�st sikeresen v�grehajtva, nincs visszaadott eredm�nyhalmaz");
+}
+else {
+ exit("Sikertelen lek�rdez�s");
+}
+
+dbx_close($link);
+?>
+]]>
+ </programlisting>
+ </example>
<para>
A <parameter>flags</parameter> param�teren kereszt�l szab�lyozhat� a
visszaadand� inform�ci� mennyis�ge. Ez a k�vetkez� �lland�k logikai vagy
@@ -264,29 +313,30 @@
<variablelist>
<varlistentry>
<term>
- <constant>DBX_RESULT_INFO</constant>
+ <constant>DBX_RESULT_INDEX</constant>
</term>
<listitem>
<simpara>
- Az oszlopokr�l ad inform�ci�t: a mez�k sz�m�r�l, neveikr�l �s t�pusaikr�l.
+ Ez <emphasis>mindig</emphasis> felhaszn�l�sra ker�l , �s hat�s�ra a
+ visszat�r�si �rt�k r�sze lesz egy k�t dimenzi�s t�mb, amelynek az els�
+ indexe a sorindex, a m�sodik az oszlopindex, azaz p�ld�ul a
+ <varname>data[2][3]</varname>-ban a <literal>2</literal> jel�li a
+ sort, a <literal>3</literal> az oszlopot. Az indexel�s 0-t�l kezd�dik.
+ </simpara>
+ <simpara>
+ Ha a <constant>DBX_RESULT_ASSOC</constant> is meg van adva, akkor a
+ minden esetben a <constant>DBX_RESULT_INFO</constant>-nak megfelel�
+ �rt�keket is szolg�ltatja a f�ggv�ny.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term>
- <constant>DBX_RESULT_INDEX</constant>
+ <constant>DBX_RESULT_INFO</constant>
</term>
<listitem>
<simpara>
- Ennek megad�s�val a visszat�r�si �rt�k r�sze lesz egy k�t dimenzi�s
- t�mb, amelynek az els� indexe a sorindex, a m�sodik az oszlopindex,
- azaz p�ld�ul a <varname>data[2][3]</varname>-ban a 2 jel�li a sort,
- a 3 az oszlopot. Az indexel�s 0-t�l kezd�dik.
- </simpara>
- <simpara>
- Ha a <constant>DBX_RESULT_ASSOC</constant> meg van adva, akkor a minden
- esetben a <constant>DBX_RESULT_INFO</constant>-nak megfelel� �rt�keket
- is szolg�ltatja a f�ggv�ny.
+ Az oszlopokr�l ad inform�ci�t: a mez�k sz�m�r�l, neveikr�l �s t�pusaikr�l.
</simpara>
</listitem>
</varlistentry>
@@ -296,8 +346,9 @@
</term>
<listitem>
<simpara>
- Ennek hat�s�ra az oszlopok�rt�keket az oszlopnevekkel is lehet
- indexelni.
+ Ennek hat�s�ra az oszlop�rt�keket az oszlopnevekkel is lehet
+ indexelni, azaz a visszaadott eredm�nyhalmaz asszociat�v t�mbk�nt
+ is haszn�lhat�.
</simpara>
<simpara>
Ezek az asszociat�v indexek val�j�ban referenci�k a numerikus
@@ -308,16 +359,16 @@
</listitem>
</varlistentry>
</variablelist>
- Megjegyzend�, hogy a <constant>DBX_RESULT_INDEX</constant>-t mindig
+ Megjegyzend�, hogy a <constant>DBX_RESULT_INDEX</constant>-et mindig
haszn�lja a f�ggv�ny, f�ggetlen�l a <parameter>flags</parameter> param�ter
�rt�k�t�l. Emiatt val�j�ban csak az al�bbi kombin�ci�k �rtelmesek:
<itemizedlist>
<listitem>
+ <listitem>
<simpara>
- <constant>DBX_RESULT_INFO</constant>
+ <constant>DBX_RESULT_INDEX</constant>
</simpara>
</listitem>
- <listitem>
<simpara>
<constant>DBX_RESULT_INDEX</constant> |
<constant>DBX_RESULT_INFO</constant>
@@ -334,110 +385,109 @@
</itemizedlist>
</para>
<para>
- A visszaadott dbx_result_object t�pusnak n�gy vagy �t tagv�ltoz�ja van a
- <parameter>flags</parameter>-t�l f�gg�en: <varname>handle</varname>,
- <varname>cols</varname>, <varname>rows</varname>, <varname>info</varname>
- (nem mindig), �s a <varname>data</varname>. A <varname>handle</varname> az
�rv�nyes
- kapcsolatazonos�t� az adatb�zishoz, �s �gy sz�ks�g eset�n az adott modulra
- jellemz� f�ggv�nyek h�v�s�hoz haszn�lhat�:
- </para>
- <para>
- <informalexample role="php">
- <programlisting>
+ A visszaadott objektumnak n�gy vagy �t tagv�ltoz�ja van a
+ <parameter>flags</parameter>-t�l f�gg�en:
+ <variablelist>
+ <varlistentry>
+ <term>
+ <property>handle</property>
+ </term>
+ <listitem>
+ <para>
+ �rv�nyes kapcsolatazonos�t� az adatb�zishoz, �s �gy sz�ks�g eset�n az
+ adott modulra jellemz� f�ggv�nyek h�v�s�hoz haszn�lhat�:
+ <informalexample role="php">
+ <programlisting>
<![CDATA[
$result = dbx_query ($link, "SELECT id FROM tabla");
$length = mysql_field_len($result->handle, 0);
]]>
- </programlisting>
- </informalexample>
- </para>
- <para>
- A <varname>cols</varname> �s <varname>rows</varname> tagv�ltoz�k tartalmazz�k
- a vissza oszlopok/mez�k �s sorok/rekordok sz�m�t.
- </para>
- <para>
- <informalexample>
- <programlisting role="php">
+ </programlisting>
+ </informalexample>
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <property>cols</property> and <property>rows</property>
+ </term>
+ <listitem>
+ <para>
+ A <varname>cols</varname> �s <varname>rows</varname> tagv�ltoz�k
+ t�rolj�k az eredm�nyhalmaz m�reteit: az oszlopok/mez�k �s a
+ sorok/rekordok sz�m�t.
+ <informalexample>
+ <programlisting role="php">
<![CDATA[
$result = dbx_query ($link, "SELECT id FROM tabla");
echo "Az eredm�ny m�rete: " . $result->rows . " x " . $result->cols . "<br/>\n";
]]>
- </programlisting>
- </informalexample>
- </para>
- <para>
- Az <varname>info</varname> tagv�ltoz� csak akkor haszn�lhat�, ha a
- <constant>DBX_RESULT_INFO</constant> �s/vagy
- <constant>DBX_RESULT_ASSOC</constant> szerepel a
- <parameter>flags</parameter> param�terben. Ez olyan k�tdimenz�s t�mb,
- amelynek k�t neves�tett sora van ("name" �s "type") a mez�inform�ci�k
- el�r�s�hez.
- </para>
- <para>
- <informalexample>
- <programlisting role="php">
+ </programlisting>
+ </informalexample>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <property>info</property> (optional)
+ </term>
+ <listitem>
+ <simpara>
+ Az <varname>info</varname> tagv�ltoz� csak akkor �rhet� el, ha a
+ <constant>DBX_RESULT_INFO</constant> �s/vagy
+ <constant>DBX_RESULT_ASSOC</constant> szerepel a
+ <parameter>flags</parameter> param�terben. Ez olyan k�tdimenz�s t�mb,
+ amelynek k�t neves�tett sora van (<literal>name</literal> �s
+ <literal>type</literal>) a mez�inform�ci�k el�r�s�hez.
+ </simpara>
+ <example>
+ <title>minden mez� nev�nek �s t�pus�nak kilist�z�sa</title>
+ <programlisting role="php">
<![CDATA[
-$result = dbx_query ($link, "SELECT id FROM tabla");
-echo "mez� neve : " . $result->info["name"][0] . "<br>\n";
-echo "mez� t�pusa: " . $result->info["type"][0] . "<br>\n";
+$result = dbx_query ($link, 'SELECT id FROM tabla', DBX_RESULT_INDEX |
+DBX_RESULT_INFO);
+
+for ($i = 0; $i < $result->cols; $i++ ) {
+ echo $result->info['name'][$i] . "\n";
+ echo $result->info['type'][$i] . "\n";
+}
]]>
- </programlisting>
- </informalexample>
- </para>
- <para>
- The <varname>data</varname> tagv�ltoz� tartalmazza a t�nyleges
- v�geredm�nyt, lehet�s�g szerint a megfelel� mez�nevekkel is indexelve -
- asszociat�v t�mbk�nt. Ha a <constant>DBX_RESULT_ASSOC</constant> be van
- �ll�tva, akkor az adatok <literal>$result->data[2]["mez�_neve"]</literal>
- alakban is el�rhet�k lesznek.
- </para>
- <example>
- <title><function>dbx_query</function> p�lda</title>
- <programlisting role="php">
+ </programlisting>
+ </example>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <property>data</property>
+ </term>
+ <listitem>
+ <simpara>
+ A <varname>data</varname> tagv�ltoz� tartalmazza a t�nyleges
+ v�geredm�nyt, az eredm�nyhalmazt, ha van ilyen. Ha a
+ <constant>DBX_RESULT_ASSOC</constant> is r�sze a
+ <parameter>flags</parameter>-nek, akkor az adatok
+ <literal>$result->data[2]["mez�_neve"]</literal> alakban is el�rhet�k
+ lesznek, asszociat�v t�mbk�nt kezelve a <property>data</property>-t.
+ </simpara>
+ <example>
+ <title>a data tagv�ltoz� ki�rat�sa HTML t�blak�nt</title>
+ <programlisting role="php">
<![CDATA[
-<?php
-$link = dbx_connect("odbc", "", "db", "username", "password")
- or die ("Nem siker�lt kapcsol�dni.");
-
-$result = dbx_query($link, "SELECT id, pid, leiras FROM tabla")
- or die ("Rossz lek�rdez�s");
-
-if ( $result == 1 ) {
- echo "A lek�rdez�s sikeresen v�grehajtva.\n<br>";
-} else {
- $rows = $result->rows;
- $cols = $result->cols;
- echo "<p>A t�bla m�rete: {$result->rows} x {$result->cols}<br><table border=1>\n";
- echo "<tr>";
+$result = dbx_query ($link, 'SELECT id, szulo_id, leiras FROM tabla');
- for ( $col = 0; $col < $cols; ++$col ){
- echo
"<td>-{$result->info["name"][$col]}-<br>-{$result->info["type"][$col]}-</td>";
+echo "<table>\n";
+foreach ( $result->data as $sor ) {
+ echo "<tr>\n";
+ foreach ( $sor as $oszlop ) {
+ echo "<td>$oszlop</td>";
}
echo "</tr>\n";
- foreach ( $result->data as $row ) {
- echo "<tr>";
- foreach ( $row as $field ) {
- echo "<td>-$field-</td>";
- }
- echo "</tr>\n";
- }
-
- echo "</table>\n";
- echo "table dimension: {$result->rows} x id, parentid, description<br><table
border=1>\n";
- for ($row=0; $row<$rows; ++$row) {
- echo "<tr>";
- echo "<td>-{$result->data[$row]['id']}-</td>";
- echo "<td>-{$result->data[$row]['pid']}-</td>";
- echo "<td>-{$result->data[$row]['leiras']}-</td>";
- echo "</tr>\n";
- }
- echo "</table><p>\n";
}
-dbx_close($link);
-?>
+echo "</table>\n";
]]>
- </programlisting>
- </example>
+ </programlisting>
+ </example>
+ </listitem>
+ </varlistentry>
+ </variablelist>
<note>
<para>
Haszn�ld mindig az adatb�zis specifikus dokument�ci�t is!
@@ -460,13 +510,20 @@
<title>Le�r�s</title>
<methodsynopsis>
<type>bool</type><methodname>dbx_sort</methodname>
-
<methodparam><type>dbx_result_object</type><parameter>result</parameter></methodparam>
+ <methodparam><type>object</type><parameter>result</parameter></methodparam>
<methodparam><type>string</type><parameter>user_compare_function</parameter></methodparam>
</methodsynopsis>
<para>
Sikeres v�grehajt�s eset�n &true;-val t�r vissza, egy�bk�nt hiba
eset�n &false;-szal.
</para>
+ <note>
+ <simpara>
+ Az <literal>SQL</literal> lek�rdez�sen bel�l haszn�lt rendez�s
+ (<literal>ORDER BY</literal>) mindig jobb hat�sfok�, mint a
+<function>dbx_sort</function>
+ Ha lehet, mindig az el�bbit haszn�ld!
+ </simpara>
+ </note>
<example>
<title><function>dbx_sort</function> p�lda</title>
<programlisting role="php">
@@ -476,12 +533,12 @@
$rv = dbx_compare($a, $b, "pid", DBX_CMP_DESC);
// ha 'pid' szerint nem rendezhet�ek sorba, akkor 'id' szerint
if ( !$rv ) {
- $rv = dbx_compare($a, $b, "id");
+ $rv = dbx_compare($a, $b, "id", DBX_CMP_NUMBER);
}
return $rv;
}
-$link = dbx_connect("odbc", "", "db", "username", "password")
+$link = dbx_connect(DBX_ODBC, "", "db", "username", "password")
or die ("Nem siker�lt csatlakozni.");
$result = dbx_query($link, "SELECT id, pid, leiras FROM tabla ORDER BY id");
@@ -512,66 +569,60 @@
<type>int</type><methodname>dbx_compare</methodname>
<methodparam><type>array</type><parameter>row_a</parameter></methodparam>
<methodparam><type>array</type><parameter>row_b</parameter></methodparam>
-
<methodparam><type>string</type><parameter>columnname_or_index</parameter></methodparam>
+ <methodparam><type>string</type><parameter>column_key</parameter></methodparam>
<methodparam
choice="opt"><type>int</type><parameter>flags</parameter></methodparam>
</methodsynopsis>
<para>
- <literal>0</literal>-val t�r vissza, ha a
<varname>row_a[$columnname_or_index]</varname>
- egyenl� <varname>row_b[$columnname_or_index]</varname> kifejez�ssel, �s
- <literal>1</literal>-gyel, ha az els� nagyobb, illetve <literal>-1</literal>,
+ <literal>0</literal>-val t�r vissza, ha a <varname>row_a[$column_key]</varname>
+ egyenl� a <varname>row_b[$column_key]</varname> kifejez�ssel, �s
+ <literal>1</literal>-gyel, ha az els� nagyobb, illetve
+<literal>-1</literal>-gyel,
ha ez kisebb. Ha <parameter>flags</parameter> �rt�ke
<constant>DBX_CMP_DESC</constant>, akkor pont ford�tott �rt�kek ad�dnak
elt�r� bemenetek eset�n.
+ <function>dbx_compare</function> kiseg�t� f�ggv�ny a
+<function>dbx_sort</function>
+ haszn�lat�hoz, hogy k�nnyebben lehessen �rni �s haszn�lni saj�t defini�l�s�
+ �sszehasonl�t� f�ggv�nyeket.
</para>
<para>
A <parameter>flags</parameter> haszn�lhat� arra, hogy be�ll�tsuk az
- �sszehasonl�t�s ir�ny�t:
- <variablelist>
- <varlistentry>
- <term>
- <constant>DBX_CMP_ASC</constant>
- </term>
+ a rendez�s ir�ny�t:
+ <itemizedlist>
+ <listitem>
+ <simpara>
+ <constant>DBX_CMP_ASC</constant> - n�vekv� sorrendet �r el�
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ <constant>DBX_CMP_DESC</constant> - cs�kken� sorrendet �r el�
+ </simpara>
+ </listitem>
+ </itemizedlist>
+ �s az �sszehasonl�t�s t�pus�t (milyen t�pusra konvert�lja az �rt�keket):
+ <itemizedlist>
<listitem>
<simpara>
- n�vekv� sorrendet �r el�
+ <constant>DBX_CMP_NATIVE</constant> -
+ t�puskonverzi� n�lk�l hasonl�tja �ssze az elemeket
</simpara>
</listitem>
- </varlistentry>
- <varlistentry>
- <term>
- <constant>DBX_CMP_DESC</constant>
- </term>
<listitem>
<simpara>
- cs�kken� sorrendet �r el�
+ <constant>DBX_CMP_NUMBER</constant> -
+ sz�mk�nt hasonl�tja �ssze az elemeket
</simpara>
</listitem>
- </varlistentry>
- </variablelist>
- �s az �sszehasonl�t�s t�pus�t (milyen t�pusra konvert�lja az �rt�keket):
- <variablelist>
- <varlistentry>
- <term><constant>DBX_CMP_NATIVE</constant></term>
<listitem>
- <simpara>t�puskonverzi� n�lk�l hasonl�tja �ssze az elemeket</simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><constant>DBX_CMP_NUMBER</constant></term>
- <listitem>
- <simpara>sz�mk�nt hasonl�tja �ssze az elemeket</simpara>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><constant>DBX_CMP_TEXT</constant></term>
- <listitem>
- <simpara>sz�vegk�nt hasonl�tja �ssze az elemeket</simpara>
+ <simpara>
+ <constant>DBX_CMP_TEXT</constant> -
+ sz�vegk�nt hasonl�tja �ssze az elemeket
+ </simpara>
</listitem>
- </varlistentry>
- </variablelist>
- Ezeket az �lland�kat logikai vagy kapcsolattal lehet kombin�lni, a
- <parameter>flags</parameter> param�ter alap�rtelmez�se a
- <constant>DBX_CMP_ASC</constant> | <constant>DBX_CMP_NATIVE</constant>.
+ </itemizedlist>
+ Egy - egy ir�nyra �s t�pusra vonatkoz� �lland�t a logikai VAGY kapcsolattal
+ lehet kombin�lni (|). A <parameter>flags</parameter> param�ter
+ alap�rtelmez�se a <constant>DBX_CMP_ASC</constant> |
+ <constant>DBX_CMP_NATIVE</constant>.
</para>
<example>
<title><function>dbx_compare</function> p�lda</title>
@@ -579,15 +630,15 @@
<