Show how to display shorthand notation as bytes as this is how the

php source does it.
And make the example formal.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@165192 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Philip Olson 2004-08-04 05:23:47 +00:00
parent d41312aede
commit f5de7481b2

View file

@ -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 'display_errors = ' . ini_get('display_errors') . "\n";
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 @@ display_errors = 1
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>,