1
0
mirror of https://github.com/php/doc-de.git synced 2026-03-26 08:12:07 +01:00
Files
archived-doc-de/reference/array/functions/array-rand.xml
Mark Wiesemann 2bd12c4311 - take over array functions from "nobody" that are marked "critical"
- switch encoding
- sync to EN


git-svn-id: https://svn.php.net/repository/phpdoc/de/trunk@275788 c90b9560-bf6c-de11-be94-00142212c4b1
2009-02-13 20:55:36 +00:00

111 lines
3.0 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.12 $ -->
<!-- EN-Revision: 1.13 Maintainer: wiesemann Status: ready -->
<!-- CREDITS: tom -->
<refentry xml:id="function.array-rand" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>array_rand</refname>
<refpurpose>Liefert einen oder mehrere zufällige Einträge eines Arrays</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>mixed</type><methodname>array_rand</methodname>
<methodparam><type>array</type><parameter>input</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>num_req</parameter><initializer>1</initializer></methodparam>
</methodsynopsis>
<para>
<function>array_rand</function> ist ziemlich nützlich, wenn Sie
einen oder mehrere zufällige Einträge eines Arrays auswählen
möchten.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>input</parameter></term>
<listitem>
<para>
Das Eingabe-Array.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>num_req</parameter></term>
<listitem>
<para>
Gibt an, wie viele Einträge Sie auswählen möchten - wenn nicht
angegeben, wird der Standardwert 1 verwendet.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Wenn Sie nur einen Eintrag auswählen, liefert
<function>array_rand</function> 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.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>array_rand</function>-Beispiel</title>
<programlisting role="php">
<![CDATA[
<?php
srand((float) microtime() * 10000000);
$input = array("Neo", "Morpheus", "Trinity", "Cypher", "Tank");
$rand_keys = array_rand($input, 2);
echo $input[$rand_keys[0]] . "\n";
echo $input[$rand_keys[1]] . "\n";
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
&note.randomseed;
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>shuffle</function></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:"../../../../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
-->