Source of: /manual/es/function.dbx-compare.php
<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.dbx.inc";
$setup = array (
'home' =>
array (
0 => 'index.php',
1 => 'PHP Manual',
),
'head' =>
array (
0 => 'UTF-8',
1 => 'es',
),
'this' =>
array (
0 => 'function.dbx-compare.php',
1 => 'dbx_compare',
),
'up' =>
array (
0 => 'ref.dbx.php',
1 => 'Funciones de dbx',
),
'prev' =>
array (
0 => 'function.dbx-close.php',
1 => 'dbx_close',
),
'next' =>
array (
0 => 'function.dbx-connect.php',
1 => 'dbx_connect',
),
'alternatives' =>
array (
),
);
$setup["toc"] = $TOC;
$setup["parents"] = $PARENTS;
manual_setup($setup);
manual_header();
?>
<div id="function.dbx-compare" class="refentry">
<div class="refnamediv">
<h1 class="refname">dbx_compare</h1>
<p class="verinfo">(PHP 4 >= 4.1.0, PHP 5 <= 5.0.5, PECL dbx >= 1.1.0)</p><p class="refpurpose"><span class="refname">dbx_compare</span> — <span class="dc-title">Comparar dos filas con propósitos de ordenación</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.dbx-compare-description">
<h3 class="title">Descripción</h3>
<div class="methodsynopsis dc-description">
<span class="type">int</span> <span class="methodname"><strong>dbx_compare</strong></span>
( <span class="methodparam"><span class="type">array</span> <code class="parameter">$row_a</code></span>
, <span class="methodparam"><span class="type">array</span> <code class="parameter">$row_b</code></span>
, <span class="methodparam"><span class="type">string</span> <code class="parameter">$column_key</code></span>
[, <span class="methodparam"><span class="type">int</span> <code class="parameter">$flags</code><span class="initializer"> = DBX_CMP_ASC | DBX_CMP_NATIVE</span></span>
] )</div>
<p class="para rdfs-comment">
<span class="function"><strong>dbx_compare()</strong></span> es una función de ayuda para
<span class="function"><a href="function.dbx-sort.php" class="function">dbx_sort()</a></span> para facilitar la construcción y el uso de funciones
de ordenación personalizadas.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.dbx-compare-parameters">
<h3 class="title">Parámetros</h3>
<p class="para">
<dl>
<dt>
<span class="term"><em><code class="parameter">row_a</code></em></span>
<dd>
<p class="para">
Primera fila
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">row_b</code></em></span>
<dd>
<p class="para">
Sgunda fila
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">column_key</code></em></span>
<dd>
<p class="para">
La columna comparada
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">flags</code></em></span>
<dd>
<p class="para">
<em><code class="parameter">flags</code></em> puede ser establecido para especificar la dirección
de comparación:
<ul class="itemizedlist">
<li class="listitem">
<span class="simpara">
<strong><code>DBX_CMP_ASC</code></strong> - orden ascendente
</span>
</li>
<li class="listitem">
<span class="simpara">
<strong><code>DBX_CMP_DESC</code></strong> - orden descendente
</span>
</li>
</ul>
y el tipo de comparación preferido:
<ul class="itemizedlist">
<li class="listitem">
<span class="simpara">
<strong><code>DBX_CMP_NATIVE</code></strong> - sin conversión de tipo
</span>
</li>
<li class="listitem">
<span class="simpara">
<strong><code>DBX_CMP_TEXT</code></strong> - comparar elementos como cadenas
</span>
</li>
<li class="listitem">
<span class="simpara">
<strong><code>DBX_CMP_NUMBER</code></strong> - comparar elementos numéricamente
</span>
</li>
</ul>
Se pueden combinar una de las constantes de dirección y tipo con
el operador a nivel de bit OR (|).
</p>
</dd>
</dt>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.dbx-compare-returnvalues">
<h3 class="title">Valores devueltos</h3>
<p class="para">
Devuelve <em>0</em> si <em>row_a[$column_key]</em>
es igual a <em>row_b[$column_key]</em>, y <em>1</em>
o <em>-1</em> si el primero es mayor o menor que el
segundo respectivamente, o vice versa si <em><code class="parameter">flag</code></em>
está establacido a <strong><code>DBX_CMP_DESC</code></strong>.
</p>
</div>
<div class="refsect1 examples" id="refsect1-function.dbx-compare-examples">
<h3 class="title">Ejemplos</h3>
<p class="para">
<div class="example" id="example-949">
<p><strong>Ejemplo #1 Ejemplo de <span class="function"><strong>dbx_compare()</strong></span></strong></p>
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br /></span><span style="color: #007700">function </span><span style="color: #0000BB">user_re_order</span><span style="color: #007700">(</span><span style="color: #0000BB">$a</span><span style="color: #007700">, </span><span style="color: #0000BB">$b</span><span style="color: #007700">) <br />{<br /> </span><span style="color: #0000BB">$rv </span><span style="color: #007700">= </span><span style="color: #0000BB">dbx_compare</span><span style="color: #007700">(</span><span style="color: #0000BB">$a</span><span style="color: #007700">, </span><span style="color: #0000BB">$b</span><span style="color: #007700">, </span><span style="color: #DD0000">"parentid"</span><span style="color: #007700">, </span><span style="color: #0000BB">DBX_CMP_DESC</span><span style="color: #007700">);<br /> if (!</span><span style="color: #0000BB">$rv</span><span style="color: #007700">) {<br /> </span><span style="color: #0000BB">$rv </span><span style="color: #007700">= </span><span style="color: #0000BB">dbx_compare</span><span style="color: #007700">(</span><span style="color: #0000BB">$a</span><span style="color: #007700">, </span><span style="color: #0000BB">$b</span><span style="color: #007700">, </span><span style="color: #DD0000">"id"</span><span style="color: #007700">, </span><span style="color: #0000BB">DBX_CMP_NUMBER</span><span style="color: #007700">);<br /> }<br /> return </span><span style="color: #0000BB">$rv</span><span style="color: #007700">;<br />}<br /><br /></span><span style="color: #0000BB">$enlace </span><span style="color: #007700">= </span><span style="color: #0000BB">dbx_connect</span><span style="color: #007700">(</span><span style="color: #0000BB">DBX_ODBC</span><span style="color: #007700">, </span><span style="color: #DD0000">""</span><span style="color: #007700">, </span><span style="color: #DD0000">"db"</span><span style="color: #007700">, </span><span style="color: #DD0000">"username"</span><span style="color: #007700">, </span><span style="color: #DD0000">"password"</span><span style="color: #007700">)<br /> or die(</span><span style="color: #DD0000">"No se pudo conectar"</span><span style="color: #007700">);<br /><br /></span><span style="color: #0000BB">$resultado </span><span style="color: #007700">= </span><span style="color: #0000BB">dbx_query</span><span style="color: #007700">(</span><span style="color: #0000BB">$enlace</span><span style="color: #007700">, </span><span style="color: #DD0000">"SELECT id, parentid, description FROM table ORDER BY id"</span><span style="color: #007700">);<br /> </span><span style="color: #FF8000">// la información en $resultado ahora está ordenada por id<br /><br /></span><span style="color: #0000BB">dbx_sort</span><span style="color: #007700">(</span><span style="color: #0000BB">$result</span><span style="color: #007700">, </span><span style="color: #DD0000">"user_re_order"</span><span style="color: #007700">);<br /> </span><span style="color: #FF8000">// la información en $resultado ahora está ordenada por parentid (descendentemente), luego por id<br /><br /></span><span style="color: #0000BB">dbx_close</span><span style="color: #007700">(</span><span style="color: #0000BB">$enlace</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
</div>
</p>
</div>
<div class="refsect1 seealso" id="refsect1-function.dbx-compare-seealso">
<h3 class="title">Ver también</h3>
<p class="para">
<ul class="simplelist">
<li class="member"> <span class="function"><a href="function.dbx-sort.php" class="function" rel="rdfs-seeAlso">dbx_sort()</a> - Ordenar un resultado de una llamada a dbx_query mediante una función de ordenación personalizada</span></li>
</ul>
</p>
</div>
</div><?php manual_footer(); ?>
