Enable WASM for book.strings, and tweak examples

Author: derickr

reference/strings/book.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
 
-<book xml:id="book.strings" xmlns="http://docbook.org/ns/docbook">
+<book xml:id="book.strings" xmlns="http://docbook.org/ns/docbook" annotations="interactive">
  <?phpdoc extension-membership="core" ?>
  <title>Strings</title>
 

reference/strings/functions/addcslashes.xml

@@ -46,7 +46,8 @@
        When you define a sequence of characters in the <parameter>characters</parameter> argument
        make sure that you know what characters come between the
        characters that you set as the start and end of the range.
-       <informalexample>
+       <example>
+        <title><function>addcslashes</function> with Ranges</title>
         <programlisting role="php">
 <![CDATA[
 <?php
@@ -57,13 +58,14 @@ echo addcslashes('foo[ ]', 'A..z');
 ?>
 ]]>
         </programlisting>
-       </informalexample>
+       </example>
        Also, if the first character in a range has a higher ASCII value
        than the second character in the range, no range will be
        constructed.  Only the start, end and period characters will be
        escaped. Use the <function>ord</function> function to find the
        ASCII value for a character.
-       <informalexample>
+       <example>
+        <title><function>addcslashes</function> with Characters in Wrong Order</title>
         <programlisting role="php">
 <![CDATA[
 <?php
@@ -72,7 +74,7 @@ echo addcslashes("zoo['.']", 'z..A');
 ?>
 ]]>
         </programlisting>
-       </informalexample>
+       </example>
       </para>
       <para>
        Be careful if you choose to escape characters 0, a, b, f, n, r, t and
@@ -106,7 +108,9 @@ echo addcslashes("zoo['.']", 'z..A');
     <programlisting role="php">
 <![CDATA[
 <?php
+$not_escaped = "PHP isThirty\nYears Old!\tYay to the Elephant!\n";
 $escaped = addcslashes($not_escaped, "\0..\37!@\177..\377");
+echo $escaped;
 ?>
 ]]>
     </programlisting>

reference/strings/functions/addslashes.xml

@@ -25,7 +25,8 @@
   <para>
    A use case of <function>addslashes</function> is escaping the aforementioned
    characters in a string that is to be evaluated by PHP:
-   <informalexample>
+   <example>
+    <title>Escaping Characters</title>
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -34,7 +35,7 @@ eval("echo '" . addslashes($str) . "';");
 ?>
 ]]>
     </programlisting>
-   </informalexample>
+   </example>
   </para>
   <para>
    The <function>addslashes</function> is sometimes incorrectly used to try to prevent

reference/strings/functions/chr.xml

@@ -94,14 +94,17 @@ $bytevalue %= 256;
 
 $str = "The string ends in escape: ";
 $str .= chr(27); /* add an escape character at the end of $str */
+echo $str, PHP_EOL;
 
 /* Often this is more useful */
-
 $str = sprintf("The string ends in escape: %c", 27);
+echo $str, PHP_EOL;
 ?>
 ]]>
     </programlisting>
    </example>
+  </para>
+  <para>
    <example>
     <title>Overflow behavior</title>
     <programlisting role="php">
@@ -126,7 +129,7 @@ aA
 <![CDATA[
 <?php
 $str = chr(240) . chr(159) . chr(144) . chr(152);
-echo $str;
+echo $str, PHP_EOL;
 ?>
 ]]>
     </programlisting>

reference/strings/functions/chunk-split.xml

@@ -69,8 +69,11 @@
     <programlisting role="php">
 <![CDATA[
 <?php
+$data = 'This is quite a long string, which will get broken up because the line is going to be too long after base64 encoding it.';
+
 // format $data using RFC 2045 semantics
 $new_string = chunk_split(base64_encode($data));
+echo $new_string, PHP_EOL;
 ?>
 ]]>
     </programlisting>

reference/strings/functions/echo.xml

@@ -105,16 +105,26 @@ echo implode(" and ", $fruits); // lemon and orange and banana
 // Non-string expressions are coerced to string, even if declare(strict_types=1) is used
 echo 6 * 7; // 42
 
-// Because echo does not behave as an expression, the following code is invalid.
-($some_var) ? echo 'true' : echo 'false';
-
 // However, the following examples will work:
 ($some_var) ? print 'true' : print 'false'; // print is also a construct, but
                                             // it is a valid expression, returning 1,
                                             // so it may be used in this context.
 
 echo $some_var ? 'true': 'false'; // evaluating the expression first and passing it to echo
 ?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+  <para>
+   <example>
+    <title><literal>echo</literal> is not an expression</title>
+    <programlisting role="php" annotations="non-interactive">
+<![CDATA[
+<?php
+// Because echo does not behave as an expression, the following code is invalid.
+($some_var) ? echo 'true' : echo 'false';
+?>
 ]]>
     </programlisting>
    </example>
@@ -134,32 +144,44 @@ echo $some_var ? 'true': 'false'; // evaluating the expression first and passing
     part of the expression being output, not part of the <literal>echo</literal>
     syntax itself.
 
-    <informalexample>
+    <example>
+     <title>Using Parentheses</title>
      <programlisting role="php">
      <![CDATA[
 <?php
-echo "hello";
+echo "hello", PHP_EOL;
 // outputs "hello"
 
-echo("hello");
+echo("hello"), PHP_EOL;
 // also outputs "hello", because ("hello") is a valid expression
 
-echo(1 + 2) * 3;
+echo(1 + 2) * 3, PHP_EOL;
 // outputs "9"; the parentheses cause 1+2 to be evaluated first, then 3*3
 // the echo statement sees the whole expression as one argument
 
-echo "hello", " world";
+echo "hello", " world", PHP_EOL;
 // outputs "hello world"
 
-echo("hello"), (" world");
+echo("hello"), (" world"), PHP_EOL;
 // outputs "hello world"; the parentheses are part of each expression
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
 
-echo("hello", " world");
+  <para>
+    <example>
+     <title>Invalid Expression</title>
+     <programlisting role="php" annotations="non-interactive">
+     <![CDATA[
+<?php
+echo("hello", " world"), PHP_EOL;
 // Throws a Parse Error because ("hello", " world") is not a valid expression
 ?>
 ]]>
     </programlisting>
-   </informalexample>
+   </example>
   </para>
   </note>
 

reference/strings/functions/explode.xml

@@ -127,15 +127,14 @@
 // Example 1
 $pizza  = "piece1 piece2 piece3 piece4 piece5 piece6";
 $pieces = explode(" ", $pizza);
-echo $pieces[0]; // piece1
-echo $pieces[1]; // piece2
+echo $pieces[0], PHP_EOL; // piece1
+echo $pieces[1], PHP_EOL; // piece2
 
 // Example 2
 $data = "foo:*:1023:1000::/home/foo:/bin/sh";
 list($user, $pass, $uid, $gid, $gecos, $home, $shell) = explode(":", $data);
-echo $user; // foo
-echo $pass; // *
-
+echo $user, PHP_EOL; // foo
+echo $pass, PHP_EOL; // *
 ?>
 ]]>
     </programlisting>

reference/strings/functions/fprintf.xml

@@ -70,6 +70,10 @@ if (!($fp = fopen('date.txt', 'w'))) {
     return;
 }
 
+$year = 2005;
+$month = 5;
+$day = 6;
+
 fprintf($fp, "%04d-%02d-%02d", $year, $month, $day);
 // will write the formatted ISO date to date.txt
 ?>

reference/strings/functions/html-entity-decode.xml

@@ -166,9 +166,9 @@ $a = htmlentities($orig);
 
 $b = html_entity_decode($a);
 
-echo $a; // I'll "walk" the <b>dog</b> now
+echo $a, PHP_EOL; // I'll "walk" the <b>dog</b> now
 
-echo $b; // I'll "walk" the <b>dog</b> now
+echo $b, PHP_EOL; // I'll "walk" the <b>dog</b> now
 ?>
 ]]>
     </programlisting>

reference/strings/functions/lcfirst.xml

@@ -69,11 +69,11 @@
 <![CDATA[
 <?php
 $foo = 'HelloWorld';
-$foo = lcfirst($foo);             // helloWorld
+echo lcfirst($foo), PHP_EOL;             // helloWorld
 
 $bar = 'HELLO WORLD!';
-$bar = lcfirst($bar);             // hELLO WORLD!
-$bar = lcfirst(strtoupper($bar)); // hELLO WORLD!
+echo lcfirst($bar), PHP_EOL;             // hELLO WORLD!
+echo lcfirst(strtoupper($bar)), PHP_EOL; // hELLO WORLD!
 ?>
 ]]>
     </programlisting>