[PHP-DOC] cvs: phpdoc /en/functions misc.xml From: Jesus M. Castagnetto (jesusmc <email protected>)
Date: 08/25/00

jmcastagnetto Fri Aug 25 11:55:00 2000 EDT

  Modified files:
    /phpdoc/en/functions misc.xml
  Log:
  rearranged show_source to be in alphabetical order
  
  
Index: phpdoc/en/functions/misc.xml
diff -u phpdoc/en/functions/misc.xml:1.23 phpdoc/en/functions/misc.xml:1.24
--- phpdoc/en/functions/misc.xml:1.23 Fri Aug 25 11:52:24 2000
+++ phpdoc/en/functions/misc.xml Fri Aug 25 11:55:00 2000
@@ -60,7 +60,7 @@
       <programlisting role="php">
 function process($var1, $var2, $farr) {
     for ($f=0; $f &lt; count($farr); $f++)
- echo $farr[$f]($var1,$var2)."\n";
+ echo $farr[$f]($var1,$var2)."\n";
 }
 
 // create a bunch of math functions
@@ -82,7 +82,7 @@
 // now make a bunch of string processing functions
 $garr = array(
     create_function('$b,$a','if (strncmp($a,$b,3) == 0) return "** \"$a\" '.
- 'and \"$b\"\n** Look the same to me! (looking at the first 3 chars)";'),
+ 'and \"$b\"\n** Look the same to me! (looking at the first 3 chars)";'),
     create_function('$a,$b','; return "CRCs: ".crc32($a)." , ".crc32(b);'),
     create_function('$a,$b','; return "similar(a,b) = ".similar_text($a,$b,&$p)."($p%)";')
     );
@@ -120,10 +120,10 @@
 // outputs:
 // Array
 // (
-// [0] =&gt; the mango
-// [1] =&gt; a mango
-// [2] =&gt; that mango
-// [3] =&gt; this mango
+// [0] =&gt; the mango
+// [1] =&gt; a mango
+// [2] =&gt; that mango
+// [3] =&gt; this mango
 // )
 
 // an array of strings ordered from shorter to longer
@@ -132,10 +132,10 @@
 // outputs:
 // Array
 // (
-// [0] =&gt; small
-// [1] =&gt; larger
-// [2] =&gt; a big string
-// [3] =&gt; it is a string thing
+// [0] =&gt; small
+// [1] =&gt; larger
+// [2] =&gt; a big string
+// [3] =&gt; it is a string thing
 // )
 
 // sort it from longer to shorter
@@ -144,10 +144,10 @@
 // outputs:
 // Array
 // (
-// [0] =&gt; it is a string thing
-// [1] =&gt; a big string
-// [2] =&gt; larger
-// [3] =&gt; small
+// [0] =&gt; it is a string thing
+// [1] =&gt; a big string
+// [2] =&gt; larger
+// [3] =&gt; small
 // )
      </programlisting>
     </example>
@@ -485,7 +485,7 @@
      $numargs = func_num_args();
      echo "Number of arguments: $numargs&lt;br&gt;\n";
      if ($numargs &gt;= 2) {
- echo "Second argument is: " . func_get_arg (1) . "&lt;br&gt;\n";
+ echo "Second argument is: " . func_get_arg (1) . "&lt;br&gt;\n";
      }
 }
 
@@ -537,11 +537,11 @@
     $numargs = func_num_args();
     echo "Number of arguments: $numargs&lt;br&gt;\n";
     if ($numargs &gt;= 2) {
- echo "Second argument is: " . func_get_arg (1) . "&lt;br&gt;\n";
+ echo "Second argument is: " . func_get_arg (1) . "&lt;br&gt;\n";
     }
     $arg_list = func_get_args();
     for ($i = 0; $i &lt; $numargs; $i++) {
- echo "Argument $i is: " . $arg_list[$i] . "&lt;br&gt;\n";
+ echo "Argument $i is: " . $arg_list[$i] . "&lt;br&gt;\n";
     }
 }
 
@@ -684,7 +684,7 @@
 &lt;?php
 function list_array ($array) {
     while (list ($key, $value) = each ($array)) {
- $str .= "&lt;b&gt;$key:&lt;/b&gt; $value&lt;br&gt;\n";
+ $str .= "&lt;b&gt;$key:&lt;/b&gt; $value&lt;br&gt;\n";
     }
     return $str;
 }
@@ -787,14 +787,14 @@
 &lt;?php
     $script = getenv (&quot;PATH_TRANSLATED&quot;);
     if(!$script) {
- echo &quot;&lt;BR&gt;&lt;B&gt;ERROR: Script Name needed&lt;/B&gt;&lt;BR&gt;&quot;;
+ echo &quot;&lt;BR&gt;&lt;B&gt;ERROR: Script Name needed&lt;/B&gt;&lt;BR&gt;&quot;;
     } else {
- if (ereg(&quot;(\.php|\.inc)$&quot;,$script)) {
- echo &quot;&lt;H1&gt;Source of: $PATH_INFO&lt;/H1&gt;\n&lt;HR&gt;\n&quot;;
- highlight_file($script);
- } else {
- echo &quot;&lt;H1&gt;ERROR: Only PHP or include script names are allowed&lt;/H1&gt;&quot;;
- }
+ if (ereg(&quot;(\.php|\.inc)$&quot;,$script)) {
+ echo &quot;&lt;H1&gt;Source of: $PATH_INFO&lt;/H1&gt;\n&lt;HR&gt;\n&quot;;
+ highlight_file($script);
+ } else {
+ echo &quot;&lt;H1&gt;ERROR: Only PHP or include script names are allowed&lt;/H1&gt;&quot;;
+ }
     }
     echo &quot;&lt;HR&gt;Processed: &quot;.date(&quot;Y/M/d H:i:s&quot;,time());
 ?&gt;
@@ -962,107 +962,107 @@
      <itemizedlist>
       <listitem>
        <simpara>
- a NUL-padded string
+ a NUL-padded string
        </simpara>
       </listitem>
       <listitem>
        <simpara>
- A SPACE-padded string
+ A SPACE-padded string
        </simpara>
       </listitem>
       <listitem>
        <simpara>
- h Hex string, low nibble first
+ h Hex string, low nibble first
        </simpara>
       </listitem>
       <listitem>
        <simpara>
- H Hex string, high nibble first
+ H Hex string, high nibble first
        </simpara>
       </listitem>
       <listitem>
        <simpara>
- c signed char
+ c signed char
        </simpara>
       </listitem>
       <listitem>
        <simpara>
- C unsigned char
+ C unsigned char
        </simpara>
       </listitem>
       <listitem>
        <simpara>
- s signed short (always 16 bit, machine byte order)
+ s signed short (always 16 bit, machine byte order)
        </simpara>
       </listitem>
       <listitem>
        <simpara>
- S unsigned short (always 16 bit, machine byte order)
+ S unsigned short (always 16 bit, machine byte order)
        </simpara>
       </listitem>
       <listitem>
        <simpara>
- n unsigned short (always 16 bit, big endian byte order)
+ n unsigned short (always 16 bit, big endian byte order)
        </simpara>
       </listitem>
       <listitem>
        <simpara>
- v unsigned short (always 16 bit, little endian byte order)
+ v unsigned short (always 16 bit, little endian byte order)
        </simpara>
       </listitem>
       <listitem>
        <simpara>
- i signed integer (machine dependent size and byte order)
+ i signed integer (machine dependent size and byte order)
        </simpara>
       </listitem>
       <listitem>
        <simpara>
- I unsigned integer (machine dependent size and byte order)
+ I unsigned integer (machine dependent size and byte order)
        </simpara>
       </listitem>
       <listitem>
        <simpara>
- l signed long (always 32 bit, machine byte order)
+ l signed long (always 32 bit, machine byte order)
        </simpara>
       </listitem>
       <listitem>
        <simpara>
- L unsigned long (always 32 bit, machine byte order)
+ L unsigned long (always 32 bit, machine byte order)
        </simpara>
       </listitem>
       <listitem>
        <simpara>
- N unsigned long (always 32 bit, big endian byte order)
+ N unsigned long (always 32 bit, big endian byte order)
        </simpara>
       </listitem>
       <listitem>
        <simpara>
- V unsigned long (always 32 bit, little endian byte order)
+ V unsigned long (always 32 bit, little endian byte order)
        </simpara>
       </listitem>
       <listitem>
        <simpara>
- f float (machine dependent size and representation)
+ f float (machine dependent size and representation)
        </simpara>
       </listitem>
       <listitem>
        <simpara>
- d double (machine dependent size and representation)
+ d double (machine dependent size and representation)
        </simpara>
       </listitem>
       <listitem>
        <simpara>
- x NUL byte
+ x NUL byte
        </simpara>
       </listitem>
       <listitem>
        <simpara>
- X Back up one byte
+ X Back up one byte
        </simpara>
       </listitem>
       <listitem>
        <simpara>
- @ NUL-fill to absolute position
+ @ NUL-fill to absolute position
        </simpara>
       </listitem>
      </itemizedlist>
@@ -1193,13 +1193,13 @@
 
 $conn = odbc_connect ("webdb", "php", "chicken");
 $stmt = odbc_prepare ($conn,
- "UPDATE sessions SET data = ? WHERE id = ?");
+ "UPDATE sessions SET data = ? WHERE id = ?");
 $sqldata = array (serialize($session_data), $PHP_AUTH_USER);
 if (!odbc_execute ($stmt, &amp;$sqldata)) {
     $stmt = odbc_prepare($conn,
- "INSERT INTO sessions (id, data) VALUES(?, ?)");
+ "INSERT INTO sessions (id, data) VALUES(?, ?)");
     if (!odbc_execute($stmt, &amp;$sqldata)) {
- /* Something went wrong. Bitch, whine and moan. */
+ /* Something went wrong. Bitch, whine and moan. */
     }
 }
       </programlisting>
@@ -1256,39 +1256,39 @@
 // error handler function
 function myErrorHandler ($errno, $errstr) {
     switch ($errno) {
- case FATAL:
- echo &quot;&lt;b&gt;FATAL&lt;/b&gt; [$errno] $errstr&lt;br&gt;\n&quot;;
- echo &quot; Fatal error in line &quot;.__LINE__.&quot; of file &quot;.__FILE__;
- echo &quot;, PHP &quot;.PHP_VERSION.&quot; (&quot;.PHP_OS.&quot;)&lt;br&gt;\n&quot;;
- echo &quot;Aborting...&lt;br&gt;\n&quot;;
- exit -1;
- break;
- case ERROR:
- echo &quot;&lt;b&gt;ERROR&lt;/b&gt; [$errno] $errstr&lt;br&gt;\n&quot;;
- break;
- case WARNING:
- echo &quot;&lt;b&gt;WARNING&lt;/b&gt; [$errno] $errstr&lt;br&gt;\n&quot;;
- break;
- default:
- echo &quot;Unkown error type: [$errno] $errstr&lt;br&gt;\n&quot;;
- break;
+ case FATAL:
+ echo &quot;&lt;b&gt;FATAL&lt;/b&gt; [$errno] $errstr&lt;br&gt;\n&quot;;
+ echo &quot; Fatal error in line &quot;.__LINE__.&quot; of file &quot;.__FILE__;
+ echo &quot;, PHP &quot;.PHP_VERSION.&quot; (&quot;.PHP_OS.&quot;)&lt;br&gt;\n&quot;;
+ echo &quot;Aborting...&lt;br&gt;\n&quot;;
+ exit -1;
+ break;
+ case ERROR:
+ echo &quot;&lt;b&gt;ERROR&lt;/b&gt; [$errno] $errstr&lt;br&gt;\n&quot;;
+ break;
+ case WARNING:
+ echo &quot;&lt;b&gt;WARNING&lt;/b&gt; [$errno] $errstr&lt;br&gt;\n&quot;;
+ break;
+ default:
+ echo &quot;Unkown error type: [$errno] $errstr&lt;br&gt;\n&quot;;
+ break;
     }
 }
 
 // function to test the error handling
 function scale_by_log ($vect, $scale) {
     if ( !is_numeric($scale) || $scale &lt;= 0 )
- trigger_error(&quot;log(x) for x &lt;= 0 is undefined, you used: scale = $scale&quot;,
- FATAL);
+ trigger_error(&quot;log(x) for x &lt;= 0 is undefined, you used: scale = $scale&quot;,
+ FATAL);
     if (!is_array($vect)) {
- trigger_error(&quot;Incorrect input vector, array of values expected&quot;, ERROR);
- return null;
+ trigger_error(&quot;Incorrect input vector, array of values expected&quot;, ERROR);
+ return null;
     }
     for ($i=0; $i&lt;count($vect); $i++) {
- if (!is_numeric($vect[$i]))
- trigger_error(&quot;Value at position $i is not a number, using 0 (zero)&quot;,
- WARNING);
- $temp[$i] = log($scale) * $vect[$i];
+ if (!is_numeric($vect[$i]))
+ trigger_error(&quot;Value at position $i is not a number, using 0 (zero)&quot;,
+ WARNING);
+ $temp[$i] = log($scale) * $vect[$i];
     }
     return $temp;
 }
@@ -1363,6 +1363,37 @@
    </refsect1>
   </refentry>
 
+ <refentry id="function.show-source">
+ <refnamediv>
+ <refname>show_source</refname>
+ <refpurpose>Syntax highlighting of a file</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Description</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>show_source</function></funcdef>
+ <paramdef>string <parameter>filename</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <simpara>
+ The <function>show_source</function> function prints out a syntax
+ higlighted version of the code contained in <parameter>filename</parameter>
+ using the colors defined in the built-in syntax highlighter for PHP.
+ </simpara>
+ <note>
+ <simpara>
+ This function is an alias for the function
+ <function>highlight_file</function>
+ </simpara>
+ </note>
+ <simpara>
+ See also <function>highlight_string</function>,
+ <function>highlight_file</function>.
+ </simpara>
+ </refsect1>
+ </refentry>
+
   <refentry id="function.sleep">
    <refnamediv>
     <refname>sleep</refname>
@@ -1581,8 +1612,8 @@
     // we should now have the serialized data in $tmp[0].
     $session_data = unserialize ($tmp[0]);
     if (!is_array ($session_data)) {
- // something went wrong, initialize to empty array
- $session_data = array();
+ // something went wrong, initialize to empty array
+ $session_data = array();
     }
 }
       </programlisting>
@@ -1646,37 +1677,6 @@
       This function does not work on Windows systems.
      </simpara>
     </note>
- </refsect1>
- </refentry>
-
- <refentry id="function.show-source">
- <refnamediv>
- <refname>show_source</refname>
- <refpurpose>Syntax highlighting of a file</refpurpose>
- </refnamediv>
- <refsect1>
- <title>Description</title>
- <funcsynopsis>
- <funcprototype>
- <funcdef>void <function>show_source</function></funcdef>
- <paramdef>string <parameter>filename</parameter></paramdef>
- </funcprototype>
- </funcsynopsis>
- <simpara>
- The <function>show_source</function> function prints out a syntax
- higlighted version of the code contained in <parameter>filename</parameter>
- using the colors defined in the built-in syntax highlighter for PHP.
- </simpara>
- <note>
- <simpara>
- This function is an alias for the function
- <function>highlight_file</function>
- </simpara>
- </note>
- <simpara>
- See also <function>highlight_string</function>,
- <function>highlight_file</function>.
- </simpara>
    </refsect1>
   </refentry>