1
0
mirror of https://github.com/php/doc-es.git synced 2026-03-24 15:32:36 +01:00
Files
archived-doc-es/reference/array/functions/array-replace.xml
Pedro Antonio Gil Rodríguez 3ae21f6ce7 Actualización a la últma versión
git-svn-id: https://svn.php.net/repository/phpdoc/es/trunk@333773 c90b9560-bf6c-de11-be94-00142212c4b1
2014-06-13 09:51:04 +00:00

135 lines
3.8 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bfee3967e880f7951b1d68f2c9948715d573b3e7 Maintainer: seros Status: ready -->
<!-- Reviewed: yes Maintainer: seros -->
<refentry xml:id="function.array-replace" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>array_replace</refname>
<refpurpose>Reemplaza los elementos de los arrays pasados en el primer array</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>array</type><methodname>array_replace</methodname>
<methodparam><type>array</type><parameter>array1</parameter></methodparam>
<methodparam><type>array</type><parameter>array2</parameter></methodparam>
<methodparam choice="opt"><type>array</type><parameter>...</parameter></methodparam>
</methodsynopsis>
<para>
<function>array_replace</function> reemplaza los valores de
<parameter>array1</parameter> con valores que tienen las mismas claves en cada uno de los siguientes
arrays. Si la clave del primer array existe en el segundo array, su valor
será reemplazado por el valor del segundo array. Si la clave existe en el
segundo array y no en el primero, será creada en el primer array.
Si la clave sólo existe en el primer array, se dejará como está.
Si se proporcionan varios arrays para el reemplazo, se procederá
en orden, los arrays posteriores sobrescribirán los valores anteriores.
</para>
<para>
<function>array_replace</function> no es recursivo: reemplazará
valores en el primer array por el tipo que esté en el segundo array.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>array1</parameter></term>
<listitem>
<para>
El array cuyos elementos son reemplazados.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>array2</parameter></term>
<listitem>
<para>
El array del cual se extraerán los elementos.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>...</parameter></term>
<listitem>
<para>
Más arrays de los que se extraerán los elementos.
Los valores de arrays posteriores sobrescriben los valores anteriores.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve un <type>array</type>, o &null; en caso de error.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>array_replace</function></title>
<programlisting role="php">
<![CDATA[
<?php
$base = array("naranja", "plátano", "manzana", "frambuesa");
$reemplazos = array(0 => "piña", 4 => "cereza");
$reemplazos2 = array(0 => "uva");
$cesta = array_replace($base, $reemplazos, $reemplazos2);
print_r($cesta);
?>
]]>
</programlisting>
&example.outputs;
<screen role="php">
<![CDATA[
Array
(
[0] => uva
[1] => plátano
[2] => manzana
[3] => frambuesa
[4] => cereza
)
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>array_replace_recursive</function></member>
<member><function>array_merge</function></member>
</simplelist>
</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
-->