mirrors/cpython
0
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2024-11-25 02:44:06 +08:00
Code Issues Packages Projects Releases Wiki Activity

Part of SF patch [#431848] mathmodule.c: doc strings & conversion, from

Browse Source 
Peter Schneider-Kamp.
Clarified some docstrings in the spirit of the patch; left out the
degrees() and radians() functions (see the patch comments on SF).
This commit is contained in:
Tim Peters 2001-08-07 22:10:00 +00:00
parent 54e99e8b3b
commit fe71f81367
1 changed files with 18 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
Modules/mathmodule.c
View File

@ -51,7 +51,7 @@ is_error(double x)
* the result for zero suffices to distinguish the cases). * the result for zero suffices to distinguish the cases).
*/ */
if (x) if (x)
PyErr_SetString(PyExc_OverflowError, PyErr_SetString(PyExc_OverflowError,
"math range error"); "math range error");
else else
result = 0; result = 0;
@ -109,25 +109,28 @@ math_2(PyObject *args, double (*func) (double, double), char *argsfmt)
static char math_##funcname##_doc [] = docstring; static char math_##funcname##_doc [] = docstring;
FUNC1(acos, acos, FUNC1(acos, acos,
"acos(x)\n\nReturn the arc cosine of x.") "acos(x)\n\nReturn the arc cosine (measured in radians) of x.")
FUNC1(asin, asin, FUNC1(asin, asin,
"asin(x)\n\nReturn the arc sine of x.") "asin(x)\n\nReturn the arc sine (measured in radians) of x.")
FUNC1(atan, atan, FUNC1(atan, atan,
"atan(x)\n\nReturn the arc tangent of x.") "atan(x)\n\nReturn the arc tangent (measured in radians) of x.")
FUNC2(atan2, atan2, FUNC2(atan2, atan2,
"atan2(y, x)\n\nReturn atan(y/x).") "atan2(y, x)\n\nReturn the arc tangent (measured in radians) of y/x.\n"
"Unlike atan(y/x), the signs of both x and y are considered.")
FUNC1(ceil, ceil, FUNC1(ceil, ceil,
"ceil(x)\n\nReturn the ceiling of x as a real.") "ceil(x)\n\nReturn the ceiling of x as a float.\n"
"This is the smallest integral value >= x.")
FUNC1(cos, cos, FUNC1(cos, cos,
"cos(x)\n\nReturn the cosine of x.") "cos(x)\n\nReturn the cosine of x (measured in radians).")
FUNC1(cosh, cosh, FUNC1(cosh, cosh,
"cosh(x)\n\nReturn the hyperbolic cosine of x.") "cosh(x)\n\nReturn the hyperbolic cosine of x.")
FUNC1(exp, exp, FUNC1(exp, exp,
"exp(x)\n\nReturn e raised to the power of x.") "exp(x)\n\nReturn e raised to the power of x.")
FUNC1(fabs, fabs, FUNC1(fabs, fabs,
"fabs(x)\n\nReturn the absolute value of the real x.") "fabs(x)\n\nReturn the absolute value of the float x.")
FUNC1(floor, floor, FUNC1(floor, floor,
"floor(x)\n\nReturn the floor of x as a real.") "floor(x)\n\nReturn the floor of x as a float.\n"
"This is the largest integral value <= x.")
FUNC2(fmod, fmod, FUNC2(fmod, fmod,
"fmod(x,y)\n\nReturn fmod(x, y), according to platform C." "fmod(x,y)\n\nReturn fmod(x, y), according to platform C."
" x % y may differ.") " x % y may differ.")
@ -139,19 +142,19 @@ FUNC1(log10, log10,
"log10(x)\n\nReturn the base-10 logarithm of x.") "log10(x)\n\nReturn the base-10 logarithm of x.")
#ifdef MPW_3_1 /* This hack is needed for MPW 3.1 but not for 3.2 ... */ #ifdef MPW_3_1 /* This hack is needed for MPW 3.1 but not for 3.2 ... */
FUNC2(pow, power, FUNC2(pow, power,
"pow(x,y)\n\nReturn x**y.") "pow(x,y)\n\nReturn x**y (x to the power of y).")
#else #else
FUNC2(pow, pow, FUNC2(pow, pow,
"pow(x,y)\n\nReturn x**y.") "pow(x,y)\n\nReturn x**y (x to the power of y).")
#endif #endif
FUNC1(sin, sin, FUNC1(sin, sin,
"sin(x)\n\nReturn the sine of x.") "sin(x)\n\nReturn the sine of x (measured in radians).")
FUNC1(sinh, sinh, FUNC1(sinh, sinh,
"sinh(x)\n\nReturn the hyperbolic sine of x.") "sinh(x)\n\nReturn the hyperbolic sine of x.")
FUNC1(sqrt, sqrt, FUNC1(sqrt, sqrt,
"sqrt(x)\n\nReturn the square root of x.") "sqrt(x)\n\nReturn the square root of x.")
FUNC1(tan, tan, FUNC1(tan, tan,
"tan(x)\n\nReturn the tangent of x.") "tan(x)\n\nReturn the tangent of x (measured in radians).")
FUNC1(tanh, tanh, FUNC1(tanh, tanh,
"tanh(x)\n\nReturn the hyperbolic tangent of x.") "tanh(x)\n\nReturn the hyperbolic tangent of x.")
@ -198,7 +201,7 @@ math_ldexp(PyObject *self, PyObject *args)
return PyFloat_FromDouble(x); return PyFloat_FromDouble(x);
} }
static char math_ldexp_doc [] = static char math_ldexp_doc [] =
"ldexp_doc(x, i)\n\ "ldexp_doc(x, i)\n\
\n\ \n\
Return x * (2**i)."; Return x * (2**i).";
@ -270,7 +273,7 @@ DL_EXPORT(void)
initmath(void) initmath(void)
{ {
PyObject *m, *d, *v; PyObject *m, *d, *v;
m = Py_InitModule3("math", math_methods, module_doc); m = Py_InitModule3("math", math_methods, module_doc);
d = PyModule_GetDict(m); d = PyModule_GetDict(m);