diff options
author | Raymond Hettinger <rhettinger@users.noreply.github.com> | 2019-06-01 22:01:46 (GMT) |
---|---|---|
committer | GitHub <noreply@github.com> | 2019-06-01 22:01:46 (GMT) |
commit | b7fade4f87e0d37d1686a4e8596141e55ecef099 (patch) | |
tree | 336c73888df0811bbcbaf485e0bf92b9d5f48eec /Doc/library/math.rst | |
parent | 6a150bcaeb190d1731b38ab9c7a5d1a352847ddc (diff) | |
download | cpython-b7fade4f87e0d37d1686a4e8596141e55ecef099.zip cpython-b7fade4f87e0d37d1686a4e8596141e55ecef099.tar.gz cpython-b7fade4f87e0d37d1686a4e8596141e55ecef099.tar.bz2 |
Put math.comb() docs is correct place alphabetically (GH-13734)
Diffstat (limited to 'Doc/library/math.rst')
-rw-r--r-- | Doc/library/math.rst | 30 |
1 files changed, 15 insertions, 15 deletions
diff --git a/Doc/library/math.rst b/Doc/library/math.rst index 206b06e..8c68370 100644 --- a/Doc/library/math.rst +++ b/Doc/library/math.rst @@ -36,6 +36,21 @@ Number-theoretic and representation functions :class:`~numbers.Integral` value. +.. function:: comb(n, k) + + Return the number of ways to choose *k* items from *n* items without repetition + and without order. + + Also called the binomial coefficient. It is mathematically equal to the expression + ``n! / (k! (n - k)!)``. It is equivalent to the coefficient of the *k*-th term in the + polynomial expansion of the expression ``(1 + x) ** n``. + + Raises :exc:`TypeError` if the arguments not integers. + Raises :exc:`ValueError` if the arguments are negative or if *k* > *n*. + + .. versionadded:: 3.8 + + .. function:: copysign(x, y) Return a float with the magnitude (absolute value) of *x* but the sign of @@ -232,21 +247,6 @@ Number-theoretic and representation functions :meth:`x.__trunc__() <object.__trunc__>`. -.. function:: comb(n, k) - - Return the number of ways to choose *k* items from *n* items without repetition - and without order. - - Also called the binomial coefficient. It is mathematically equal to the expression - ``n! / (k! (n - k)!)``. It is equivalent to the coefficient of the *k*-th term in the - polynomial expansion of the expression ``(1 + x) ** n``. - - Raises :exc:`TypeError` if the arguments not integers. - Raises :exc:`ValueError` if the arguments are negative or if *k* > *n*. - - .. versionadded:: 3.8 - - Note that :func:`frexp` and :func:`modf` have a different call/return pattern than their C equivalents: they take a single argument and return a pair of values, rather than returning their second return value through an 'output |