Changes between Version 15 and Version 16 of BoltRef

Timestamp:

Dec 26, 2007, 9:55:48 AM (16 years ago)

Author:

davea

Comment:

--

BoltRef

@@ -246 +246 @@
 
 === Random ===
-The '''random''' control structure selects randomly from a set of units.
-{{{
-<?php
-return select(
-    name('course'),
+The '''random''' control structure selects randomly (without replacement) from a set of units.
+{{{
+<?php
+return random(
+    name('foobar'),
+    number(2),
     lesson(
         name('lesson 1'),
@@ -259 +260 @@
         filename('bolt_sample_lesson2.php')
     ),
-);
-?>
-}}}
+    lesson(
+        name('lesson 3'),
+        filename('bolt_sample_lesson3.php')
+    ),
+);
+?>
+}}}
+
+If 'number()' is given, that many units are shown; the default is one.
+
+The 'without replacement' applies across multiple visits to the same structure
+(e.g. because of review or refresh).
 
 === Select ===