|
1 | 1 | <?xml version="1.0" encoding="utf-8"?>
|
2 | 2 | <!-- $Revision$ -->
|
3 |
| -<!-- EN-Revision: d345f907bb0e43530c8280e556746263e5c97f4b Maintainer: seros Status: ready --> |
| 3 | +<!-- EN-Revision: 4754397753fd79f1c846868b66a2448babab1c54 Maintainer: PhilDaiguille Status: ready --> |
| 4 | +<!-- Reviewed: no --> |
4 | 5 |
|
5 | 6 | <refentry xml:id="function.cubrid-fetch-array" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
6 | 7 | <refnamediv>
|
7 | 8 | <refname>cubrid_fetch_array</refname>
|
8 |
| - <refpurpose>Extrae una fila como array asociativo, numérico o ambos</refpurpose> |
| 9 | + <refpurpose>Recupera una línea de resultado en forma de array asociativo, array numérico, o ambos</refpurpose> |
9 | 10 | </refnamediv>
|
10 |
| - |
| 11 | + |
11 | 12 | <refsect1 role="description">
|
12 | 13 | &reftitle.description;
|
13 | 14 | <methodsynopsis>
|
|
16 | 17 | <methodparam choice="opt"><type>int</type><parameter>type</parameter><initializer>CUBRID_BOTH</initializer></methodparam>
|
17 | 18 | </methodsynopsis>
|
18 | 19 | <para>
|
19 |
| - La función <function>cubrid_fetch_array</function> se utiliza para consultar una |
20 |
| - única fila del resultado de la consulta, y lo devuelve como array. El cursor |
21 |
| - avanza automáticamente a la siguiente fila del resultado. |
| 20 | + La función <function>cubrid_fetch_array</function> se utiliza para recuperar |
| 21 | + una sola línea desde el resultado de la consulta y devuelve |
| 22 | + un array. El cursor se mueve automáticamente a la siguiente línea |
| 23 | + una vez que el resultado ha sido recuperado. |
22 | 24 | </para>
|
23 | 25 | </refsect1>
|
24 |
| - |
| 26 | + |
25 | 27 | <refsect1 role="parameters">
|
26 | 28 | &reftitle.parameters;
|
27 | 29 | <para>
|
28 | 30 | <variablelist>
|
29 | 31 | <varlistentry>
|
30 | 32 | <term><parameter>result</parameter></term>
|
31 |
| - <listitem><para><parameter>result</parameter> proviene de una llamada a la función <function>cubrid_execute</function></para></listitem> |
| 33 | + <listitem><para>El parámetro <parameter>Result</parameter> proviene de una |
| 34 | + llamada a la función <function>cubrid_execute</function></para></listitem> |
32 | 35 | </varlistentry>
|
33 | 36 | <varlistentry>
|
34 | 37 | <term><parameter>type</parameter></term>
|
35 |
| - <listitem><para>Tipo de array del resultado obtenido: CUBRID_NUM, CUBRID_ASSOC, |
36 |
| - CUBRID_BOTH, CUBRID_OBJECT. Si se operan con objetos lob, se puede usar CUBRID_LOB.</para></listitem> |
| 38 | + <listitem><para>Tipo del array recuperado: CUBRID_NUM, CUBRID_ASSOC, CUBRID_BOTH. |
| 39 | + Si se necesita utilizar un objeto LOB, se puede utilizar CUBRID_LOB. |
| 40 | + </para></listitem> |
37 | 41 | </varlistentry>
|
38 | 42 | </variablelist>
|
39 | 43 | </para>
|
40 | 44 | </refsect1>
|
41 |
| - |
| 45 | + |
42 | 46 | <refsect1 role="returnvalues">
|
43 | 47 | &reftitle.returnvalues;
|
44 |
| - <para>Devuelve un array de cadenas que se corresponden a la fila consultada, cuando ésta tenga éxito.</para> |
45 |
| - <para>&false;, cuando no existen más filas; NULL, cuando el proceso no tiene éxito.</para> |
46 |
| - <para>El tipo del array devuelto se definirá dependiendo de cómo se haya solicitado. Usando CUBRID_BOTH (por omisión), se obtendrá un array con índices numéricos y asociativos, y se podrá decidir qué tipo de datos usar mediante el parámetro <parameter>type</parameter>. En la variable <parameter>type</parameter> puede asignarse uno de los siguientes valores:</para> |
| 48 | + <para> |
| 49 | + Devuelve un array de strings correspondiente a la línea |
| 50 | + recuperada, cuando la operación tiene éxito. |
| 51 | + </para> |
| 52 | + <para>&false; cuando no hay más líneas, |
| 53 | + NULL cuando ocurre un error.</para> |
| 54 | + <para> |
| 55 | + El tipo del array devuelto depende del tipo que se haya definido. |
| 56 | + Utilizando CUBRID_BOTH (valor por defecto), se recuperará un array |
| 57 | + que contiene tanto índices asociativos como numéricos; se puede elegir explícitamente este tipo a través del argumento <parameter>type</parameter>. |
| 58 | + La variable <parameter>type</parameter> puede ser definida a uno de |
| 59 | + los siguientes valores:</para> |
47 | 60 | <simplelist>
|
48 |
| - <member>CUBRID_NUM : Array numérico (basado en 0)</member> |
49 |
| - <member>CUBRID_ASSOC : Array asociativo</member> |
50 |
| - <member>CUBRID_BOTH : Array numérico y asociativo (predeterminado)</member> |
51 |
| - </simplelist> |
| 61 | + <member>CUBRID_NUM: Array numérico (comenzando en el índice 0)</member> |
| 62 | + <member>CUBRID_ASSOC: Array asociativo</member> |
| 63 | + <member>CUBRID_BOTH: Array asociativo y numérico (valor por defecto)</member> |
| 64 | + </simplelist> |
52 | 65 | </refsect1>
|
53 |
| - |
| 66 | + |
54 | 67 | <refsect1 role="examples">
|
55 | 68 | &reftitle.examples;
|
56 | 69 | <example>
|
57 |
| - <title>Ejemplo de <function>cubrid_fetch_array</function></title> |
| 70 | + <title>Ejemplo con <function>cubrid_fetch_array</function></title> |
58 | 71 | <programlisting role="php">
|
59 | 72 | <![CDATA[
|
60 | 73 | <?php
|
61 |
| -$conexión = cubrid_connect("localhost", 33000, "demodb"); |
62 |
| -$solicitud = cubrid_execute($conexión, "SELECT name,area,seats,address FROM stadium WHERE nation_code='GRE' AND seats > 10000"); |
| 74 | +$conn = cubrid_connect("localhost", 33000, "demodb"); |
| 75 | +$req = cubrid_execute($conn, "SELECT name,area,seats,address FROM stadium WHERE nation_code='GRE' AND seats > 10000"); |
63 | 76 |
|
64 | 77 | printf("%-40s %-10s %-6s %-20s\n", "name", "area", "seats", "address");
|
65 |
| -while ($fila = cubrid_fetch_array($solicitud, CUBRID_NUM)) { |
66 |
| - printf("%-40s %-10s %-6s %-20s\n", $fila[0], $fila[1], $fila[2], $fila[3]); |
| 78 | +while ($row = cubrid_fetch_array($req, CUBRID_NUM)) { |
| 79 | + printf("%-40s %-10s %-6s %-20s\n", $row[0], $row[1], $row[2], $row[3]); |
67 | 80 | }
|
68 | 81 |
|
69 |
| -// si se operan con objetos lob, se puede usar cubrid_fetch_array($solicitud, CUBRID_NUM | CUBRID_LOB) |
| 82 | +// Si se desea utilizar un objeto LOB, se puede utilizar |
| 83 | +// cubrid_fetch_array($req, CUBRID_NUM | CUBRID_LOB) |
70 | 84 |
|
71 |
| -cubrid_close_request($solicitud); |
| 85 | +cubrid_close_request($req); |
72 | 86 |
|
73 |
| -cubrid_disconnect($conexión); |
| 87 | +cubrid_disconnect($conn); |
74 | 88 | ?>
|
75 | 89 | ]]>
|
76 | 90 | </programlisting>
|
77 | 91 | &example.outputs;
|
78 | 92 | <screen>
|
79 | 93 | <![CDATA[
|
80 |
| -name area seats address |
81 |
| -Panathinaiko Stadium 86300.00 50000 Athens, Greece |
82 |
| -Olympic Stadium 54700.00 13000 Athens, Greece |
83 |
| -Olympic Indoor Hall 34100.00 18800 Athens, Greece |
84 |
| -Olympic Hall 52400.00 21000 Athens, Greece |
85 |
| -Olympic Aquatic Centre 42500.00 11500 Athens, Greece |
| 94 | +name area seats address |
| 95 | +Panathinaiko Stadium 86300.00 50000 Athens, Greece |
| 96 | +Olympic Stadium 54700.00 13000 Athens, Greece |
| 97 | +Olympic Indoor Hall 34100.00 18800 Athens, Greece |
| 98 | +Olympic Hall 52400.00 21000 Athens, Greece |
| 99 | +Olympic Aquatic Centre 42500.00 11500 Athens, Greece |
86 | 100 | Markopoulo Olympic Equestrian Centre 64000.00 15000 Markopoulo, Athens, Greece
|
87 | 101 | Faliro Coastal Zone Olympic Complex 34650.00 12171 Faliro, Athens, Greece
|
88 | 102 | Athens Olympic Stadium 120400.00 71030 Maroussi, Athens, Greece
|
89 | 103 | Ano Liossia 34000.00 12000 Ano Liosia, Athens, Greece
|
90 | 104 | ]]>
|
91 | 105 | </screen>
|
92 |
| - |
| 106 | + |
93 | 107 | </example>
|
94 | 108 | </refsect1>
|
95 |
| - |
| 109 | + |
96 | 110 | <refsect1 role="seealso">
|
97 | 111 | &reftitle.seealso;
|
98 | 112 | <para>
|
99 | 113 | <simplelist>
|
100 |
| - <member><function>cubrid_execute</function></member> |
101 |
| - <member><function>cubrid_fetch</function></member> |
102 |
| - <member><function>cubrid_fetch_row</function></member> |
103 |
| - <member><function>cubrid_fetch_assoc</function></member> |
104 |
| - <member><function>cubrid_fetch_object</function></member> |
| 114 | + <member><function>cubrid_execute</function></member> |
| 115 | + <member><function>cubrid_fetch</function></member> |
| 116 | + <member><function>cubrid_fetch_row</function></member> |
| 117 | + <member><function>cubrid_fetch_assoc</function></member> |
| 118 | + <member><function>cubrid_fetch_object</function></member> |
105 | 119 | </simplelist>
|
106 | 120 | </para>
|
107 |
| - </refsect1> |
108 |
| - |
| 121 | + </refsect1> |
| 122 | + |
109 | 123 | </refentry>
|
110 | 124 |
|
111 | 125 | <!-- Keep this comment at the end of the file
|
|
0 commit comments