function.array-rand.html
6.33 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
<!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>Liefert einen oder mehrere zufällige Einträge eines Arrays</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.array-push.html">array_push</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.array-reduce.html">array_reduce</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-rand" class="refentry">
<div class="refnamediv">
<h1 class="refname">array_rand</h1>
<p class="verinfo">(PHP 4, PHP 5)</p><p class="refpurpose"><span class="refname">array_rand</span> — <span class="dc-title">Liefert einen oder mehrere zufällige Einträge eines Arrays</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.array-rand-description">
<h3 class="title">Beschreibung</h3>
<div class="methodsynopsis dc-description">
<span class="type"><a href="language.pseudo-types.html#language.types.mixed" class="type mixed">mixed</a></span> <span class="methodname"><strong>array_rand</strong></span>
( <span class="methodparam"><span class="type">array</span> <code class="parameter">$input</code></span>
[, <span class="methodparam"><span class="type">int</span> <code class="parameter">$num_req</code><span class="initializer"> = 1</span></span>
] )</div>
<p class="para rdfs-comment">
Wählt einen oder mehrere Einträge aus einem Array aus und gibt den Schlüssel
des zufälligen Eintrags bzw. die Schlüssel der zufälligen Einträge zurück.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.array-rand-parameters">
<h3 class="title">Parameter-Liste</h3>
<p class="para">
<dl>
<dt>
<code class="parameter">input</code></dt>
<dd>
<p class="para">
Das Eingabe-Array.
</p>
</dd>
<dt>
<code class="parameter">num_req</code></dt>
<dd>
<p class="para">
Gibt an, wie viele Einträge Sie auswählen möchten. Falls mehr
Einträge als im Array existieren angegeben werden, wird ein
Fehler der Stufe <strong><code>E_WARNING</code></strong> erzeugt.
</p>
</dd>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.array-rand-returnvalues">
<h3 class="title">Rückgabewerte</h3>
<p class="para">
Wenn Sie nur einen Eintrag auswählen, liefert
<span class="function"><strong>array_rand()</strong></span> den Schlüssel eines zufälligen
Eintrages. Andernfalls wird ein Array mit den Schlüsseln der
zufälligen Einträge zurückgegeben. Dies hat den Zweck, dass Sie
zufällige Schlüssel und auch Werte aus dem Array auswählen
können.
</p>
</div>
<div class="refsect1 changelog" id="refsect1-function.array-rand-changelog">
<h3 class="title">Changelog</h3>
<p class="para">
<table class="doctable informaltable">
<thead>
<tr>
<th>Version</th>
<th>Beschreibung</th>
</tr>
</thead>
<tbody class="tbody">
<tr>
<td>5.2.10</td>
<td>
Das Ergebnisarray wird nicht mehr gemischt.
</td>
</tr>
<tr><td>4.2.0</td><td>Der
Zufallszahlengenerator wird automatisch initialisiert.</td></tr>
</tbody>
</table>
</p>
</div>
<div class="refsect1 examples" id="refsect1-function.array-rand-examples">
<h3 class="title">Beispiele</h3>
<p class="para">
<div class="example" id="example-4933">
<p><strong>Beispiel #1 <span class="function"><strong>array_rand()</strong></span>-Beispiel</strong></p>
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br />$input </span><span style="color: #007700">= array(</span><span style="color: #DD0000">"Neo"</span><span style="color: #007700">, </span><span style="color: #DD0000">"Morpheus"</span><span style="color: #007700">, </span><span style="color: #DD0000">"Trinity"</span><span style="color: #007700">, </span><span style="color: #DD0000">"Cypher"</span><span style="color: #007700">, </span><span style="color: #DD0000">"Tank"</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">$rand_keys </span><span style="color: #007700">= </span><span style="color: #0000BB">array_rand</span><span style="color: #007700">(</span><span style="color: #0000BB">$input</span><span style="color: #007700">, </span><span style="color: #0000BB">2</span><span style="color: #007700">);<br />echo </span><span style="color: #0000BB">$input</span><span style="color: #007700">[</span><span style="color: #0000BB">$rand_keys</span><span style="color: #007700">[</span><span style="color: #0000BB">0</span><span style="color: #007700">]] . </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />echo </span><span style="color: #0000BB">$input</span><span style="color: #007700">[</span><span style="color: #0000BB">$rand_keys</span><span style="color: #007700">[</span><span style="color: #0000BB">1</span><span style="color: #007700">]] . </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
</div>
</p>
</div>
<div class="refsect1 seealso" id="refsect1-function.array-rand-seealso">
<h3 class="title">Siehe auch</h3>
<p class="para">
<ul class="simplelist">
<li class="member"><span class="function"><a href="function.shuffle.html" class="function" rel="rdfs-seeAlso">shuffle()</a> - Mischt die Elemente eines Arrays</span></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-push.html">array_push</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.array-reduce.html">array_reduce</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>