-
Notifications
You must be signed in to change notification settings - Fork 40
/
define.xml
233 lines (223 loc) · 6.32 KB
/
define.xml
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
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: cdc9d28d334bbc08386fecf8aade66080004a9dd Maintainer: sammywg Status: ready -->
<!-- Reviewed: yes -->
<!-- Rev-Revision c44475e1fafcbee203ed4935a6d5d7a01379fcdc Reviewer: samesch -->
<refentry xml:id="function.define" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>define</refname>
<refpurpose>Definiert eine benannte Konstante</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>define</methodname>
<methodparam><type>string</type><parameter>constant_name</parameter></methodparam>
<methodparam><type>mixed</type><parameter>value</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>case_insensitive</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<para>
Definiert während der Laufzeit eine benannte Konstante.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>constant_name</parameter></term>
<listitem>
<para>
Der Name der Konstante.
</para>
<note>
<para>
Es ist möglich, Konstanten mit reservierten oder gar ungültigen Namen
mittels <function>define</function> zu definieren, deren Wert (nur)
mittels <function>constant</function> gelesen werden kann. Allerdings
wird dies nicht empfohlen.
</para>
</note>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>value</parameter></term>
<listitem>
<para>
Der Wert der Konstante. In PHP 5 muss <parameter>value</parameter> ein
<type>scalar</type>er Wert (<type>int</type>, <type>float</type>,
<type>string</type>, <type>bool</type>, oder &null;) sein. In PHP 7
werden auch <type>Array</type>-Werte akzeptiert.
</para>
<warning>
<para>
Obgleich es möglich ist, Konstanten vom Typ <type>&resource;</type> zu
definieren, wird dies nicht empfohlen, da es ein unvorhersagbares
Verhalten des Programms zur Folge haben kann.
</para>
</warning>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>case_insensitive</parameter></term>
<listitem>
<para>
Falls auf &true; gesetzt, wird bei der Konstante nicht zwischen Groß-
und Kleinschreibung unterschieden. In der Voreinstellung wird
dazwischen unterschieden, &dh; <literal>KONSTANTE</literal> und
<literal>Konstante</literal> repräsentieren unterschiedliche Werte.
</para>
<warning>
<simpara>
Das Definieren von Konstanten, die nicht zwischen Groß- und
Kleinschreibung unterscheiden, wird von PHP 7.3.0 an missbilligt.
Seit PHP 8.0.0 ist nur &false; ein zulässiger Wert; die Übergabe von
&true; erzeugt eine Warnung.
</simpara>
</warning>
<note>
<para>
Groß-/Kleinschreibungsunabhängige Konstanten werden kleingeschrieben
gespeichert.
</para>
</note>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Die Übergabe von &true; an <parameter>case_insensitive</parameter>
gibt nun einen Fehler der Stufe <constant>E_WARNING</constant> aus;
die Übergabe von &false; ist weiterhin erlaubt.
</entry>
</row>
<row>
<entry>7.3.0</entry>
<entry>
<parameter>case_insensitive</parameter> ist missbilligt und wird in
Version 8.0.0 entfernt.
</entry>
</row>
<row>
<entry>7.0.0</entry>
<entry>
<type>Array</type>-Werte sind erlaubt.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Konstanten definieren</title>
<programlisting role="php">
<![CDATA[
<?php
define("KONSTANTE", "Hallo Welt.");
echo KONSTANTE; // gibt "Hallo Welt." aus
echo Konstante; // gibt "Konstante" aus und erzeugt eine Warnung
define("BEGRUESSUNG", "Hallo Du.", true);
echo BEGRUESSUNG; // gibt "Hallo Du." aus
echo Begruessung; // gibt "Hallo Du." aus
// Funktioniert ab PHP 7
define('ANIMALS', array(
'Hund',
'Katze',
'Maus'
));
echo ANIMALS[1]; // gibt "Katze" aus
?>
]]>
</programlisting>
</example>
</para>
<para>
<example>
<title>Konstanten mit reservierten Namen</title>
<para>
Dieses Beispiel verdeutlich die <emphasis>Möglichkeit</emphasis>, eine
Konstante mit dem selben Namen wie eine
<link linkend="language.constants.predefined">magische Konstante</link>
zu definieren. Da das resultierende Verhalten offensichtlich verwirrend
ist, ist es nicht empfehlenswert, dies in der Praxis zu tun.
</para>
<programlisting role="php">
<![CDATA[
<?php
var_dump(defined('__LINE__'));
var_dump(define('__LINE__', 'test'));
var_dump(constant('__LINE__'));
var_dump(__LINE__);
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
bool(false)
bool(true)
string(4) "test"
int(5)
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>defined</function></member>
<member><function>constant</function></member>
<member>
Das Kapitel über <link linkend="language.constants">Konstanten</link>
</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
-->