[reference/random] add random examples

Author: mumumu

reference/random/examples.xml

@@ -0,0 +1,66 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 1bcc40f8134305cbebf6c8378ee7e5fc8c569674 Maintainer: mumumu Status: ready -->
+<chapter xml:id="random.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ &reftitle.examples;
+ <example>
+  <title>Random の例</title>
+  <programlisting role="php">
+<![CDATA[
+<?php
+$r = new \Random\Randomizer();
+
+// ランダムなドメイン名を生成する
+printf(
+    "%s.example.com\n",
+    $r->getBytesFromString('abcdefghijklmnopqrstuvwxyz0123456789', 16)
+);
+
+// 配列をシャッフルする:
+$fruits = [ 'red' => '🍎', 'green' => '🥝', 'yellow' => '🍌', 'pink' => '🍑', 'purple' => '🍇' ];
+echo "Salad: ", implode(', ', $r->shuffleArray($fruits)), "\n";
+
+// 配列のキーをシャッフルする
+$fruits = [ 'red' => '🍎', 'green' => '🥝', 'yellow' => '🍌', 'pink' => '🍑', 'purple' => '🍇' ];
+
+$keys = $r->pickArrayKeys($fruits, 2);
+// 選択したキーの値を調べる
+$selection = array_map(
+    static fn ($key) => $fruits[$key],
+    $keys
+);
+
+echo "Values: ", implode(', ', $selection), "\n";
+?>
+]]>
+  </programlisting>
+  &example.outputs.similar;
+  <screen>
+<![CDATA[
+j87fzv1p0daiwmlo.example.com
+Salad: 🥝, 🍇, 🍎, 🍌, 🍑
+Values: 🍌, 🍑
+]]>
+  </screen>
+ </example>
+</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:"~/.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
+-->

reference/random/reference.xml

@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 2166824858a40ea664c558f2930b63b8f4fd89c6 Maintainer: mumumu Status: ready -->
+<reference xml:id="ref.random" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title>Random &Functions;</title>
+
+ &reference.random.entities.functions;
+
+</reference>
+<!-- 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
+-->