CVS update: php3/doc/functions

Date: Saturday September 26, 1998 @ 5:36 Author: cslawi Update of /repository/php3/doc/functions In directory asf:/u2/tmp/cvs-serv14384 Modified Files: misc.sgml Log Message: Added eval(). Index: php3/doc/functions/misc.sgml diff -c php3/doc/functions/misc.sgml:1.5 php3/doc/functions/misc.sgml:1.6 *** php3/doc/functions/misc.sgml:1.5 Mon Sep 7 07:47:36 1998 --- php3/doc/functions/misc.sgml Sat Sep 26 05:36:43 1998 *************** *** 8,13 **** --- 8,70 ---- categories seemed to fit. </partintro> + <refentry id="function.eval"> + <refnamediv> + <refname>eval</refname> + <refpurpose>Evaluate a string as PHP code</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcdef>void <function>eval</function></funcdef> + <paramdef>string <parameter>code_str</parameter></paramdef> + </funcsynopsis> + + <simpara> + <function>eval</function> evaluates the string given in + <parameter>code_str</parameter> as PHP code. Among other things, + this can be useful for storing code in a database text field for + later execution. + + <simpara> + There are some factors to keep in mind when using + <function>eval</function>. Remember that the string passed must + be valid PHP code, including things like terminating statements + with a semicolon so the parser doesn't die on the line after the + <function>eval</function>, and properly escaping things in + <parameter>code_str</parameter>. + + <simpara> + Also remember that variables given values under + <function>eval</function> will retain these values in the main + script afterwards. + + <para> + <example> + <title>eval() example - simple text merge</title> + <programlisting> + &lt;?php + $string = 'cup'; + $name = 'coffee'; + $str = 'This is a $string with my $name in it.&lt;br&gt;'; + echo $str; + eval( "\$str = \"$str\";" ); + echo $str; + ?&gt; + </programlisting> + </example> + + <para> + The above example will show: + <programlisting> + This is a $string with my $name in it. + This is a cup with my coffee in it. + </programlisting> + + </refsect1> + </refentry> + + <refentry id="function.leak"> <refnamediv> <refname>leak</refname> -- PHP Development Mailing List http://www.php.net/ To unsubscribe send an empty message to php-dev-unsubscribe@lists.php.net For help: php-dev-help@lists.php.net