Skip to content

Commit 7478267

Browse files
fix EN revision zero + update (#154)
1 parent f2d13ef commit 7478267

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

48 files changed

+1148
-1137
lines changed

appendices/migration82/deprecated.xml

+37-40
Original file line numberDiff line numberDiff line change
@@ -1,45 +1,42 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- $Revision$ -->
3-
<!-- EN-Revision: 65716f4761484e314ee86fa23493f00f7823ace1 Maintainer: julionc Status: wip -->
4-
<!-- Reviewed: yes -->
2+
<!-- EN-Revision: 65716f4761484e314ee86fa23493f00f7823ace1 Maintainer: PhilDaiguille Status: ready -->
3+
<!-- Reviewed: no -->
54
<sect1 xml:id="migration82.deprecated">
6-
<title>Características obsoletas</title>
5+
<title>Funcionalidades obsoletas</title>
76

87
<sect2 xml:id="migration82.deprecated.core">
9-
<title>Núcleo PHP</title>
8+
<title>PHP Core</title>
109

1110
<sect3 xml:id="migration82.deprecated.core.dynamic-properties">
12-
<title>Uso de las propiedades dinámicas</title>
11+
<title>Uso de propiedades dinámicas</title>
1312

1413
<para>
15-
La creación de propiedades dinámicas está obsoleta, a menos que
16-
la clase opte por utilizar el atributo <code>#[\AllowDynamicProperties]</code>.
17-
La clase <classname>stdClass</classname> permite propiedades dinámicas.
18-
El uso de los métodos mágicos como <link linkend="object.get">__get()</link>/<link linkend="object.set">__set()</link> no se ven afectados por este cambio.
19-
Un aviso de obsolescencia de uso de propiedades dinámicas puede ser abordado por:
14+
La creación de propiedades dinámicas es obsoleta, a menos que la clase lo permita utilizando el atributo <code>#[\AllowDynamicProperties]</code>.
15+
<classname>stdClass</classname> permite las propiedades dinámicas.
16+
El uso de los métodos mágicos <link linkend="object.get">__get()</link>/<link linkend="object.set">__set()</link> no se ve afectado por este cambio.
17+
La advertencia de obsolescencia de las propiedades dinámicas puede ser abordada:
2018

2119
<simplelist>
22-
<member>Declaring the property (preferred).</member>
20+
<member>Declarando la propiedad (preferible).</member>
2321
<member>
24-
Adding the <code>#[\AllowDynamicProperties]</code> attribute to the class
25-
(which also applies to all child classes).
22+
Añadiendo el atributo <code>#[\AllowDynamicProperties]</code> a la clase
23+
(que se aplica también a todas las clases hijas).
2624
</member>
2725
<member>
28-
Using a <classname>WeakMap</classname> if additional data needs to be
29-
associated with an object which one does not own.
26+
Utilizando un <classname>WeakMap</classname> si se deben asociar datos adicionales a un objeto del cual no se es propietario.
3027
</member>
3128
</simplelist>
3229
</para>
3330
</sect3>
3431

3532
<sect3 xml:id="migration82.deprecated.core.relative-callables">
36-
<title>Relative callables</title>
33+
<title>Callables relativos</title>
3734

3835
<para>
39-
Callables that are not accepted by the <code>$callable()</code> syntax
40-
(but are accepted by <function>call_user_func</function>) are deprecated.
36+
Los callables que no son aceptados por la sintaxis <code>$callable()</code>
37+
(pero que son aceptados por <function>call_user_func</function>) son obsoletos.
4138

42-
In particular:
39+
En particular:
4340
<simplelist>
4441
<member><code>"self::method"</code></member>
4542
<member><code>"parent::method"</code></member>
@@ -51,20 +48,20 @@
5148
<member><code>[new Foo, "Bar::method"]</code></member>
5249
</simplelist>
5350

54-
This does not affect normal method callables such as
55-
<code>"A::method"</code> or <code>["A", "method"]</code>.
51+
Esto no afecta a los callables de método normales como
52+
<code>"A::method"</code> o <code>["A", "method"]</code>.
5653
</para>
5754
<!-- RFC: https://wiki.php.net/rfc/deprecate_partially_supported_callables -->
5855
<!-- RFC: https://wiki.php.net/rfc/partially-supported-callables-expand-deprecation-notices -->
5956
</sect3>
6057

6158
<sect3 xml:id="migration82.deprecated.core.dollar-brace-interpolation">
62-
<title><code>"${var}"</code> and <code>"${expr}"</code> style interpolation</title>
59+
<title>Interpolación de estilo <code>"${var}"</code> y <code>"${expr}"</code>.</title>
6360

6461
<para>
65-
The <code>"${var}"</code> and <code>"${expr}"</code> style of string
66-
interpolation is deprecated.
67-
Use <code>"$var"/"{$var}"</code> and <code>"{${expr}}"</code>, respectively.
62+
Los estilos de interpolación de cadena <code>"${var}"</code> y <code>"${expr}"</code>
63+
son obsoletos.
64+
Utilice respectivamente <code>"$var"/"{$var}"</code> y <code>"{${expr}}"</code>.
6865
<!-- RFC: https://wiki.php.net/rfc/deprecate_dollar_brace_string_interpolation -->
6966
</para>
7067
</sect3>
@@ -75,16 +72,16 @@
7572
<title>MBString</title>
7673

7774
<para>
78-
Usage of the <literal>QPrint</literal>, <literal>Base64</literal>,
79-
<literal>Uuencode</literal>, and <literal>HTML-ENTITIES</literal>
80-
'text encodings' is deprecated for all MBString functions.
81-
82-
Unlike all the other text encodings supported by MBString,
83-
these do not encode a sequence of Unicode codepoints, but rather a sequence of raw bytes.
84-
It is not clear what the correct return values for most MBString functions
85-
should be when one of these non-encodings is specified.
86-
Moreover, PHP has separate, built-in implementations of all of them;
87-
for example, UUencoded data can be handled using
75+
El uso de los formatos <literal>QPrint</literal>, <literal>Base64</literal>,
76+
<literal>Uuencode</literal> y <literal>HTML-ENTITIES</literal>
77+
es obsoleto para todas las funciones MBString.
78+
79+
A diferencia de todos los otros encodings de texto soportados por MBString,
80+
estos no codifican una secuencia de puntos de código Unicode, sino más bien una secuencia de bytes en bruto.
81+
Los valores de retorno de la mayoría de las funciones MBString no son claros
82+
cuando se especifica uno de estos no-encodings.
83+
Además, PHP tiene implementaciones distintas para cada uno de ellos;
84+
por ejemplo, los datos UUencoded pueden ser manejados utilizando
8885
<function>convert_uuencode</function>/<function>convert_uudecode</function>.
8986
</para>
9087
</sect2>
@@ -93,17 +90,17 @@
9390
<title>SPL</title>
9491

9592
<para>
96-
The internal <methodname>SplFileInfo::_bad_state_ex</methodname> method
97-
has been deprecated.
93+
El método interno <methodname>SplFileInfo::_bad_state_ex</methodname>
94+
ha sido declarado obsoleto.
9895
</para>
9996
</sect2>
10097

10198
<sect2 xml:id="migration82.deprecated.standard">
10299
<title>Standard</title>
103100

104101
<para>
105-
<function>utf8_encode</function> and <function>utf8_decode</function>
106-
have been deprecated.
102+
<function>utf8_encode</function> y <function>utf8_decode</function>
103+
han sido declaradas obsoletas.
107104
</para>
108105
</sect2>
109106

reference/cubrid/cubridmysql/cubrid-fetch-array.xml

+56-42
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,14 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: d345f907bb0e43530c8280e556746263e5c97f4b Maintainer: seros Status: ready -->
3+
<!-- EN-Revision: 4754397753fd79f1c846868b66a2448babab1c54 Maintainer: PhilDaiguille Status: ready -->
4+
<!-- Reviewed: no -->
45

56
<refentry xml:id="function.cubrid-fetch-array" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
67
<refnamediv>
78
<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>
910
</refnamediv>
10-
11+
1112
<refsect1 role="description">
1213
&reftitle.description;
1314
<methodsynopsis>
@@ -16,96 +17,109 @@
1617
<methodparam choice="opt"><type>int</type><parameter>type</parameter><initializer>CUBRID_BOTH</initializer></methodparam>
1718
</methodsynopsis>
1819
<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.
2224
</para>
2325
</refsect1>
24-
26+
2527
<refsect1 role="parameters">
2628
&reftitle.parameters;
2729
<para>
2830
<variablelist>
2931
<varlistentry>
3032
<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>
3235
</varlistentry>
3336
<varlistentry>
3437
<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>
3741
</varlistentry>
3842
</variablelist>
3943
</para>
4044
</refsect1>
41-
45+
4246
<refsect1 role="returnvalues">
4347
&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>
4760
<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>
5265
</refsect1>
53-
66+
5467
<refsect1 role="examples">
5568
&reftitle.examples;
5669
<example>
57-
<title>Ejemplo de <function>cubrid_fetch_array</function></title>
70+
<title>Ejemplo con <function>cubrid_fetch_array</function></title>
5871
<programlisting role="php">
5972
<![CDATA[
6073
<?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");
6376
6477
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]);
6780
}
6881
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)
7084
71-
cubrid_close_request($solicitud);
85+
cubrid_close_request($req);
7286
73-
cubrid_disconnect($conexión);
87+
cubrid_disconnect($conn);
7488
?>
7589
]]>
7690
</programlisting>
7791
&example.outputs;
7892
<screen>
7993
<![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
86100
Markopoulo Olympic Equestrian Centre 64000.00 15000 Markopoulo, Athens, Greece
87101
Faliro Coastal Zone Olympic Complex 34650.00 12171 Faliro, Athens, Greece
88102
Athens Olympic Stadium 120400.00 71030 Maroussi, Athens, Greece
89103
Ano Liossia 34000.00 12000 Ano Liosia, Athens, Greece
90104
]]>
91105
</screen>
92-
106+
93107
</example>
94108
</refsect1>
95-
109+
96110
<refsect1 role="seealso">
97111
&reftitle.seealso;
98112
<para>
99113
<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>
105119
</simplelist>
106120
</para>
107-
</refsect1>
108-
121+
</refsect1>
122+
109123
</refentry>
110124

111125
<!-- Keep this comment at the end of the file

0 commit comments

Comments
 (0)