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
+-->
