-
Notifications
You must be signed in to change notification settings - Fork 50
/
iterator-to-array.xml
167 lines (160 loc) · 4.32 KB
/
iterator-to-array.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b8758b0605e80c4e3610137b7502a6abeea5c69b Maintainer: seros Status: ready -->
<!-- Reviewed: yes Maintainer: seros -->
<refentry xml:id="function.iterator-to-array" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>iterator_to_array</refname>
<refpurpose>Copiar el iterador a un array</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>array</type><methodname>iterator_to_array</methodname>
<methodparam><type>Traversable</type><parameter>iterator</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>use_keys</parameter><initializer>&true;</initializer></methodparam>
</methodsynopsis>
<para>
Copia los elementos de un iterador a un array.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>iterator</parameter></term>
<listitem>
<para>
El iterador a copiar.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>use_keys</parameter></term>
<listitem>
<para>
Si usar las claves del elemento iterador como índice.
</para>
<para>
En PHP 5.5 y posterior, si una clave es un <type>array</type> u
<type>object</type>, se generará una advertencia. Las claves &null; serán
convertidas a un string vacío, las claves <type>float</type> serán
truncadas a su equivalente <type>integer</type>,
las claves <type>resource</type> generarán una advertencia y serán convertidas a
sus ID de recurso, y las claves <type>boolean</type> serán convertidas a
enteros.
</para>
<note>
<para>
Si no se establece este parámetro o se establece a &true;, las claves duplicadas serán
sobrescritas. El último valor con una clave dada estará en el <type>array</type>
devuelto. Para obtener todos los valores en cualquier caso, se ha de establecer
este parámetro a &false;.
</para>
</note>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Un <type>array</type> que contiene los elementos del <parameter>iterator</parameter>.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>5.5.0</entry>
<entry>
<function>iterator_to_array</function> da soporte a tipos de claves
diferentes a <type>integer</type> y <type>string</type> cuando el
parámetro <parameter>use_keys</parameter> está habilitado.
</entry>
</row>
<row>
<entry>5.2.1</entry>
<entry>
Añadido el parámetro <parameter>use_keys</parameter>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>iterator_to_array</function></title>
<programlisting role="php">
<![CDATA[
<?php
$iterator = new ArrayIterator(array('recipe'=>'panqueques', 'huevo', 'leche', 'harina'));
var_dump(iterator_to_array($iterator, true));
var_dump(iterator_to_array($iterator, false));
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
array(4) {
["recipe"]=>
string(10) "panqueques"
[0]=>
string(5) "huevo"
[1]=>
string(5) "leche"
[2]=>
string(6) "harina"
}
array(4) {
[0]=>
string(10) "panqueques"
[1]=>
string(5) "huevo"
[2]=>
string(5) "leche"
[3]=>
string(6) "harina"
}
]]>
</screen>
</example>
</para>
</refsect1>
</refentry>
<!-- 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
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->