cvs: phpdoc-es /language constants.xml
| From: | Rafael Martinez | Date: | Sun, 02 Jun 2002 20:17:03 +0000 |
| Subject: | cvs: phpdoc-es /language constants.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969346150@lists.php.net to get a copy of this message | ||
rafael Sun Jun 2 16:17:03 2002 EDT
Modified files:
/phpdoc-es/language constants.xml
Log:
Translation updated to PHP 4.x
Index: phpdoc-es/language/constants.xml diff -u phpdoc-es/language/constants.xml:1.5 phpdoc-es/language/constants.xml:1.6 --- phpdoc-es/language/constants.xml:1.5 Wed Dec 12 15:48:35 2001 +++ phpdoc-es/language/constants.xml Sun Jun 2 16:17:01 2002 @@ -1,177 +1,162 @@ <?xml version="1.0" encoding="iso-8859-1"?> - <chapter id="language.constants"> - <title>Constantes</title> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.25 Maintainer: oswaldo Status: ready --> + <chapter id="language.constants"> + <title>Constantes</title> + + <simpara> + Una constante es un identificador para expresar un valor simple. + Como el nombre sugiere, este valor no puede variar durante la ejecución del script. + (Las constantes especiales <constant>__FILE__</constant> y <constant> __LINE__</constant> + son una excepción a esto, ya que actualmente no lo soin). Una constante es sensible a mayúsculas por + defecto. Por convención, los identificadores de constantes suelen declararse en mayúsculas + + </simpara> + <para> + El nombre de una constante sigue las mismas reglas que cualquier etiqueta en PHP. + Un nombre de constante válido empieza con una letra o un caracter de subrayado, seguido + por cualquier número de letras, números, o subrayados. + Se podrían expresar mediante la siguiente expresión regular: + <literal>[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*</literal> - <simpara> - PHP define varias constantes y proporciona un mecanismo para - definir más en tiempo de ejecución. Las constantes son como las variables, - salvo por las dos circunstancias de que las constantes deben ser definidas - usando la función <function>define</function>, y que no pueden ser - redefinidas más tarde con otro valor.</simpara> - - <para> - Las constantes predefinidas (siempre disponibles) son: + <!-- TODO: Example of valid & invalid constant names --> + </para> - <variablelist> + <note> + <simpara> + Para nuestros propósitos , entenderemos como letra los carácteres + a-z, A-Z, y los ASCII del 127 hasta el 255 (0x7f-0xff). + </simpara> + </note> + + <simpara> + El alcanze de una constante es global, Es decir, es posible acceder a ellas + sin preocuparse por el ámbito de alcance. + </simpara> - <varlistentry> - <term>__FILE__</term> - <listitem> - <simpara> - El nombre del archivo de comandos que está siendo interpretado - actualmente. Si se usa dentro de un archivo que ha sido incluido - o requerido, entonces se da el nombre del archivo incluido, y - no el nombre del archivo padre. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>__LINE__</term> - <listitem> - <simpara> - El número de línea dentro del archivo que está siendo - interpretado en la actualidad. Si se usa dentro de un - archivo incluido o requerido, entonces se da la posición - dentro del archivo incluido. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>PHP_VERSION</term> - <listitem> - <simpara> - La cadena que representa la versión del analizador de PHP - en uso en la actualidad; e.g. '3.0.8-dev'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>PHP_OS</term> - <listitem> - <simpara> - El nombre del sistema operativo en el cuál se ejecuta el - analizador PHP; e.g. 'Linux'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>&true;</term> - <listitem> - <simpara> - Valor verdadero. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>&false;</term> - <listitem> - <simpara> - Valor falso. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>E_ERROR</term> - <listitem> - <simpara> - Denota un error distinto de un error de interpretación - del cual no es posible recuperarse. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>E_WARNING</term> - <listitem> - <simpara> - Denota una condición donde PHP reconoce que hay algo erróneo, - pero continuará de todas formas; pueden ser capturados por - el propio archivo de comandos. Un ejemplo sería una inválida - regexp en <function>ereg</function>. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>E_PARSE</term> - <listitem> - <simpara> - El interprete encontró sintaxis inválida en el archivo - de comandos. La recuperación no es posible. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>E_NOTICE</term> - <listitem> - <simpara> - Ocurrió algo que pudo ser o no un error. La ejecución continúa. - Los ejemplos incluyen usar una cadena sin comillas como un - índice "hash", o acceder a una variable que no ha sido inicializada. - </simpara> - </listitem> - </varlistentry> - </variablelist></para> + <sect1 id="language.constants.syntax"> + <title>Sintaxis</title> + <simpara> + Se puede definir una constante usando la función + <function>define</function>. Una vez definida, no puede ser modificada + ni eliminada . + </simpara> + <simpara> + Solo se puede definir como constantes valores escalares (<type>boolean</type>, <type>integer</type>, <type>float </type> + y <type>string<type> ). + </simpara> + <simpara> + Para obtener el valor de una constante solo es necesario especificar su nombre. + A diferencia de las variables, <emphasis>no</emphasis> se tiene que especificar el prefijo + <literal>$</literal>. + + + Tambien se puede utilizar la función <function>constant</function>, para obtener el valor de una constante, + en el caso de que queramos expresarla de forma dinámica + + Usa la función <function>get_defined_constants</function> parar obtener una lista de todas + las constantes definidas. + + </simpara> + <note> + <simpara> + Las contantes y las variables (globales) se encuentran en un espacio de nombres + distinto. Esto implica que por ejemplo &true; y <varname>$TRUE</varname> son diferentes. + </simpara> + </note> + <simpara> + Si usas una constante todavia no definida, PHP asume que estás refiriéndote + al nombre de la constante en si. Se lanzará un <link linkend="features.error-handling">aviso</link> si esto sucede. + Usa la función <function>defined</function> para comprobar la existencia de dicha constante. + </simpara> <para> - Las constantes E_* se usan típicamente con la función - <function>error_reporting</function> para configurar el nivel - de informes de error.</para> + Estas son las diferencias entre constantes y variables: - <para> - Se pueden definir constantes adicionales usando la - función <function>define</function>.</para> - - <para> - Nótese que son constantes, no macros tipo C; con una constante - sólo se pueden representar datos escalares válidos. + <itemizedlist> + <listitem> + <simpara> + Las constantes no son precedidas por un símbolo de dolar (<literal>$</literal>) + </simpara> + </listitem> + <listitem> + <simpara> + Las contantes solo pueden ser definidas usando la <function>función</function> define , nunca por simple asignación + + </simpara> + </listitem> + <listitem> + <simpara> + Las constantes pueden ser definidas y accedidas sin tener en cuenta las reglas de alcanze del ámbito. + </simpara> + </listitem> + <listitem> + <simpara> + Las constantes no pueden ser redefinidas o eliminadas despues de establecerse; y + </simpara> + </listitem> + <listitem> + <simpara> + Las constantes solo puede albergar valores escalares + </simpara> + </listitem> + </itemizedlist> + </para> + <para> <example> - <title>Definiendo Constantes</title> - <programlisting> -<?php -define("CONSTANTE", "Hola mundo."); -echo CONSTANTE; // muestra "Hola mundo." -?> + <title>Definiendo constantes</title> + <programlisting role="php"> +<![CDATA[ +<?php +define("CONSTANT", "Hello world."); +echo CONSTANT; // outputs "Hello world." +echo Constant; // outputs "Constant" and issues a notice. +?> +]]> </programlisting> </example> - <example> - <title>Usando __FILE__ y __LINE__</title> - <programlisting> -<?php -function report_error($file, $line, $message) { - echo "Un error occurrió en $file en la línea $line: $message."; -} + </para> + </sect1> -report_error(__FILE__,__LINE__, "Algo fue mal!"); -?> - </programlisting> - </example></para> - - </chapter> - - <!-- 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 + <sect1 id="language.constants.predefined"> + <title>Constantes predefinidas</title> + + <simpara> + PHP ofrece un largo número de constantes predefinidas a cualquier script + en ejecución. Muchas de estas constantes, sin embargo, son creadas por diferentes + extensiones, y solo estarán presentes si dichas extensiones están disponibles, bien por carga + dinámica o porque has sido compiladas. + + </simpara> + + <simpara> + Se puede encontrar una lista de constantes predefinidas en la seccion <link + linkend="reserved.constants">Constantes predefinidas</link>. + </simpara> + + + </sect1> + </chapter> + +<!-- 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:"../manual.ced" - sgml-exposed-tags:nil - sgml-local-catalogs:nil - sgml-local-ecat-files:nil - End: - --> +sgml-parent-document:nil +sgml-default-dtd-file:"../../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 +-->
Index: phpdoc-es/language/constants.xml diff -u phpdoc-es/language/constants.xml:1.5 phpdoc-es/language/constants.xml:1.6 --- phpdoc-es/language/constants.xml:1.5 Wed Dec 12 15:48:35 2001 +++ phpdoc-es/language/constants.xml Sun Jun 2 16:17:01 2002 @@ -1,177 +1,162 @@ <?xml version="1.0" encoding="iso-8859-1"?> - <chapter id="language.constants"> - <title>Constantes</title> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.25 Maintainer: oswaldo Status: ready --> + <chapter id="language.constants"> + <title>Constantes</title> + + <simpara> + Una constante es un identificador para expresar un valor simple. + Como el nombre sugiere, este valor no puede variar durante la ejecución del script. + (Las constantes especiales <constant>__FILE__</constant> y <constant> __LINE__</constant> + son una excepción a esto, ya que actualmente no lo soin). Una constante es sensible a mayúsculas por + defecto. Por convención, los identificadores de constantes suelen declararse en mayúsculas + + </simpara> + <para> + El nombre de una constante sigue las mismas reglas que cualquier etiqueta en PHP. + Un nombre de constante válido empieza con una letra o un caracter de subrayado, seguido + por cualquier número de letras, números, o subrayados. + Se podrían expresar mediante la siguiente expresión regular: + <literal>[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*</literal> - <simpara> - PHP define varias constantes y proporciona un mecanismo para - definir más en tiempo de ejecución. Las constantes son como las variables, - salvo por las dos circunstancias de que las constantes deben ser definidas - usando la función <function>define</function>, y que no pueden ser - redefinidas más tarde con otro valor.</simpara> - - <para> - Las constantes predefinidas (siempre disponibles) son: + <!-- TODO: Example of valid & invalid constant names --> + </para> - <variablelist> + <note> + <simpara> + Para nuestros propósitos , entenderemos como letra los carácteres + a-z, A-Z, y los ASCII del 127 hasta el 255 (0x7f-0xff). + </simpara> + </note> + + <simpara> + El alcanze de una constante es global, Es decir, es posible acceder a ellas + sin preocuparse por el ámbito de alcance. + </simpara> - <varlistentry> - <term>__FILE__</term> - <listitem> - <simpara> - El nombre del archivo de comandos que está siendo interpretado - actualmente. Si se usa dentro de un archivo que ha sido incluido - o requerido, entonces se da el nombre del archivo incluido, y - no el nombre del archivo padre. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>__LINE__</term> - <listitem> - <simpara> - El número de línea dentro del archivo que está siendo - interpretado en la actualidad. Si se usa dentro de un - archivo incluido o requerido, entonces se da la posición - dentro del archivo incluido. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>PHP_VERSION</term> - <listitem> - <simpara> - La cadena que representa la versión del analizador de PHP - en uso en la actualidad; e.g. '3.0.8-dev'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>PHP_OS</term> - <listitem> - <simpara> - El nombre del sistema operativo en el cuál se ejecuta el - analizador PHP; e.g. 'Linux'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>&true;</term> - <listitem> - <simpara> - Valor verdadero. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>&false;</term> - <listitem> - <simpara> - Valor falso. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>E_ERROR</term> - <listitem> - <simpara> - Denota un error distinto de un error de interpretación - del cual no es posible recuperarse. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>E_WARNING</term> - <listitem> - <simpara> - Denota una condición donde PHP reconoce que hay algo erróneo, - pero continuará de todas formas; pueden ser capturados por - el propio archivo de comandos. Un ejemplo sería una inválida - regexp en <function>ereg</function>. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>E_PARSE</term> - <listitem> - <simpara> - El interprete encontró sintaxis inválida en el archivo - de comandos. La recuperación no es posible. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>E_NOTICE</term> - <listitem> - <simpara> - Ocurrió algo que pudo ser o no un error. La ejecución continúa. - Los ejemplos incluyen usar una cadena sin comillas como un - índice "hash", o acceder a una variable que no ha sido inicializada. - </simpara> - </listitem> - </varlistentry> - </variablelist></para> + <sect1 id="language.constants.syntax"> + <title>Sintaxis</title> + <simpara> + Se puede definir una constante usando la función + <function>define</function>. Una vez definida, no puede ser modificada + ni eliminada . + </simpara> + <simpara> + Solo se puede definir como constantes valores escalares (<type>boolean</type>, <type>integer</type>, <type>float </type> + y <type>string<type> ). + </simpara> + <simpara> + Para obtener el valor de una constante solo es necesario especificar su nombre. + A diferencia de las variables, <emphasis>no</emphasis> se tiene que especificar el prefijo + <literal>$</literal>. + + + Tambien se puede utilizar la función <function>constant</function>, para obtener el valor de una constante, + en el caso de que queramos expresarla de forma dinámica + + Usa la función <function>get_defined_constants</function> parar obtener una lista de todas + las constantes definidas. + + </simpara> + <note> + <simpara> + Las contantes y las variables (globales) se encuentran en un espacio de nombres + distinto. Esto implica que por ejemplo &true; y <varname>$TRUE</varname> son diferentes. + </simpara> + </note> + <simpara> + Si usas una constante todavia no definida, PHP asume que estás refiriéndote + al nombre de la constante en si. Se lanzará un <link linkend="features.error-handling">aviso</link> si esto sucede. + Usa la función <function>defined</function> para comprobar la existencia de dicha constante. + </simpara> <para> - Las constantes E_* se usan típicamente con la función - <function>error_reporting</function> para configurar el nivel - de informes de error.</para> + Estas son las diferencias entre constantes y variables: - <para> - Se pueden definir constantes adicionales usando la - función <function>define</function>.</para> - - <para> - Nótese que son constantes, no macros tipo C; con una constante - sólo se pueden representar datos escalares válidos. + <itemizedlist> + <listitem> + <simpara> + Las constantes no son precedidas por un símbolo de dolar (<literal>$</literal>) + </simpara> + </listitem> + <listitem> + <simpara> + Las contantes solo pueden ser definidas usando la <function>función</function> define , nunca por simple asignación + + </simpara> + </listitem> + <listitem> + <simpara> + Las constantes pueden ser definidas y accedidas sin tener en cuenta las reglas de alcanze del ámbito. + </simpara> + </listitem> + <listitem> + <simpara> + Las constantes no pueden ser redefinidas o eliminadas despues de establecerse; y + </simpara> + </listitem> + <listitem> + <simpara> + Las constantes solo puede albergar valores escalares + </simpara> + </listitem> + </itemizedlist> + </para> + <para> <example> - <title>Definiendo Constantes</title> - <programlisting> -<?php -define("CONSTANTE", "Hola mundo."); -echo CONSTANTE; // muestra "Hola mundo." -?> + <title>Definiendo constantes</title> + <programlisting role="php"> +<![CDATA[ +<?php +define("CONSTANT", "Hello world."); +echo CONSTANT; // outputs "Hello world." +echo Constant; // outputs "Constant" and issues a notice. +?> +]]> </programlisting> </example> - <example> - <title>Usando __FILE__ y __LINE__</title> - <programlisting> -<?php -function report_error($file, $line, $message) { - echo "Un error occurrió en $file en la línea $line: $message."; -} + </para> + </sect1> -report_error(__FILE__,__LINE__, "Algo fue mal!"); -?> - </programlisting> - </example></para> - - </chapter> - - <!-- 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 + <sect1 id="language.constants.predefined"> + <title>Constantes predefinidas</title> + + <simpara> + PHP ofrece un largo número de constantes predefinidas a cualquier script + en ejecución. Muchas de estas constantes, sin embargo, son creadas por diferentes + extensiones, y solo estarán presentes si dichas extensiones están disponibles, bien por carga + dinámica o porque has sido compiladas. + + </simpara> + + <simpara> + Se puede encontrar una lista de constantes predefinidas en la seccion <link + linkend="reserved.constants">Constantes predefinidas</link>. + </simpara> + + + </sect1> + </chapter> + +<!-- 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:"../manual.ced" - sgml-exposed-tags:nil - sgml-local-catalogs:nil - sgml-local-ecat-files:nil - End: - --> +sgml-parent-document:nil +sgml-default-dtd-file:"../../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 +-->