function.array.html
12.1 KB
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
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Erstellt ein Array</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.array-walk.html">array_walk</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.arsort.html">arsort</a></div>
<div class="up"><a href="ref.array.html">Array Funktionen</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="function.array" class="refentry">
<div class="refnamediv">
<h1 class="refname">array</h1>
<p class="verinfo">(PHP 4, PHP 5)</p><p class="refpurpose"><span class="refname">array</span> — <span class="dc-title">Erstellt ein Array</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.array-description">
<h3 class="title">Beschreibung</h3>
<div class="methodsynopsis dc-description">
<span class="type">array</span> <span class="methodname"><strong>array</strong></span>
([ <span class="methodparam"><span class="type"><a href="language.pseudo-types.html#language.types.mixed" class="type mixed">mixed</a></span> <code class="parameter">$...</code></span>
] )</div>
<p class="para rdfs-comment">
Erstellt ein Array. Um mehr darüber zu erfahren, was ein Array
ist, lesen Sie den Abschnitt zum
<a href="language.types.array.html" class="link">Array-Typ</a>.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.array-parameters">
<h3 class="title">Parameter-Liste</h3>
<p class="para">
<dl>
<dt>
<code class="parameter">...</code></dt>
<dd>
<p class="para">
Die Syntax "Index => Werte", durch Kommas getrennt, definiert
Index und Werte. Index kann vom Typ String oder numerisch sein.
Wird der Index weggelassen, erstellt die Funktion automatisch
einen numerischen Index, der bei 0 beginnt. Ist der Index als
Integer-Wert angegeben, wird der nächste generierte Index der
größte Integer Index + 1. Beachten Sie, dass wenn zwei identische
Indexe definiert sind, der letzte den ersten überschreibt.
</p>
<p class="para">
Ein hinter dem letzten definierten Arrayeintrag angehängtes Komma
ist zwar unüblich, aber dennoch gültige Syntax.
</p>
</dd>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.array-returnvalues">
<h3 class="title">Rückgabewerte</h3>
<p class="para">
Gibt ein den Parametern entsprechendes Array zurück. Mit dem
<em>=></em> Operator können die Parameter indiziert werden.
Um mehr darüber zu erfahren, was ein Array ist, lesen Sie den
Abschnitt zum <a href="language.types.array.html" class="link">Array-Typ</a>.
</p>
</div>
<div class="refsect1 examples" id="refsect1-function.array-examples">
<h3 class="title">Beispiele</h3>
<p class="para">
Das folgende Beispiel zeigt wie man ein zweidimensionales Array
erstellt, wie man Schlüssel für assoziative Arrays festlegt, und
wie man numerische Indizes in normalen Arrays überspringt und
fortsetzt.
<div class="example" id="example-4957">
<p><strong>Beispiel #1 <span class="function"><strong>array()</strong></span>-Beispiel</strong></p>
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br />$fruits </span><span style="color: #007700">= array (<br /> </span><span style="color: #DD0000">"fruits" </span><span style="color: #007700">=> array(</span><span style="color: #DD0000">"a" </span><span style="color: #007700">=> </span><span style="color: #DD0000">"Orange"</span><span style="color: #007700">, </span><span style="color: #DD0000">"b" </span><span style="color: #007700">=> </span><span style="color: #DD0000">"Banane"</span><span style="color: #007700">, </span><span style="color: #DD0000">"c" </span><span style="color: #007700">=> </span><span style="color: #DD0000">"Apfel"</span><span style="color: #007700">),<br /> </span><span style="color: #DD0000">"numbers" </span><span style="color: #007700">=> array(</span><span style="color: #0000BB">1</span><span style="color: #007700">, </span><span style="color: #0000BB">2</span><span style="color: #007700">, </span><span style="color: #0000BB">3</span><span style="color: #007700">, </span><span style="color: #0000BB">4</span><span style="color: #007700">, </span><span style="color: #0000BB">5</span><span style="color: #007700">, </span><span style="color: #0000BB">6</span><span style="color: #007700">),<br /> </span><span style="color: #DD0000">"holes" </span><span style="color: #007700">=> array(</span><span style="color: #DD0000">"erstes"</span><span style="color: #007700">, </span><span style="color: #0000BB">5 </span><span style="color: #007700">=> </span><span style="color: #DD0000">"zweites"</span><span style="color: #007700">, </span><span style="color: #DD0000">"drittes"</span><span style="color: #007700">)<br />);<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
</div>
</p>
<p class="para">
<div class="example" id="example-4958">
<p><strong>Beispiel #2 Automatischer Index mit <span class="function"><strong>array()</strong></span></strong></p>
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br />$array </span><span style="color: #007700">= array(</span><span style="color: #0000BB">1</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">, </span><span style="color: #0000BB">1</span><span style="color: #007700">, </span><span style="color: #0000BB">8 </span><span style="color: #007700">=> </span><span style="color: #0000BB">1</span><span style="color: #007700">, </span><span style="color: #0000BB">4 </span><span style="color: #007700">=> </span><span style="color: #0000BB">1</span><span style="color: #007700">, </span><span style="color: #0000BB">19</span><span style="color: #007700">, </span><span style="color: #0000BB">3 </span><span style="color: #007700">=> </span><span style="color: #0000BB">13</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">$array</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
<div class="example-contents"><p>Das oben gezeigte Beispiel erzeugt folgende
Ausgabe:</p></div>
<div class="example-contents screen">
<div class="cdata"><pre>
Array
(
[0] => 1
[1] => 1
[2] => 1
[3] => 13
[4] => 1
[8] => 1
[9] => 19
)
</pre></div>
</div>
</div>
</p>
<p class="para">
Beachten Sie, dass Index '3' doppelt definiert ist, und den letzten
definierten Wert 13 behält. Index 4 wurde nach dem Index 8 definiert,
und der nächste generierte Index (Wert 19) ist 9, da der größte Index
8 war.
</p>
<p class="para">
Dieses Beispiel erstellt ein auf dem Index 1 basierendes Array.
<div class="example" id="example-4959">
<p><strong>Beispiel #3 1-basierter Index mit <span class="function"><strong>array()</strong></span></strong></p>
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br />$erstesquartal </span><span style="color: #007700">= array(</span><span style="color: #0000BB">1 </span><span style="color: #007700">=> </span><span style="color: #DD0000">'Januar'</span><span style="color: #007700">, </span><span style="color: #DD0000">'Februar'</span><span style="color: #007700">, </span><span style="color: #DD0000">'März'</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">$erstesquartal</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
<div class="example-contents"><p>Das oben gezeigte Beispiel erzeugt folgende
Ausgabe:</p></div>
<div class="example-contents screen">
<div class="cdata"><pre>
Array
(
[1] => Januar
[2] => Februar
[3] => März
)
</pre></div>
</div>
</div>
</p>
<p class="para">
Man kann, ebenso wie in Perl, einen Wert des Arrays innerhalb doppelter
Anführungszeichen ansprechen. Jedoch muss man in PHP das Array in geschweifte
Klammern einschließen.
<div class="example" id="example-4960">
<p><strong>Beispiel #4 Auf ein Array innerhalb von doppelten Anführungszeichen zugreifen</strong></p>
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br /><br />$foo </span><span style="color: #007700">= array(</span><span style="color: #DD0000">'bar' </span><span style="color: #007700">=> </span><span style="color: #DD0000">'baz'</span><span style="color: #007700">);<br />echo </span><span style="color: #DD0000">"Hallo </span><span style="color: #007700">{</span><span style="color: #0000BB">$foo</span><span style="color: #007700">[</span><span style="color: #DD0000">'bar'</span><span style="color: #007700">]}</span><span style="color: #DD0000">!"</span><span style="color: #007700">; </span><span style="color: #FF8000">// Hallo baz!<br /><br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
</div>
</p>
</div>
<div class="refsect1 notes" id="refsect1-function.array-notes">
<h3 class="title">Anmerkungen</h3>
<p class="para">
<blockquote class="note"><p><strong class="note">Hinweis</strong>:
<p class="para">
<span class="function"><strong>array()</strong></span> ist ein Sprachkonstrukt, mit
dem man Arrays vorgeben kann und keine reguläre Funktion.
</p>
</p></blockquote>
</p>
</div>
<div class="refsect1 seealso" id="refsect1-function.array-seealso">
<h3 class="title">Siehe auch</h3>
<p class="para">
<ul class="simplelist">
<li class="member"><span class="function"><a href="function.array-pad.html" class="function" rel="rdfs-seeAlso">array_pad()</a> - Vergrößert ein Array auf die spezifizierte Länge mit einem
Wert</span></li>
<li class="member"><span class="function"><a href="function.list.html" class="function" rel="rdfs-seeAlso">list()</a> - Weist Variablen zu, als wären sie ein Array</span></li>
<li class="member"><span class="function"><a href="function.count.html" class="function" rel="rdfs-seeAlso">count()</a> - Zählt alle Elemente eines Arrays oder Attribute eines Objekts</span></li>
<li class="member"><span class="function"><a href="function.range.html" class="function" rel="rdfs-seeAlso">range()</a> - Erstellt ein Array mit einem Bereich von Elementen</span></li>
<li class="member"><a href="control-structures.foreach.html" class="link">foreach</a></li>
<li class="member">The <a href="language.types.array.html" class="link">array</a> type</li>
</ul>
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.array-walk.html">array_walk</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.arsort.html">arsort</a></div>
<div class="up"><a href="ref.array.html">Array Funktionen</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>