cvs: phpdoc /en/reference/info/functions ini-get.xml

philip Wed Aug 4 01:23:47 2004 EDT Modified files: /phpdoc/en/reference/info/functions ini-get.xml Log: Show how to display shorthand notation as bytes as this is how the php source does it. And make the example formal. http://cvs.php.net/diff.php/phpdoc/en/reference/info/functions/ini-get.xml?r1=1.8&r2=1.9&ty=u Index: phpdoc/en/reference/info/functions/ini-get.xml diff -u phpdoc/en/reference/info/functions/ini-get.xml:1.8 phpdoc/en/reference/info/functions/ini-get.xml:1.9 --- phpdoc/en/reference/info/functions/ini-get.xml:1.8 Mon Dec 15 11:51:14 2003 +++ phpdoc/en/reference/info/functions/ini-get.xml Wed Aug 4 01:23:47 2004 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <!-- splitted from ./en/functions/info.xml, last change in rev 1.64 --> <refentry id="function.ini-get"> <refnamediv> @@ -27,13 +27,21 @@ <note> <title>When querying memory size values</title> <para> - Many ini memory size values, such as <literal>upload_max_filesize</literal> - are stored in the &php.ini; file in shorthand notation. <function>ini_get</function> - will return the exact string stored in the &php.ini; file, <emphasis>NOT</emphasis> - its integer equivalent. Attempting normal arithmetic functions on these values - will not have otherwise expected results. - <informalexample> - <programlisting role="php"> + Many ini memory size values, such as + <link linkend="ini.upload-max-filesize">upload_max_filesize</link>, are + stored in the &php.ini; file in shorthand notation. + <function>ini_get</function> will return the exact string stored in the + &php.ini; file and <emphasis>NOT</emphasis> its <type>integer</type> + equivalent. Attempting normal arithmetic functions on these values + will not have otherwise expected results. The example below shows one + way to convert shorthand notation into bytes, much like how the PHP + source does it. + </para> + </note> + <para> + <example> + <title>A few <function>ini_get</function> examples</title> + <programlisting role="php"> <![CDATA[ <?php /* @@ -48,6 +56,24 @@ echo 'register_globals = ' . ini_get('register_globals') . "\n"; echo 'post_max_size = ' . ini_get('post_max_size') . "\n"; echo 'post_max_size+1 = ' . (ini_get('post_max_size')+1) . "\n"; +echo 'post_max_size in bytes = ' . return_bytes(ini_get('post_max_size')); + +function return_bytes($val) { + $val = trim($val); + $last = $val{strlen($val)-1}; + switch($last) { + case 'k': + case 'K': + return (int) $val * 1024; + break; + case 'm': + case 'M': + return (int) $val * 1048576; + break; + default: + return $val; + } +} ?> ]]> @@ -62,12 +88,12 @@ register_globals = 0 post_max_size = 8M post_max_size+1 = 9 +post_max_size in bytes = 8388608 ]]> </screen> - </informalexample> + </example> </para> - </note> <para> See also <function>get_cfg_var</function>,