1
0
mirror of https://github.com/php/doc-es.git synced 2026-03-25 16:02:13 +01:00
Files
archived-doc-es/language/control-structures/return.xml
Pedro Antonio Gil Rodríguez 5eed26a161 Actualización a la última versión
git-svn-id: https://svn.php.net/repository/phpdoc/es/trunk@338594 c90b9560-bf6c-de11-be94-00142212c4b1
2016-02-12 09:53:22 +00:00

89 lines
3.5 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 576a10ee84e578a46ebd78da88ce951482ea657b Maintainer: seros Status: ready -->
<!-- Reviewed: no Maintainer: andresdzphp -->
<sect1 xml:id="function.return" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>return</title>
<?phpdoc print-version-for="return"?>
<simpara>
<literal>return</literal> devuelve el control del programa al módulo que lo invoca.
La ejecución vuelve a la siguiente expresión después del módulo que lo invoca.
</simpara>
<simpara>
Si se llama desde una función, la sentencia <literal>return</literal>
inmediatamente termina la ejecución de la función actual, y
devuelve su argumento como el valor de la llamada a la
función. <literal>return</literal> también termina la ejecución de
una sentencia <function>eval</function> o un archivo de script.
</simpara>
<simpara>
Si se llama desde el ámbito global, entonces la ejecución del script
actual se termina. Si el archivo script actual fue incluido o requerido con
<function>include</function> o <function>require</function>,
entonces el control es pasado de regreso al archivo que hizo el llamado. Además, si
el archivo script actual fue incluido con <function>include</function>, entonces
el valor dado a <literal>return</literal> será retornado como
el valor de la llamada <function>include</function>. Si
<literal>return</literal> es llamado desde dentro del fichero del script
principal, entonces termina la ejecución del script. Si el archivo script actual fue
nombrado por las opciones de configuración <link
linkend="ini.auto-prepend-file">auto_prepend_file</link> o <link
linkend="ini.auto-append-file">auto_append_file</link>
en &php.ini;, entonces se
termina la ejecución de ese archivo script.
</simpara>
<simpara>Para más información, ver <link
linkend="functions.returning-values">Retornando valores</link>.
</simpara>
<para>
<note>
<simpara>
Cabe señalar que dado que <literal>return</literal> es un constructor
del lenguaje y no una función, los paréntesis que rodean su
argumentos no son necesarios. Es común no utilizarlos, y
en realidad se debería hacer así a fin de que PHP tenga menos trabajo que hacer en este caso.
</simpara>
</note>
<note>
<simpara>
Si no se suministra un parámetro, entonces el paréntesis debe omitirse
y &null; será
retornado. Llamadas a <literal>return</literal> con paréntesis pero
sin argumentos resultarán en un error del intérprete.
</simpara>
</note>
<note>
<simpara>
<emphasis>Nunca</emphasis> se deben usar paréntesis al rededor de la variable
de retorno cuando se retorna por referencia, ya que esto no funcionará. Sólo se pueden
retornar variables por referencia, no el resultado de una sentencia. Si se
utiliza <literal>return ($a);</literal> entonces no se está retornando una
variable, sino el resultado de la expresión <literal>($a)</literal>
(el cual es, por supuesto, el valor de <varname>$a</varname>).
</simpara>
</note>
</para>
</sect1>
<!-- 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
-->