File: constants.xml

package info (click to toggle)
phpdoc 20020310-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 35,272 kB
  • ctags: 354
  • sloc: xml: 799,767; php: 1,395; cpp: 500; makefile: 200; sh: 140; awk: 51
file content (198 lines) | stat: -rw-r--r-- 5,309 bytes parent folder | download
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
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
<?xml version="1.0" encoding="iso-8859-1"?>
 <chapter id="language.constants">
  <title>Constantes</title>

  <simpara>
   O PHP define vrias constantes e fornece um mecanismo para definir outras mais
   em tempo de execuo. Constantes so bem parecidos com variveis, exceto pelos fatos
   de que constantes precisam ser definidas usando a funo
   <function>define</function>, e que elas no podem ser redefinidas para outro valor,
   mais tarde.
  </simpara>

  <para>
   As constantes pr-definidas (sempre disponveis) so:

   <variablelist>

    <varlistentry>
     <term>__FILE__</term>
     <listitem>
      <simpara>
       O nome do arquivo de script que est sendo analisado atualmente. Se for usado
       dentro de um arquivo que foi includo ou requerido, ento o nome do arquivo 
       includo  dado, e no o nome do arquivo pai.
      </simpara>
     </listitem>
    </varlistentry>
    
    <varlistentry>
     <term>__LINE__</term>
     <listitem>
      <simpara>
       O nmero da linha dentro do arquivo de script corrente que est sendo analisado.
       Se for usado dentro de um arquivo que foi includo ou requerido, ento  dada a posio
       dentro do arquivo de incluso.
      </simpara>
     </listitem>
    </varlistentry>
    
    <varlistentry>
     <term>PHP_VERSION</term>
     <listitem>
      <simpara>
       A representao de string da verso do analisador PHP atualmente em uso;
       por exemplo '3.0.8-dev'.
      </simpara>
     </listitem>
    </varlistentry>
    
    <varlistentry>
     <term>PHP_OS</term>
     <listitem>
      <simpara>
       O nome do sistema operacional no qual o analisador PHP est sendo executado;
       por exemplo 'Linux'.
      </simpara>
     </listitem>
    </varlistentry>
    
    <varlistentry>
     <term>&true;</term>
     <listitem>
      <simpara>
       Um valor verdadeiro.
      </simpara>
     </listitem>
    </varlistentry>
    
    <varlistentry>
     <term>&false;</term>
     <listitem>
      <simpara>
       Um valor falso.
      </simpara>
     </listitem>
    </varlistentry>
    
    <varlistentry>
     <term>E_ERROR</term>
     <listitem>
      <simpara>
       Denota um erro diferente de um erro de anlise, no qual a recuperao no  
       possvel. 
      </simpara>
     </listitem>
    </varlistentry>
    
    <varlistentry>
     <term>E_WARNING</term>
     <listitem>
      <simpara>
       Denota uma condio onde o PHP sabe que algo est errado, mas seguir assim
       mesmo; isto pode ser percebido pelo prprio script. Um exemplo seria
       uma expresso regular invlida em <function>ereg</function>.
      </simpara>
     </listitem>
    </varlistentry>
    
    <varlistentry>
     <term>E_PARSE</term>
     <listitem>
      <simpara>
       O analisador verificou uma  sintaxe invlida no arquivo de script.
       A recuperao no  possvel.
      </simpara>
     </listitem>
    </varlistentry>
    
    <varlistentry>
     <term>E_NOTICE</term>
     <listitem>
      <simpara>
       Aconteceu algo que pode ou no ser um erro. A execuo continua. Os exemplos
       incluem o uso de uma string sem aspas como ndice de 'hashing', ou o acesso
       a uma varivel que no foi setada.
      </simpara>
     </listitem>
    </varlistentry>
    
    <varlistentry>
     <term>E_NOTICE</term>
     <listitem>
      <simpara>
       Aconteceu algo que pode ou no ser um erro. A execuo continua. Os exemplos
       incluem o uso de uma string sem aspas como ndice de 'hashing', ou o acesso
       a uma varivel que no foi setada.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>E_ALL</term>
     <listitem>
      <simpara>
       Todas as constantes  E_* reunidas em uma. Se for usado com
       <function>error_reporting</function>, far com que todo e qualquer
       problema notificado pelo PHP seja relatado.
      </simpara>
     </listitem>
    </varlistentry>

   </variablelist>
  </para>

   <para>
	As constantes E_* so usadas tipicamente com a funo
	<function>error_reporting</function> para configurar o nvel de 
	reportagem de erros.</para>

   <para>
    Voc pode definir constantes adicionais usando a funo <function>define</function>.</para>
	
   <para>
	Note que estas so constantes, e no macros com estilo C; somente
	dados escalares vlidos podem ser representados por uma constante.

    <example>
     <title>Definindo Constantes</title>
     <programlisting>
&lt;?php
define("CONSTANT", "Al mundo.");
echo CONSTANT; // imprime "Al mundo."
?&gt;
     </programlisting>
    </example>

    <example>
     <title>Usando __FILE__ e __LINE__</title>
     <programlisting>
&lt;?php
function report_error($file, $line, $message) {
    echo "Ocorreu um erro em $file na linha $line: $message.";
}

report_error(__FILE__,__LINE__, "Algo deu errado!");
?&gt;
     </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
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:
 -->