cycle98 Fri Feb 2 17:46:59 2001 EDT Modified files: /phpdoc/kr/functions math.xml Log: translation english to korean by SeungHwan Lee 001
Index: phpdoc/kr/functions/math.xml diff -u phpdoc/kr/functions/math.xml:1.2 phpdoc/kr/functions/math.xml:1.3 --- phpdoc/kr/functions/math.xml:1.2 Fri Jan 12 06:16:40 2001 +++ phpdoc/kr/functions/math.xml Fri Feb 2 17:46:59 2001 @@ -1,1155 +1,1191 @@ - <reference id="ref.math"> - <title>Mathematical Functions</title> - <titleabbrev>Math.</titleabbrev> - - <partintro> - <sect1 id="math.intro"> - <title>Introduction</title> - <para> - These math functions will only handle values within the range of - the long and double types on your computer. If you need to - handle bigger numbers, take a look at the <link - linkend="ref.bc">arbitrary precision math functions</link>. - </para> - <sect2 id="math.constants"> - <title>Math constants</title> - <para> - The following values are defined as constants in PHP by the math - extension: - <table> - <title>Math constants</title> - <tgroup cols="3"> - <thead> - <row> - <entry>Constant</entry> - <entry>Value</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry>M_PI</entry> - <entry>3.14159265358979323846</entry> - <entry>Pi</entry> - </row> - <row> - <entry>M_E</entry> - <entry>2.7182818284590452354</entry> - <entry>e</entry> - </row> - <row> - <entry>M_LOG2E</entry> - <entry>1.4426950408889634074</entry> - <entry>log_2 e</entry> - </row> - <row> - <entry>M_LOG10E</entry> - <entry>0.43429448190325182765</entry> - <entry>log_10 e</entry> - </row> - <row> - <entry>M_LN2</entry> - <entry>0.69314718055994530942</entry> - <entry>log_e 2</entry> - </row> - <row> - <entry>M_LN10</entry> - <entry>2.30258509299404568402</entry> - <entry>log_e 10</entry> - </row> - <row> - <entry>M_PI_2</entry> - <entry>1.57079632679489661923</entry> - <entry>pi/2</entry> - </row> - <row> - <entry>M_PI_4</entry> - <entry>0.78539816339744830962</entry> - <entry>pi/4</entry> - </row> - <row> - <entry>M_1_PI</entry> - <entry>0.31830988618379067154</entry> - <entry>1/pi</entry> - </row> - <row> - <entry>M_2_PI</entry> - <entry>0.63661977236758134308</entry> - <entry>2/pi</entry> - </row> - <row> - <entry>M_SQRTPI</entry> - <entry>1.77245385090551602729</entry> - <entry>sqrt(pi) [4.0.2]</entry> - </row> - <row> - <entry>M_2_SQRTPI</entry> - <entry>1.12837916709551257390</entry> - <entry>2/sqrt(pi)</entry> - </row> - <row> - <entry>M_SQRT2</entry> - <entry>1.41421356237309504880</entry> - <entry>sqrt(2)</entry> - </row> - <row> - <entry>M_SQRT3</entry> - <entry>1.73205080756887729352</entry> - <entry>sqrt(3) [4.0.2]</entry> - </row> - <row> - <entry>M_SQRT1_2</entry> - <entry>0.70710678118654752440</entry> - <entry>1/sqrt(2)</entry> - </row> - <row> - <entry>M_LNPI</entry> - <entry>1.14472988584940017414</entry> - <entry>log_e(pi) [4.0.2]</entry> - </row> - <row> - <entry>M_EULER</entry> - <entry>0.57721566490153286061</entry> - <entry>Euler constant [4.0.2]</entry> - </row> - </tbody> - </tgroup> - </table> - Only M_PI is available in PHP versions up to and including PHP4RC1. - All other constants are available starting with PHP 4.0. Constants - labelled [4.0.2] were added in PHP 4.0.2. - </para> - </sect2> - </sect1> - </partintro> - - <refentry id="function.abs"> - <refnamediv> - <refname>abs</refname> - <refpurpose>Absolute value</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>mixed <function>abs</function></funcdef> - <paramdef>mixed <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns the absolute value of number. If the argument number is - float, return type is also float, otherwise it is int. - </para> - </refsect1> - </refentry> - - <refentry id="function.acos"> - <refnamediv> - <refname>acos</refname> - <refpurpose>Arc cosine</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>acos</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns the arc cosine of arg in radians. - </para> - <para> - See also <function>asin</function> and <function>atan</function>. - </para> - </refsect1> - </refentry> - - <refentry id="function.asin"> - <refnamediv> - <refname>asin</refname> - <refpurpose>Arc sine</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>asin</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns the arc sine of arg in radians. - </para> - <para> - See also <function>acos</function> and <function>atan</function>. - </para> - </refsect1> - </refentry> - - <refentry id="function.atan"> - <refnamediv> - <refname>atan</refname> - <refpurpose>Arc tangent</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>atan</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns the arc tangent of arg in radians. - </para> - <para> - See also <function>asin</function> and <function>acos</function>. - </para> - </refsect1> - </refentry> - - <refentry id="function.atan2"> - <refnamediv> - <refname>atan2</refname> - <refpurpose>arc tangent of two variables</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>atan2</function></funcdef> - <paramdef>float <parameter>y</parameter></paramdef> - <paramdef>float <parameter>x</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - This function calculates the arc tangent of the two variables - <parameter>x</parameter> and <parameter>y</parameter>. It is - similar to calculating the arc tangent of - <parameter>y</parameter> / <parameter>x</parameter>, except that - the signs of both arguments are used to determine the quadrant of - the result. - </simpara> - <simpara> - The function returns the result in radians, which is between -PI - and PI (inclusive). - </simpara> - <para> - See also <function>acos</function> and <function>atan</function>. - </para> - </refsect1> - </refentry> - - <refentry id="function.base-convert"> - <refnamediv> - <refname>base_convert</refname> - <refpurpose>Convert a number between arbitrary bases</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>base_convert</function></funcdef> - <paramdef>string <parameter>number</parameter></paramdef> - <paramdef>int <parameter>frombase</parameter></paramdef> - <paramdef>int <parameter>tobase</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns a string containing <parameter>number</parameter> - represented in base <parameter>tobase</parameter>. The base in - which <parameter>number</parameter> is given is specified in - <parameter>frombase</parameter>. Both - <parameter>frombase</parameter> and <parameter>tobase</parameter> - have to be between 2 and 36, inclusive. Digits in numbers with a - base higher than 10 will be represented with the letters a-z, - with a meaning 10, b meaning 11 and z meaning 35. - <example> - <title><function>Base_convert</function></title> - <programlisting role="php"> -$binary = base_convert ($hexadecimal, 16, 2); -</programlisting> - </example> - </para> - </refsect1> - </refentry> - - - <refentry id="function.bindec"> - <refnamediv> - <refname>bindec</refname> - <refpurpose>Binary to decimal</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>bindec</function></funcdef> - <paramdef>string <parameter>binary_string</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns the decimal equivalent of the binary number represented by - the binary_string argument. - </para> - <para> - Octdec converts a binary number to a decimal number. The largest - number that can be converted is 31 bits of 1's or 2147483647 in - decimal. - </para> - <para> - See also the <function>decbin</function> - function. - </para> - </refsect1> - </refentry> - - <refentry id="function.ceil"> - <refnamediv> - <refname>ceil</refname> - <refpurpose>Round fractions up</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>ceil</function></funcdef> - <paramdef>float <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns the next highest integer value from - <parameter>number</parameter>. Using <function>ceil</function> - on integers is absolutely a waste of time. - <informalexample> - <programlisting role="php"> -$x = ceil(4.25); -// which would make $x=5 - </programlisting> - </informalexample> - </para> - <simpara> - NOTE: PHP/FI 2's <function>ceil</function> returned a - float. Use: <literal>$new = (double)ceil($number);</literal> to - get the old behaviour. - </simpara> - <simpara> - See also <function>floor</function> and - <function>round</function>. - </simpara> - </refsect1> - </refentry> - - <refentry id="function.cos"> - <refnamediv> - <refname>cos</refname> - <refpurpose>Cosine</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>cos</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns the cosine of arg in radians. - </para> - <para> - See also <function>sin</function> and <function>tan</function>. - </para> - </refsect1> - </refentry> - - <refentry id="function.decbin"> - <refnamediv> - <refname>decbin</refname> - <refpurpose>Decimal to binary</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>decbin</function></funcdef> - <paramdef>int <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns a string containing a binary representation of the given - number argument. The largest number that can be converted is - 2147483647 in decimal resulting to a string of 31 1's. - </para> - <para> - See also the <function>bindec</function> function. - </para> - </refsect1> - </refentry> - - <refentry id="function.dechex"> - <refnamediv> - <refname>dechex</refname> - <refpurpose>Decimal to hexadecimal</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>dechex</function></funcdef> - <paramdef>int <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns a string containing a hexadecimal representation of the - given number argument. The largest number that can - be converted is 2147483647 in decimal resulting to "7fffffff". - </para> - <para> - See also the <function>hexdec</function> function. - </para> - </refsect1> - </refentry> - - <refentry id="function.decoct"> - <refnamediv> - <refname>decoct</refname> - <refpurpose>Decimal to octal</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>decoct</function></funcdef> - <paramdef>int <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns a string containing an octal representation of the given - number argument. The largest number that can be converted is - 2147483647 in decimal resulting to "17777777777". - </para> - <para> - See also <function>octdec</function>. - </para> - </refsect1> - </refentry> - - <refentry id="function.deg2rad"> - <refnamediv> - <refname>deg2rad</refname> - <refpurpose> - Converts the number in degrees to the radian equivalent - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>double <function>deg2rad</function></funcdef> - <paramdef>double <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - This function converts <parameter>number</parameter> from degrees - to the radian equivalent. - </para> - <para> - See also <function>rad2deg</function>. - </para> - </refsect1> - </refentry> - - <refentry id="function.exp"> - <refnamediv> - <refname>exp</refname> - <refpurpose>e to the power of ...</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>exp</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns e raised to the power of <parameter>arg</parameter>. - </para> - <para> - See also <function>pow</function>. - </para> - </refsect1> - </refentry> - - <refentry id="function.floor"> - <refnamediv> - <refname>floor</refname> - <refpurpose>Round fractions down</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>floor</function></funcdef> - <paramdef>float <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - Returns the next lowest integer value from - <parameter>number</parameter>. Using <function>floor</function> - on integers is absolutely a waste of time. - </simpara> - <simpara> - NOTE: PHP/FI 2's <function>floor</function> returned a - float. Use: <literal>$new = (double)floor($number);</literal> to - get the old behaviour. - </simpara> - <simpara> - See also <function>ceil</function> and - <function>round</function>. - </simpara> - </refsect1> - </refentry> - - <refentry id="function.getrandmax"> - <refnamediv> - <refname>getrandmax</refname> - <refpurpose>Show largest possible random value</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>getrandmax</function></funcdef> - <paramdef>void </paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - Returns the maximum value that can be returned by a call to - <function>rand</function>. - </simpara> - <simpara> - See also <function>rand</function>, <function>srand</function>, - <function>mt_rand</function>, <function>mt_srand</function>, and - <function>mt_getrandmax</function>. - </simpara> - </refsect1> - </refentry> - - <refentry id="function.hexdec"> - <refnamediv> - <refname>hexdec</refname> - <refpurpose>Hexadecimal to decimal</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>hexdec</function></funcdef> - <paramdef>string <parameter>hex_string</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns the decimal equivalent of the hexadecimal number - represented by the hex_string argument. HexDec converts a - hexadecimal string to a decimal number. The largest number that - can be converted is 7fffffff or 2147483647 in decimal. - </para> - <para> - See also the <function>dechex</function> function. - </para> - </refsect1> - </refentry> - - <refentry id="function.lcg-value"> - <refnamediv> - <refname>lcg_value</refname> - <refpurpose>Combined linear congruential generator</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>double <function>lcg_value</function></funcdef> - <void/> - </funcprototype> - </funcsynopsis> - <para> - <function>lcg_value</function> returns a pseudo random number in - the range of (0, 1). The function combines two CGs with periods - of 2^31 - 85 and 2^31 - 249. The period of this function is equal - to the product of both primes. - </para> - </refsect1> - </refentry> - - <refentry id="function.log"> - <refnamediv> - <refname>log</refname> - <refpurpose>Natural logarithm</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>log</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns the natural logarithm of arg. - </para> - </refsect1> - </refentry> - - <refentry id="function.log10"> - <refnamediv> - <refname>log10</refname> - <refpurpose>Base-10 logarithm</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>log10</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns the base-10 logarithm of <parameter>arg</parameter>. - </para> - </refsect1> - </refentry> - - <refentry id="function.max"> - <refnamediv> - <refname>max</refname> - <refpurpose>Find highest value</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>mixed <function>max</function></funcdef> - <paramdef>mixed <parameter>arg1</parameter></paramdef> - <paramdef>mixed <parameter>arg2</parameter></paramdef> - <paramdef>mixed <parameter>argn</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>max</function> returns the numerically highest of the - parameter values. - </para> - <para> - If the first parameter is an array, <function>max</function> - returns the highest value in that array. If the first parameter - is an integer, string or double, you need at least two parameters - and <function>max</function> returns the biggest of these values. - You can compare an unlimited number of values. - </para> - <para> - If one or more of the values is a double, all the values will be - treated as doubles, and a double is returned. If none of the - values is a double, all of them will be treated as integers, and - an integer is returned. - </para> - </refsect1> - </refentry> - - <refentry id="function.min"> - <refnamediv> - <refname>min</refname> - <refpurpose>Find lowest value</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>mixed <function>min</function></funcdef> - <paramdef>mixed <parameter>arg1</parameter></paramdef> - <paramdef>mixed <parameter>arg2</parameter></paramdef> - <paramdef>mixed <parameter>argn</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>Min</function> returns the numerically lowest of the - parameter values. - </para> - <para> - If the first parameter is an array, <function>min</function> - returns the lowest value in that array. If the first parameter - is an integer, string or double, you need at least two parameters - and <function>min</function> returns the lowest of these values. - You can compare an unlimited number of values. - </para> - <para> - If one or more of the values is a double, all the values will be - treated as doubles, and a double is returned. If none of the - values is a double, all of them will be treated as integers, and - an integer is returned. - </para> - </refsect1> - </refentry> - - <refentry id="function.mt-rand"> - <refnamediv> - <refname>mt_rand</refname> - <refpurpose>Generate a better random value</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>mt_rand</function></funcdef> - <paramdef>int - <parameter><optional>min</optional></parameter> - </paramdef> - <paramdef>int - <parameter><optional>max</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - Many random number generators of older libcs have dubious or - unknown characteristics and are slow. By default, PHP uses the - libc random number generator with the <function>rand</function> - function. <function>mt_rand</function> function is a drop-in - replacement for this. It uses a random number generator with - known characteristics, the Mersenne Twister, which will produce - random numbers that should be suitable for seeding some kinds - of cryptography (see the home pages for details) and is four - times faster than what the average libc provides. The Homepage - of the Mersenne Twister can be found at - <ulink url="&url.mersenne;">&url.mersenne;</ulink>, and an - optimized version of the MT source is available from - <ulink url="&url.mersenne.twister;">&url.mersenne.twister; - </ulink>. - </simpara> - <simpara> - If called without the optional <parameter>min</parameter>, - <parameter>max</parameter> arguments <function>mt_rand</function> - returns a pseudo-random value between 0 and - <constant>RAND_MAX</constant>. If you want a random number - between 5 and 15 (inclusive), for example, use <literal>mt_rand - (5, 15)</literal>. - </simpara> - <simpara> - Remember to seed the random number generator before use with - <function>mt_srand</function>. - </simpara> - <note> - <para> - In versions before 3.0.7 the meaning of - <parameter>max</parameter> was <parameter>range</parameter>. To - get the same results in these versions the short example should - be <literal>mt_rand (5, 11)</literal> to get a random number - between 5 and 15. - </para> - </note> - <simpara> - See also <function>mt_srand</function>, - <function>mt_getrandmax</function>, <function>srand</function>, - <function>rand</function> and <function>getrandmax</function>. - </simpara> - </refsect1> - </refentry> - - <refentry id="function.mt-srand"> - <refnamediv> - <refname>mt_srand</refname> - <refpurpose>Seed the better random number generator</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>void <function>mt_srand</function></funcdef> - <paramdef>int <parameter>seed</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Seeds the random number generator with - <parameter>seed</parameter>. - <informalexample> - <programlisting role="php"> -// seed with microseconds since last "whole" second -mt_srand ((double) microtime() * 1000000); -$randval = mt_rand(); - </programlisting> - </informalexample> - </para> - <simpara> - See also <function>mt_rand</function>, - <function>mt_getrandmax</function>, <function>srand</function>, - <function>rand</function>, and - <function>getrandmax</function>. - </simpara> - </refsect1> - </refentry> - - <refentry id="function.mt-getrandmax"> - <refnamediv> - <refname>mt_getrandmax</refname> - <refpurpose>Show largest possible random value</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>mt_getrandmax</function></funcdef> - <paramdef>void </paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - Returns the maximum value that can be returned by a call to - <function>mt_rand</function>. - </simpara> - <simpara> - See also <function>mt_rand</function>, - <function>mt_srand</function> <function>rand</function>, - <function>srand</function>, and - <function>getrandmax</function>. - </simpara> - </refsect1> - </refentry> - - <refentry id="function.number-format"> - <refnamediv> - <refname>number_format</refname> - <refpurpose>Format a number with grouped thousands</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>string <function>number_format</function></funcdef> - <paramdef>float <parameter>number</parameter></paramdef> - <paramdef>int <parameter>decimals</parameter></paramdef> - <paramdef>string <parameter>dec_point</parameter></paramdef> - <paramdef>string <parameter>thousands_sep</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>Number_format</function> returns a formatted version of - <parameter>number</parameter>. This function accepts either one, - two or four parameters (not three): - </para> - <para>If only one parameter is given, - <parameter>Number</parameter> will be formatted without decimals, - but with a comma (",") between every group of thousands. - </para> - <para> - If two parameters are given, <parameter>number</parameter> will - be formatted with <parameter>decimals</parameter> decimals with a - dot (".") in front, and a comma (",") between every group of - thousands. - </para> - <para> - If all four parameters are given, <parameter>number</parameter> - will be formatted with <parameter>decimals</parameter> decimals, - <parameter>dec_point</parameter> instead of a dot (".") before - the decimals and <parameter>thousands_sep</parameter> instead of - a comma (",") between every group of thousands. - </para> - </refsect1> - </refentry> - - <refentry id="function.octdec"> - <refnamediv> - <refname>octdec</refname> - <refpurpose>Octal to decimal</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>octdec</function></funcdef> - <paramdef>string <parameter>octal_string</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns the decimal equivalent of the octal number - represented by the octal_string argument. - OctDec converts an octal string to a decimal number. The largest - number that can be converted is 17777777777 or 2147483647 in - decimal. - </para> - <para> - See also <function>decoct</function>. - </para> - </refsect1> - </refentry> - - <refentry id="function.pi"> - <refnamediv> - <refname>pi</refname> - <refpurpose>Get value of pi</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>double <function>pi</function></funcdef> - <paramdef>void </paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - Returns an approximation of pi. - </simpara> - </refsect1> - </refentry> - - <refentry id="function.pow"> - <refnamediv> - <refname>pow</refname> - <refpurpose>Exponential expression</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>pow</function></funcdef> - <paramdef>float <parameter>base</parameter></paramdef> - <paramdef>float <parameter>exp</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns base raised to the power of exp. - </para> - <para> - See also <function>exp</function>. - </para> - </refsect1> - </refentry> - - <refentry id="function.rad2deg"> - <refnamediv> - <refname>rad2deg</refname> - <refpurpose> - Converts the radian number to the equivalent number in degrees - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>double <function>rad2deg</function></funcdef> - <paramdef>double <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - This function converts <parameter>number</parameter> from radian - to degrees. - </para> - <para> - See also <function>deg2rad</function>. - </para> - </refsect1> - </refentry> - - <refentry id="function.rand"> - <refnamediv> - <refname>rand</refname> - <refpurpose>Generate a random value</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>rand</function></funcdef> - <paramdef> - <parameter><optional>int min</optional></parameter> - </paramdef> - <paramdef> - <parameter><optional>int max</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <simpara> - If called without the optional <parameter>min</parameter>, - <parameter>max</parameter> arguments <function>rand</function> - returns a pseudo-random value between 0 and - <constant>RAND_MAX</constant>. If you want a random number - between 5 and 15 (inclusive), for example, use <literal>rand (5, - 15)</literal>. - </simpara> - <simpara> - Remember to seed the random number generator before use with - <function>srand</function>. - </simpara> - <note> - <para> - In versions before 3.0.7 the meaning of - <parameter>max</parameter> was <parameter>range</parameter>. To - get the same results in these versions the short example should - be <literal>rand (5, 11)</literal> to get a random number - between 5 and 15. - </para> - </note> - <simpara> - See also <function>srand</function>, - <function>getrandmax</function>, <function>mt_rand</function>, - <function>mt_srand</function>, and - <function>mt_getrandmax</function>. - </simpara> - </refsect1> - </refentry> - - <refentry id="function.round"> - <refnamediv> - <refname>round</refname> - <refpurpose>Rounds a float</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>double <function>round</function></funcdef> - <paramdef>double <parameter>val</parameter></paramdef> - <paramdef>int - <parameter><optional>precision</optional></parameter> - </paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns the rounded value of <parameter>val</parameter> to - specified <parameter>precision</parameter> - (number of digits after the decimal point). - <informalexample> - <programlisting role="php"> -$foo = round (3.4); // $foo == 3.0 -$foo = round (3.5); // $foo == 4.0 -$foo = round (3.6); // $foo == 4.0 - -$foo = round (1.95583, 2); // $foo == 1.96 - </programlisting> - </informalexample> - </para> - <note> - <simpara> - The <parameter>precision</parameter> parameter is only - available in PHP 4. - </simpara> - </note> - <simpara> - See also <function>ceil</function> and - <function>floor</function>. - </simpara> - </refsect1> - </refentry> - - <refentry id="function.sin"> - <refnamediv> - <refname>sin</refname> - <refpurpose>Sine</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>sin</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns the sine of arg in radians. - </para> - <para> - See also <function>cos</function> and <function>tan</function>. - </para> - </refsect1> - </refentry> - - <refentry id="function.sqrt"> - <refnamediv> - <refname>sqrt</refname> - <refpurpose>Square root</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>sqrt</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns the square root of <parameter>arg</parameter>. - </para> - </refsect1> - </refentry> - - <refentry id="function.srand"> - <refnamediv> - <refname>srand</refname> - <refpurpose>Seed the random number generator</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>void <function>srand</function></funcdef> - <paramdef>int <parameter>seed</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Seeds the random number generator with - <parameter>seed</parameter>. - <informalexample> - <programlisting role="php"> -// seed with microseconds since last "whole" second -srand ((double) microtime() * 1000000); -$randval = rand(); - </programlisting> - </informalexample> - </para> - <simpara> - See also <function>rand</function>, - <function>getrandmax</function>, <function>mt_rand</function>, - <function>mt_srand</function>, and - <function>mt_getrandmax</function>. - </simpara> - </refsect1> - </refentry> - - <refentry id="function.tan"> - <refnamediv> - <refname>tan</refname> - <refpurpose>Tangent</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>float <function>tan</function></funcdef> - <paramdef>float <parameter>arg</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns the tangent of arg in radians. - </para> - <para> - See also <function>sin</function> and <function>cos</function>. - </para> - </refsect1> - </refentry> - - </reference> - -<!-- Keep this comment at the end of the file -Local variables: -mode: sgml -sgml-omittag:t -sgml-shorttag:t -sgml-minimize-attributes:nil -sgml-always-quote-attributes:t -sgml-indent-step:1 -sgml-indent-data:t -sgml-parent-document:nil -sgml-default-dtd-file:"../../manual.ced" -sgml-exposed-tags:nil -sgml-local-catalogs:nil -sgml-local-ecat-files:nil -End: ---> +<reference id="ref.math"> + <title>Mathematical Functions</title> + <titleabbrev>Math.</titleabbrev> + <partintro> + <sect1 id="math.intro"> + <title>소개</title> + <para> + 이 수학 함수는 당신 컴퓨터의 long 과 double 형의 범위 +안에서만 값들을 다룬다. + 만약 더 큰 수를 다루고자 한다면 <link linkend="ref.bc">arbitrary +precision math functions</link> 를 보라. + </para> + <sect2 id="math.constants"> + <title>Math constants</title> + <para> + 다음의 값들은 PHP에서 math extension에 의해 정의된 상수 +이다.: + <table> + <title>Math constants</title> + <tgroup cols="3"> + <thead> + <row> + +<entry>상수</entry> + +<entry>값</entry> + +<entry>설명</entry> + </row> + </thead> + <tbody> + <row> + +<entry>M_PI</entry> + +<entry>3.14159265358979323846</entry> + +<entry>Pi</entry> + </row> + <row> + +<entry>M_E</entry> + +<entry>2.7182818284590452354</entry> + +<entry>e</entry> + </row> + <row> + +<entry>M_LOG2E</entry> + +<entry>1.4426950408889634074</entry> + <entry>log_2 +e</entry> + </row> + <row> + +<entry>M_LOG10E</entry> + +<entry>0.43429448190325182765</entry> + <entry>log_10 +e</entry> + </row> + <row> + +<entry>M_LN2</entry> + +<entry>0.69314718055994530942</entry> + <entry>log_e +2</entry> + </row> + <row> + +<entry>M_LN10</entry> + +<entry>2.30258509299404568402</entry> + <entry>log_e +10</entry> + </row> + <row> + +<entry>M_PI_2</entry> + +<entry>1.57079632679489661923</entry> + +<entry>pi/2</entry> + </row> + <row> + +<entry>M_PI_4</entry> + +<entry>0.78539816339744830962</entry> + +<entry>pi/4</entry> + </row> + <row> + +<entry>M_1_PI</entry> + +<entry>0.31830988618379067154</entry> + +<entry>1/pi</entry> + </row> + <row> + +<entry>M_2_PI</entry> + +<entry>0.63661977236758134308</entry> + +<entry>2/pi</entry> + </row> + <row> + +<entry>M_SQRTPI</entry> + +<entry>1.77245385090551602729</entry> + +<entry>sqrt(pi) [4.0.2]</entry> + </row> + <row> + +<entry>M_2_SQRTPI</entry> + +<entry>1.12837916709551257390</entry> + +<entry>2/sqrt(pi)</entry> + </row> + <row> + +<entry>M_SQRT2</entry> + +<entry>1.41421356237309504880</entry> + +<entry>sqrt(2)</entry> + </row> + <row> + +<entry>M_SQRT3</entry> + +<entry>1.73205080756887729352</entry> + <entry>sqrt(3) +[4.0.2]</entry> + </row> + <row> + +<entry>M_SQRT1_2</entry> + +<entry>0.70710678118654752440</entry> + +<entry>1/sqrt(2)</entry> + </row> + <row> + +<entry>M_LNPI</entry> + +<entry>1.14472988584940017414</entry> + +<entry>log_e(pi) [4.0.2]</entry> + </row> + <row> + +<entry>M_EULER</entry> + +<entry>0.57721566490153286061</entry> + <entry>Euler +constant [4.0.2]</entry> + </row> + </tbody> + </tgroup> + </table> + PHP4RC1 까지는 단지 M_PI 만이 유용하며, 다른 모든 상수들은 + PHP 4.0. 이후에 가능하다. + [4.0.2]라는 라벨이 붙은 상수는 PHP 4.0.2. 에서 추가된 +상수이다. + </para> + </sect2> + </sect1> + </partintro> + <refentry id="function.abs"> + <refnamediv> + <refname>abs</refname> + <refpurpose>절대값</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>abs</function> + </funcdef> + <paramdef>mixed <parameter>number</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + 숫자의 절대값을 반환한다. + 인자로 온 숫자가 float 형이면 반환 타입도 역시 float 이며, +이는 다른 형에 대해서도 동일하다. + </para> + </refsect1> + </refentry> + <refentry id="function.acos"> + <refnamediv> + <refname>acos</refname> + <refpurpose>아크 코사인(Arc cosine)</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>acos</function> + </funcdef> + <paramdef>float <parameter>arg</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <parameter>arg</parameter>의 아크 코사인(Arc +cosine) 값을 라디인으로 반환한다. + </para> + <para> + <function>asin</function> 그리고 +<function>atan</function>을 참고하라. + </para> + </refsect1> + </refentry> + <refentry id="function.asin"> + <refnamediv> + <refname>asin</refname> + <refpurpose>아크 사인(Arc sine)</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>asin</function> + </funcdef> + <paramdef>float <parameter>arg</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <parameter>arg</parameter>의 아크 사인(Arc sine) +라디인으로 값을 반환한다. + </para> + <para> + <function>acos</function> 그리고 +<function>atan</function>을 참고하라. + </para> + </refsect1> + </refentry> + <refentry id="function.atan"> + <refnamediv> + <refname>atan</refname> + <refpurpose>아크 탄젠트(Arc tangent)</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>atan</function> + </funcdef> + <paramdef>float <parameter>arg</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <parameter>arg</parameter>의 아크 탄젠트(Arc +tangent)값을 라디인으로 반환한다. + </para> + <para> + <function>asin</function> 그리고 +<function>acos</function>을 참고하라. + </para> + </refsect1> + </refentry> + <refentry id="function.atan2"> + <refnamediv> + <refname>atan2</refname> + <refpurpose>두 변수의 아크 탄젠트(arc +tangent)</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>atan2</function> + </funcdef> + <paramdef>float <parameter>y</parameter> + </paramdef> + <paramdef>float <parameter>x</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + 이 함수는 두 변수 <parameter>x</parameter> 와 +<parameter>y</parameter>의 + 아크 탄젠트(arc tangent) 값을 반환한다. + 이는 각 인자들의 부호가 결과의 4분구간을 결정하는데 +사용된다는 점을 제외하고는 + <parameter>y</parameter> / <parameter>x</parameter>의 + 아크 탄젠트 값을 계산하는 것과 동일하다. + </simpara> + <simpara> + 이 함수는 결과는 라디안으로 반환하는데 그 범위는 -PI +보다 크거나 같고 + PI 보다 작거나 같은 값의 범위가 된다. + </simpara> + <para> + <function>acos</function> 그리고 +<function>atan</function>을 참고하라. + </para> + </refsect1> + </refentry> + <refentry id="function.base-convert"> + <refnamediv> + <refname>base_convert</refname> + <refpurpose>임의의 베이스(arbitrary bases) 사이에서 +숫자를 변환한다.</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>string +<function>base_convert</function> + </funcdef> + <paramdef>string <parameter>number</parameter> + </paramdef> + <paramdef>int <parameter>frombase</parameter> + </paramdef> + <paramdef>int <parameter>tobase</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <parameter>number</parameter>에 해당하는 문자열 + <parameter>tobase</parameter> 베이스로 바꾸어 반환한다. + <parameter>number</parameter>의 베이스는 + <parameter>frombase</parameter>에서 명시된다. + <parameter>frombase</parameter> 와 <parameter>tobase</parameter>는 + 둘 다 2 보다 크거나 같고 36 보다 작거나 같은 값이 와야 +한다. + 10 보다 큰 숫자(digit) a에서 z 까지의 문자로 나타내며, + a 는 10을 b는 11을 그리고 z는 35에 해당하는 숫자를 +나타낸다. + <example> + <title> + <function>Base_convert</function> + </title> + <programlisting role="php"> +$binary = base_convert ($hexadecimal, 16, 2); +</programlisting> + </example> + </para> + </refsect1> + </refentry> + <refentry id="function.bindec"> + <refnamediv> + <refname>bindec</refname> + <refpurpose>2진수를 10진수로 바꾼다.</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>bindec</function> + </funcdef> + <paramdef>string +<parameter>binary_string</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + 2진 문자열 에 의해 표현되는 2진수를 동일한 10진수로 +반환한다. + </para> + <para> + bindec 는 2진수를 10진수로 변환한다. + 변환될 수 있는 가장 큰 수는 1의 +31비트(1111111111111111111111111111111), + 십진수로 2147483647 이다. + </para> + <para> + <function>decbin</function> 함수를 참고하라. + </para> + </refsect1> + </refentry> + <refentry id="function.ceil"> + <refnamediv> + <refname>ceil</refname> + <refpurpose>올림한다.</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>ceil</function> + </funcdef> + <paramdef>float <parameter>number</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <parameter>number</parameter>보다 크거나 같은 +가장 큰 정수를 반환한다.(올림) + 정수에 <function>ceil</function>를 쓰는 것은 시간 낭비일 +뿐이다. + <informalexample> + <programlisting role="php"> +$x = ceil(4.25); +// $x=5 의 값을 갖는다. + </programlisting> + </informalexample> + </para> + <simpara> + 주의: PHP/FI 2 의 <function>ceil</function> 함수는 float 형을 +반환했다. + 사용: PHP/FI 2 의 결과를 얻기 위해 <literal>$new = +(double)ceil($number);</literal> 를 사용하라. + </simpara> + <simpara> + <function>floor</function> 그리고 + <function>round</function>를 참고하라. + </simpara> + </refsect1> + </refentry> + <refentry id="function.cos"> + <refnamediv> + <refname>cos</refname> + <refpurpose>코사인</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>cos</function> + </funcdef> + <paramdef>float <parameter>arg</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + arg의 코사인 값을 라디안으로 반환한다. + </para> + <para> + See also <function>sin</function> and <function>tan</function>. + </para> + </refsect1> + </refentry> + <refentry id="function.decbin"> + <refnamediv> + <refname>decbin</refname> + <refpurpose>10진수를 2진수로</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>decbin</function> + </funcdef> + <paramdef>int <parameter>number</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + 주어진 숫자를 2진표현을 포함하는 문자열로 반환한다. + 변환될 수 있는 가장 큰 수는 십진수로 2147483647 이므로 + 결과는 1의 31비트(1111111111111111111111111111111)가 된다. + </para> + <para> + <function>bindec</function> 함수를 참고하라. + </para> + </refsect1> + </refentry> + <refentry id="function.dechex"> + <refnamediv> + <refname>dechex</refname> + <refpurpose>10진수를 16진수로</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>dechex</function> + </funcdef> + <paramdef>int <parameter>number</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + 주어진 숫자를 16진수를 표현하는 문자열로 반환한다. + 변환될 수 있는 가장 큰 수는 십진수로 2147483647이므로 + 결과는 16진수로 "7fffffff" 가 된다. + </para> + <para> + See also the <function>hexdec</function> function. + </para> + </refsect1> + </refentry> + <refentry id="function.decoct"> + <refnamediv> + <refname>decoct</refname> + <refpurpose>십진수를 8진수로</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>string <function>decoct</function> + </funcdef> + <paramdef>int <parameter>number</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + 주어진 숫자를 8진수 형태로 표현하는 문자열을 반환한다. + 변환될 수 있는 가장 큰 수는 십진수로 2147483647이며 + 결과는 "17777777777" 이 된다. + </para> + <para> + <function>octdec</function>를 참고하라. + </para> + </refsect1> + </refentry> + <refentry id="function.deg2rad"> + <refnamediv> + <refname>deg2rad</refname> + <refpurpose> + 각도(degree)를 동일한 라디안 값으로 변환한다. + </refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>double <function>deg2rad</function> + </funcdef> + <paramdef>double <parameter>number</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + 이 함수는 <parameter>number</parameter>를 각도(degree)에서 동일한 +라디안 값으로 변환한다. + </para> + <para> + <function>rad2deg</function>를 참고하라. + </para> + </refsect1> + </refentry> + <refentry id="function.exp"> + <refnamediv> + <refname>exp</refname> + <refpurpose>e 의 승수</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>exp</function> + </funcdef> + <paramdef>float <parameter>arg</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + e(2.718...)의 <parameter>arg</parameter>승을 반환한다. + </para> + <para> + <function>pow</function>을 참고하라. + </para> + </refsect1> + </refentry> + <refentry id="function.floor"> + <refnamediv> + <refname>floor</refname> + <refpurpose>값을 내림한다.</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>floor</function> + </funcdef> + <paramdef>float <parameter>number</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <parameter>number</parameter>보다 작거나 같은 가장 작은 정수를 +반환한다. + <function>floor</function>에 정수를 사용하는 것은 시간 낭비일 +뿐이다. + </simpara> + <simpara> + 주의 : PHP/FI 2 에서 <function>floor</function>는 float 형을 +반환했다. + 이 버젼의 효과를 내기 위해 <literal>$new = +(double)floor($number);</literal>를 사용하라. + </simpara> + <simpara> + <function>ceil</function> 그리고 + <function>round</function>를 참고하라. + </simpara> + </refsect1> + </refentry> + <refentry id="function.getrandmax"> + <refnamediv> + <refname>getrandmax</refname> + <refpurpose>가능한 가장 큰 임의이 값을 +보여준다.</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>getrandmax</function> + </funcdef> + <paramdef>void </paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>rand</function> 함수의 호출에 의해 받을 수 있는 가장 +큰 값을 반환한다. + </simpara> + <simpara> + <function>rand</function>, <function>srand</function>, + <function>mt_rand</function>, <function>mt_srand</function>, 그리고 + <function>mt_getrandmax</function>을 참고하라. + </simpara> + </refsect1> + </refentry> + <refentry id="function.hexdec"> + <refnamediv> + <refname>hexdec</refname> + <refpurpose>16진수를 10진수로 변환한다.</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>hexdec</function> + </funcdef> + <paramdef>string +<parameter>hex_string</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + 16진수 숫자에 해당하는 10진수 값을 10진수 형태로 +반환한다. + HecDec는 16진수 문자열을 10진수 문자열로 변환하며, + 변환될 수 있는 가장 큰 수는 7fffffff 이거나 10진수로 +2147483647 이다. + </para> + <para> + <function>dechex</function>함수를 참고하라. + </para> + </refsect1> + </refentry> + <refentry id="function.lcg-value"> + <refnamediv> + <refname>lcg_value</refname> + <refpurpose>Combined linear congruential generator</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>double <function>lcg_value</function> + </funcdef> + <void/> + </funcprototype> + </funcsynopsis> + <para> + <function>lcg_value</function>는 (0, 1) 사이의 의사 랜덤 숫자(pseudo +number)를 반환한다. + 이 함수는 2^31 - 85 와 2^31 - 249 사이의 두개의 CG를 조합한다. + 이 함수의 구간은 두 소수의 산물과 일치한다. + (The period of this function is equal to the product of both primes.) + </para> + </refsect1> + </refentry> + <refentry id="function.log"> + <refnamediv> + <refname>log</refname> + <refpurpose>자연로그</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>log</function> + </funcdef> + <paramdef>float <parameter>arg</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + arg의 자연로그를 반환한다. + </para> + </refsect1> + </refentry> + <refentry id="function.log10"> + <refnamediv> + <refname>log10</refname> + <refpurpose>상용로그</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>log10</function> + </funcdef> + <paramdef>float <parameter>arg</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <parameter>arg</parameter>의 사용로그 값을 반환한다. + </para> + </refsect1> + </refentry> + <refentry id="function.max"> + <refnamediv> + <refname>max</refname> + <refpurpose>가장 큰 값을 찾는다.</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>max</function> + </funcdef> + <paramdef>mixed <parameter>arg1</parameter> + </paramdef> + <paramdef>mixed <parameter>arg2</parameter> + </paramdef> + <paramdef>mixed <parameter>argn</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>max</function>는 매개 변수의 값 중 숫자로 표시되는 +가장 큰 값을 반환한다. + </para> + <para> + 처음 매개변수가 배열이라면, <function>max</function>는 + 그 배열에 있는 값 중 가장 큰 값을 반환한다. + 처음 매개변수가 정수, 문자열 혹은 더블형이라면, + 최소한 두개의 매개 변수가 필요하며, <function>max</function> 는 + 이 값들 중 가장 큰 값을 반환한다. + 비교되는 값들의 수는 무재한이다. + </para> + <para> + 하나 혹은 그 이상의 값이 더블형이라며느 모든 값은 +더블형으로 여겨지며, + 더블형이 반환된다. + 어느것 하나도 더블형이 아니면, 모든 것이 정수로 +여겨지며, 정수형이 반환된다. + </para> + </refsect1> + </refentry> + <refentry id="function.min"> + <refnamediv> + <refname>min</refname> + <refpurpose>가장 작은 값을 찾는다.</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>mixed <function>min</function> + </funcdef> + <paramdef>mixed <parameter>arg1</parameter> + </paramdef> + <paramdef>mixed <parameter>arg2</parameter> + </paramdef> + <paramdef>mixed <parameter>argn</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>Min</function>는 매개변수의 값 중 숫자로 표시되는 +가장 작은 값을 반환한다. + </para> + <para> + 처음 매개변수가 배열이라면, <function>min</function>은 + 그 배열에 있는 값 중 가장 작은 값을 반환한다. + 처음 매개변수가 정수, 문자열 혹은 더블형이라면, + 최소한 두개의 매개 변수가 필요하며, <function>min</function>은 + 이 값들 중 가장 작은 값을 반환한다. + 비교되는 값들의 수는 무재한이다. + </para> + <para> + 하나 혹은 그 이상의 값이 더블형이라며느 모든 값은 +더블형으로 여겨지며, + 더블형이 반환된다. + 어느것 하나도 더블형이 아니면, 모든 것이 정수로 +여겨지며, 정수형이 반환된다. + </para> + </refsect1> + </refentry> + <refentry id="function.mt-rand"> + <refnamediv> + <refname>mt_rand</refname> + <refpurpose>더 좋은 랜덤값을 생성한다.</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>mt_rand</function> + </funcdef> + <paramdef>int + <parameter> + <optional>min</optional> + </parameter> + </paramdef> + <paramdef>int + <parameter> + <optional>max</optional> + </parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + 예전 libc의 많은 난수 생성기는 모호하거나 혹은 + unknown characteristics를 갖고 있으며 느리다. + 기본적으로 PHP의 <function>rand</function>함수는 + libc 난수 생성기를 사용한다. + <function>mt_rand</function> 함수는 이를 위한 + 드롭-인 교체(drop-in replacement) 이다. + 이 함수는 난수 발생기로 known characteristics를 사용하며, + Many random number generators of older libcs have or + unknown characteristics and are slow. By default, PHP uses the + libc random number generator with the <function>rand</function> + function. <function>mt_rand</function> function is a drop-in + replacement for this. It uses a random number generator with + known characteristics, the Mersenne Twister, which will produce + random numbers that should be suitable for seeding some kinds + of cryptography (see the home pages for details) and is four + times faster than what the average libc provides. The Homepage + of the Mersenne Twister can be found at + <ulink url="&url.mersenne;">&url.mersenne;</ulink>, and an + optimized version of the MT source is available from + <ulink url="&url.mersenne.twister;">&url.mersenne.twister; + </ulink>. + </simpara> + <simpara> + If called without the optional <parameter>min</parameter>, + <parameter>max</parameter> arguments <function>mt_rand</function> + returns a pseudo-random value between 0 and + <constant>RAND_MAX</constant>. If you want a random number + between 5 and 15 (inclusive), for example, use <literal>mt_rand + (5, 15)</literal>. + </simpara> + <simpara> + Remember to seed the random number generator before use with + <function>mt_srand</function>. + </simpara> + <note> + <para> + In versions before 3.0.7 the meaning of + <parameter>max</parameter> was <parameter>range</parameter>. To + get the same results in these versions the short example should + be <literal>mt_rand (5, 11)</literal> to get a random number + between 5 and 15. + </para> + </note> + <simpara> + See also <function>mt_srand</function>, + <function>mt_getrandmax</function>, <function>srand</function>, + <function>rand</function> and <function>getrandmax</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.mt-srand"> + <refnamediv> + <refname>mt_srand</refname> + <refpurpose>Seed the better random number +generator</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>mt_srand</function> + </funcdef> + <paramdef>int <parameter>seed</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Seeds the random number generator with + <parameter>seed</parameter>. + <informalexample> + <programlisting role="php"> +// seed with microseconds since last "whole" second +mt_srand ((double) microtime() * 1000000); +$randval = mt_rand(); + </programlisting> + </informalexample> + </para> + <simpara> + See also <function>mt_rand</function>, + <function>mt_getrandmax</function>, <function>srand</function>, + <function>rand</function>, and + <function>getrandmax</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.mt-getrandmax"> + <refnamediv> + <refname>mt_getrandmax</refname> + <refpurpose>가장 큰 랜덤값을 보여준다.</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>mt_getrandmax</function> + </funcdef> + <paramdef>void </paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <function>mt_rand</function>의 호출에 의해 반환될 수 있는 가장 +큰 값을 반환한다. + </simpara> + <simpara> + <function>mt_rand</function>, + <function>mt_srand</function> + <function>rand</function>, + <function>srand</function>, 그리고 + <function>getrandmax</function>을 참고하라. + </simpara> + </refsect1> + </refentry> + <refentry id="function.number-format"> + <refnamediv> + <refname>number_format</refname> + <refpurpose>숫자를 천단위로 묶어서 +표현한다.</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>string +<function>number_format</function> + </funcdef> + <paramdef>float <parameter>number</parameter> + </paramdef> + <paramdef>int <parameter>decimals</parameter> + </paramdef> + <paramdef>string +<parameter>dec_point</parameter> + </paramdef> + <paramdef>string +<parameter>thousands_sep</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>Number_format</function>은 <parameter>number</parameter>의 +정형화된 형테를 반환한다. + 이 함수는 하나, 두개 혹은 네개(세개는 올 수 없다.)의 +매개변수를 가질 수 있다. + </para> + <para> + 하나의 매개변수만 주어지면, 그냥 숫자가 아닌 매 +천단위마다 콤마(",")를 가진 형태가 반환된다. + (역자주:소수 이하자리는 반올림 된다.) + </para> + <para> + 두개의 매개변수가 주어지면, <parameter>number</parameter>는 + <parameter>decimals</parameter>자리 소수점을 가지고 천단위마다 +콤마(",")가 + 붙은 형태가 반환된다. + </para> + <para> + 매개변수 4개가 주어지면, <parameter>number</parameter>는 + <parameter>decimals</parameter>자리의 소수점을 갖고, + dot(".") 대신 <parameter>dec_point</parameter>개 대체되며, + 천단위 마다 사용 된 콤마 (",") 대신 +<parameter>thousands_sep</parameter>가 + 적용된 형태가 반환된다. + </para> + </refsect1> + </refentry> + <refentry id="function.octdec"> + <refnamediv> + <refname>octdec</refname> + <refpurpose>8진수를 10진수로</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>octdec</function> + </funcdef> + <paramdef>string +<parameter>octal_string</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + 8진수 형태로 표현되는 octal_string 인자를 이해 해당하는 +8진수와 동등한 + 10진수로 반환한다. + OctDec는 8진수를 10진수로 반환한다. + 변환될 수 있는 가장 큰 값은 17777777777 혹은 10진수로 +2147483647 이다. + </para> + <para> + <function>decoct</function>를 참고하라. + </para> + </refsect1> + </refentry> + <refentry id="function.pi"> + <refnamediv> + <refname>pi</refname> + <refpurpose>파이(pi)값을 얻는다.</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>double <function>pi</function> + </funcdef> + <paramdef>void </paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + 파이(pi)의 근사값을 반환한다. + </simpara> + </refsect1> + </refentry> + <refentry id="function.pow"> + <refnamediv> + <refname>pow</refname> + <refpurpose>거듭제곱</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>pow</function> + </funcdef> + <paramdef>float <parameter>base</parameter> + </paramdef> + <paramdef>float <parameter>exp</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <parameter>base</parameter>의 <parameter>exp</parameter>승 값을 +반환한다. + </para> + <para> + <function>exp</function>을 참고하라. + </para> + </refsect1> + </refentry> + <refentry id="function.rad2deg"> + <refnamediv> + <refname>rad2deg</refname> + <refpurpose> + 라디안을 각도로 변환한다. + </refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>double <function>rad2deg</function> + </funcdef> + <paramdef>double <parameter>number</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + 이 함수는 <parameter>number</parameter>을 라디안에서 각도로 +변환한다. + </para> + <para> + <function>deg2rad</function>을 참고하라. + </para> + </refsect1> + </refentry> + <refentry id="function.rand"> + <refnamediv> + <refname>rand</refname> + <refpurpose>난수를 발생한다.</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>rand</function> + </funcdef> + <paramdef> + <parameter> + <optional>int min</optional> + </parameter> + </paramdef> + <paramdef> + <parameter> + <optional>int max</optional> + </parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <simpara> + <parameter>min</parameter>없이 호출되면, + If called without the optional <parameter>min</parameter>, + <parameter>max</parameter> arguments <function>rand</function> + returns a pseudo-random value between 0 and + <constant>RAND_MAX</constant>. If you want a random number + between 5 and 15 (inclusive), for example, use <literal>rand (5, + 15)</literal>. + </simpara> + <simpara> + Remember to seed the random number generator before use with + <function>srand</function>. + </simpara> + <note> + <para> + In versions before 3.0.7 the meaning of + <parameter>max</parameter> was <parameter>range</parameter>. To + get the same results in these versions the short example should + be <literal>rand (5, 11)</literal> to get a random number + between 5 and 15. + </para> + </note> + <simpara> + See also <function>srand</function>, + <function>getrandmax</function>, <function>mt_rand</function>, + <function>mt_srand</function>, and + <function>mt_getrandmax</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.round"> + <refnamediv> + <refname>round</refname> + <refpurpose>실수를 반올림한다.</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>double <function>round</function> + </funcdef> + <paramdef>double <parameter>val</parameter> + </paramdef> + <paramdef>int + <parameter> + <optional>precision</optional> + </parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + 소수점 <parameter>precision</parameter> 자리(소수점 이후의 +자리수)까지 + <parameter>val</parameter>을 반올림한다. + <informalexample> + <programlisting role="php"> +$foo = round (3.4); // $foo == 3.0 +$foo = round (3.5); // $foo == 4.0 +$foo = round (3.6); // $foo == 4.0 + +$foo = round (1.95583, 2); // $foo == 1.96 + </programlisting> + </informalexample> + </para> + <note> + <simpara> + <parameter>precision</parameter> 는 PHP 4 에서만 +유용하다. + </simpara> + </note> + <simpara> + <function>ceil</function> 그리고 + <function>floor</function>을 참고하라. + </simpara> + </refsect1> + </refentry> + <refentry id="function.sin"> + <refnamediv> + <refname>sin</refname> + <refpurpose>사인</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>sin</function> + </funcdef> + <paramdef>float <parameter>arg</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + arg의 사인값을 라디안으로 반환한다. + </para> + <para> + <function>cos</function> 그리고 <function>tan</function>을 참고하라. + </para> + </refsect1> + </refentry> + <refentry id="function.sqrt"> + <refnamediv> + <refname>sqrt</refname> + <refpurpose>평방제곱근(루트)</refpurpose> + </refnamediv> + <refsect1> + <title>설명</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>sqrt</function> + </funcdef> + <paramdef>float <parameter>arg</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <parameter>arg</parameter>의 평방제곱근을 반환한다. + </para> + </refsect1> + </refentry> + <refentry id="function.srand"> + <refnamediv> + <refname>srand</refname> + <refpurpose>Seed the random number generator</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>void <function>srand</function> + </funcdef> + <paramdef>int <parameter>seed</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Seeds the random number generator with + <parameter>seed</parameter>. + <informalexample> + <programlisting role="php"> +// seed with microseconds since last "whole" second +srand ((double) microtime() * 1000000); +$randval = rand(); + </programlisting> + </informalexample> + </para> + <simpara> + See also <function>rand</function>, + <function>getrandmax</function>, <function>mt_rand</function>, + <function>mt_srand</function>, and + <function>mt_getrandmax</function>. + </simpara> + </refsect1> + </refentry> + <refentry id="function.tan"> + <refnamediv> + <refname>tan</refname> + <refpurpose>Tangent</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>float <function>tan</function> + </funcdef> + <paramdef>float <parameter>arg</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + Returns the tangent of arg in radians. + </para> + <para> + See also <function>sin</function> and <function>cos</function>. + </para> + </refsect1> + </refentry> +</reference> +<!-- Keep this comment at the end of the file +Local variables: +mode: sgml +sgml-omittag:t +sgml-shorttag:t +sgml-minimize-attributes:nil +sgml-always-quote-attributes:t +sgml-indent-step:1 +sgml-indent-data:t +sgml-parent-document:nil +sgml-default-dtd-file:"../../manual.ced" +sgml-exposed-tags:nil +sgml-local-catalogs:nil +sgml-local-ecat-files:nil +End: +-->