Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit 752eb31

Browse files
mattwang44mattwang44
committed
Deploying to gh-pages from @ 4a00826 🚀
1 parent 9194076 commit 752eb31

File tree

586 files changed

+1730
-1575
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

586 files changed

+1730
-1575
lines changed

‎.buildinfo

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
# Sphinx build info version 1
22
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
3-
config: c25c4b6fc5d5d55aea294dde0c81d589
3+
config: a7af48a189f240be6fd51de8aee6bd41
44
tags: 645f666f9bcd5a90fca523b33c5a78b7

‎_sources/c-api/arg.rst.txt

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -280,10 +280,10 @@ Numbers
280280
length 1, to a C :c:expr:`int`.
281281

282282
``f`` (:class:`float`) [float]
283-
Convert a Python floating point number to a C :c:expr:`float`.
283+
Convert a Python floating-point number to a C :c:expr:`float`.
284284

285285
``d`` (:class:`float`) [double]
286-
Convert a Python floating point number to a C :c:expr:`double`.
286+
Convert a Python floating-point number to a C :c:expr:`double`.
287287

288288
``D`` (:class:`complex`) [Py_complex]
289289
Convert a Python complex number to a C :c:type:`Py_complex` structure.
@@ -607,10 +607,10 @@ Building values
607607
object of length 1.
608608
609609
``d`` (:class:`float`) [double]
610-
Convert a C :c:expr:`double` to a Python floating point number.
610+
Convert a C :c:expr:`double` to a Python floating-point number.
611611
612612
``f`` (:class:`float`) [float]
613-
Convert a C :c:expr:`float` to a Python floating point number.
613+
Convert a C :c:expr:`float` to a Python floating-point number.
614614
615615
``D`` (:class:`complex`) [Py_complex \*]
616616
Convert a C :c:type:`Py_complex` structure to a Python complex number.

‎_sources/c-api/float.rst.txt

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,20 +2,20 @@
22

33
.. _floatobjects:
44

5-
Floating Point Objects
5+
Floating-Point Objects
66
======================
77

8-
.. index:: pair: object; floating point
8+
.. index:: pair: object; floating-point
99

1010

1111
.. c:type:: PyFloatObject
1212
13-
This subtype of :c:type:`PyObject` represents a Python floating point object.
13+
This subtype of :c:type:`PyObject` represents a Python floating-point object.
1414

1515

1616
.. c:var:: PyTypeObject PyFloat_Type
1717
18-
This instance of :c:type:`PyTypeObject` represents the Python floating point
18+
This instance of :c:type:`PyTypeObject` represents the Python floating-point
1919
type. This is the same object as :class:`float` in the Python layer.
2020

2121

@@ -45,7 +45,7 @@ Floating Point Objects
4545
.. c:function:: double PyFloat_AsDouble(PyObject *pyfloat)
4646
4747
Return a C :c:expr:`double` representation of the contents of *pyfloat*. If
48-
*pyfloat* is not a Python floating point object but has a :meth:`~object.__float__`
48+
*pyfloat* is not a Python floating-point object but has a :meth:`~object.__float__`
4949
method, this method will first be called to convert *pyfloat* into a float.
5050
If :meth:`!__float__` is not defined then it falls back to :meth:`~object.__index__`.
5151
This method returns ``-1.0`` upon failure, so one should call

‎_sources/c-api/marshal.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ Numeric values are stored with the least significant byte first.
1515

1616
The module supports two versions of the data format: version 0 is the
1717
historical version, version 1 shares interned strings in the file, and upon
18-
unmarshalling. Version 2 uses a binary format for floating point numbers.
18+
unmarshalling. Version 2 uses a binary format for floating-point numbers.
1919
``Py_MARSHAL_VERSION`` indicates the current file format (currently 2).
2020

2121

‎_sources/c-api/module.rst.txt

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -342,7 +342,8 @@ The available slot types are:
342342
The *value* pointer of this slot must point to a function of the signature:
343343
344344
.. c:function:: PyObject* create_module(PyObject *spec, PyModuleDef *def)
345-
:noindex:
345+
:no-index-entry:
346+
:no-contents-entry:
346347
347348
The function receives a :py:class:`~importlib.machinery.ModuleSpec`
348349
instance, as defined in :PEP:`451`, and the module definition.
@@ -377,7 +378,8 @@ The available slot types are:
377378
The signature of the function is:
378379
379380
.. c:function:: int exec_module(PyObject* module)
380-
:noindex:
381+
:no-index-entry:
382+
:no-contents-entry:
381383
382384
If multiple ``Py_mod_exec`` slots are specified, they are processed in the
383385
order they appear in the *m_slots* array.

‎_sources/c-api/number.rst.txt

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -51,8 +51,8 @@ Number Protocol
5151
5252
Return a reasonable approximation for the mathematical value of *o1* divided by
5353
*o2*, or ``NULL`` on failure. The return value is "approximate" because binary
54-
floating point numbers are approximate; it is not possible to represent all real
55-
numbers in base two. This function can return a floating point value when
54+
floating-point numbers are approximate; it is not possible to represent all real
55+
numbers in base two. This function can return a floating-point value when
5656
passed two integers. This is the equivalent of the Python expression ``o1 / o2``.
5757
5858
@@ -177,8 +177,8 @@ Number Protocol
177177
178178
Return a reasonable approximation for the mathematical value of *o1* divided by
179179
*o2*, or ``NULL`` on failure. The return value is "approximate" because binary
180-
floating point numbers are approximate; it is not possible to represent all real
181-
numbers in base two. This function can return a floating point value when
180+
floating-point numbers are approximate; it is not possible to represent all real
181+
numbers in base two. This function can return a floating-point value when
182182
passed two integers. The operation is done *in-place* when *o1* supports it.
183183
This is the equivalent of the Python statement ``o1 /= o2``.
184184

‎_sources/faq/design.rst.txt

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,7 @@ operations. This means that as far as floating-point operations are concerned,
7070
Python behaves like many popular languages including C and Java.
7171

7272
Many numbers that can be written easily in decimal notation cannot be expressed
73-
exactly in binary floating-point. For example, after::
73+
exactly in binary floating point. For example, after::
7474

7575
>>> x = 1.2
7676

@@ -87,7 +87,7 @@ which is exactly::
8787
The typical precision of 53 bits provides Python floats with 15--16
8888
decimal digits of accuracy.
8989

90-
For a fuller explanation, please see the :ref:`floating point arithmetic
90+
For a fuller explanation, please see the :ref:`floating-point arithmetic
9191
<tut-fp-issues>` chapter in the Python tutorial.
9292

9393

‎_sources/faq/library.rst.txt

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -825,12 +825,12 @@ is simple::
825825
import random
826826
random.random()
827827
828-
This returns a random floating point number in the range [0, 1).
828+
This returns a random floating-point number in the range [0, 1).
829829
830830
There are also many other specialized generators in this module, such as:
831831
832832
* ``randrange(a, b)`` chooses an integer in the range [a, b).
833-
* ``uniform(a, b)`` chooses a floating point number in the range [a, b).
833+
* ``uniform(a, b)`` chooses a floating-point number in the range [a, b).
834834
* ``normalvariate(mean, sdev)`` samples the normal (Gaussian) distribution.
835835
836836
Some higher-level functions operate on sequences directly, such as:

‎_sources/faq/programming.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -869,7 +869,7 @@ How do I convert a string to a number?
869869
--------------------------------------
870870

871871
For integers, use the built-in :func:`int` type constructor, e.g. ``int('144')
872-
== 144``. Similarly, :func:`float` converts to floating-point,
872+
== 144``. Similarly, :func:`float` converts to a floating-point number,
873873
e.g. ``float('144') == 144.0``.
874874

875875
By default, these interpret the number as decimal, so that ``int('0144') ==

‎_sources/library/array.rst.txt

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99
--------------
1010

1111
This module defines an object type which can compactly represent an array of
12-
basic values: characters, integers, floating point numbers. Arrays are sequence
12+
basic values: characters, integers, floating-point numbers. Arrays are sequence
1313
types and behave very much like lists, except that the type of objects stored in
1414
them is constrained. The type is specified at object creation time by using a
1515
:dfn:`type code`, which is a single character. The following type codes are
@@ -253,7 +253,7 @@ The string representation is guaranteed to be able to be converted back to an
253253
array with the same type and value using :func:`eval`, so long as the
254254
:class:`~array.array` class has been imported using ``from array import array``.
255255
Variables ``inf`` and ``nan`` must also be defined if it contains
256-
corresponding floating point values.
256+
corresponding floating-point values.
257257
Examples::
258258

259259
array('l')

‎_sources/library/colorsys.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ The :mod:`colorsys` module defines bidirectional conversions of color values
1414
between colors expressed in the RGB (Red Green Blue) color space used in
1515
computer monitors and three other coordinate systems: YIQ, HLS (Hue Lightness
1616
Saturation) and HSV (Hue Saturation Value). Coordinates in all of these color
17-
spaces are floating point values. In the YIQ space, the Y coordinate is between
17+
spaces are floating-point values. In the YIQ space, the Y coordinate is between
1818
0 and 1, but the I and Q coordinates can be positive or negative. In all other
1919
spaces, the coordinates are all between 0 and 1.
2020

‎_sources/library/configparser.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1153,7 +1153,7 @@ ConfigParser Objects
11531153
.. method:: getfloat(section, option, *, raw=False, vars=None[, fallback])
11541154

11551155
A convenience method which coerces the *option* in the specified *section*
1156-
to a floating point number. See :meth:`get` for explanation of *raw*,
1156+
to a floating-point number. See :meth:`get` for explanation of *raw*,
11571157
*vars* and *fallback*.
11581158

11591159

‎_sources/library/decimal.rst.txt

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
:mod:`!decimal` --- Decimal fixed point and floating point arithmetic
1+
:mod:`!decimal` --- Decimal fixed-point and floating-point arithmetic
22
=====================================================================
33

44
.. module:: decimal
@@ -31,7 +31,7 @@
3131
--------------
3232

3333
The :mod:`decimal` module provides support for fast correctly rounded
34-
decimal floating point arithmetic. It offers several advantages over the
34+
decimal floating-point arithmetic. It offers several advantages over the
3535
:class:`float` datatype:
3636

3737
* Decimal "is based on a floating-point model which was designed with people
@@ -207,7 +207,7 @@ a decimal raises :class:`InvalidOperation`::
207207
.. versionchanged:: 3.3
208208

209209
Decimals interact well with much of the rest of Python. Here is a small decimal
210-
floating point flying circus:
210+
floating-point flying circus:
211211

212212
.. doctest::
213213
:options: +NORMALIZE_WHITESPACE
@@ -373,7 +373,7 @@ Decimal objects
373373
digits, and an integer exponent. For example, ``Decimal((0, (1, 4, 1, 4), -3))``
374374
returns ``Decimal('1.414')``.
375375

376-
If *value* is a :class:`float`, the binary floating point value is losslessly
376+
If *value* is a :class:`float`, the binary floating-point value is losslessly
377377
converted to its exact decimal equivalent. This conversion can often require
378378
53 or more digits of precision. For example, ``Decimal(float('1.1'))``
379379
converts to
@@ -403,7 +403,7 @@ Decimal objects
403403
Underscores are allowed for grouping, as with integral and floating-point
404404
literals in code.
405405

406-
Decimal floating point objects share many properties with the other built-in
406+
Decimal floating-point objects share many properties with the other built-in
407407
numeric types such as :class:`float` and :class:`int`. All of the usual math
408408
operations and special methods apply. Likewise, decimal objects can be
409409
copied, pickled, printed, used as dictionary keys, used as set elements,
@@ -445,7 +445,7 @@ Decimal objects
445445
Mixed-type comparisons between :class:`Decimal` instances and other
446446
numeric types are now fully supported.
447447

448-
In addition to the standard numeric properties, decimal floating point
448+
In addition to the standard numeric properties, decimal floating-point
449449
objects also have a number of specialized methods:
450450

451451

@@ -1741,7 +1741,7 @@ The following table summarizes the hierarchy of signals::
17411741
17421742
.. _decimal-notes:
17431743

1744-
Floating Point Notes
1744+
Floating-Point Notes
17451745
--------------------
17461746

17471747

@@ -1754,7 +1754,7 @@ can still incur round-off error when non-zero digits exceed the fixed precision.
17541754

17551755
The effects of round-off error can be amplified by the addition or subtraction
17561756
of nearly offsetting quantities resulting in loss of significance. Knuth
1757-
provides two instructive examples where rounded floating point arithmetic with
1757+
provides two instructive examples where rounded floating-point arithmetic with
17581758
insufficient precision causes the breakdown of the associative and distributive
17591759
properties of addition:
17601760

@@ -1844,7 +1844,7 @@ treated as equal and their sign is informational.
18441844
In addition to the two signed zeros which are distinct yet equal, there are
18451845
various representations of zero with differing precisions yet equivalent in
18461846
value. This takes a bit of getting used to. For an eye accustomed to
1847-
normalized floating point representations, it is not immediately obvious that
1847+
normalized floating-point representations, it is not immediately obvious that
18481848
the following calculation returns a value equal to zero:
18491849

18501850
>>> 1 / Decimal('Infinity')
@@ -2171,7 +2171,7 @@ value unchanged:
21712171

21722172
Q. Is there a way to convert a regular float to a :class:`Decimal`?
21732173

2174-
A. Yes, any binary floating point number can be exactly expressed as a
2174+
A. Yes, any binary floating-point number can be exactly expressed as a
21752175
Decimal though an exact conversion may take more precision than intuition would
21762176
suggest:
21772177

@@ -2225,7 +2225,7 @@ Q. Is the CPython implementation fast for large numbers?
22252225
A. Yes. In the CPython and PyPy3 implementations, the C/CFFI versions of
22262226
the decimal module integrate the high speed `libmpdec
22272227
<https://www.bytereef.org/mpdecimal/doc/libmpdec/index.html>`_ library for
2228-
arbitrary precision correctly rounded decimal floating point arithmetic [#]_.
2228+
arbitrary precision correctly rounded decimal floating-point arithmetic [#]_.
22292229
``libmpdec`` uses `Karatsuba multiplication
22302230
<https://en.wikipedia.org/wiki/Karatsuba_algorithm>`_
22312231
for medium-sized numbers and the `Number Theoretic Transform

‎_sources/library/dis.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1592,7 +1592,7 @@ iterations of the loop.
15921592
| ``INTRINSIC_STOPITERATION_ERROR`` | Extracts the return value from a |
15931593
| | ``StopIteration`` exception. |
15941594
+-----------------------------------+-----------------------------------+
1595-
| ``INTRINSIC_ASYNC_GEN_WRAP`` | Wraps an aync generator value |
1595+
| ``INTRINSIC_ASYNC_GEN_WRAP`` | Wraps an async generator value |
15961596
+-----------------------------------+-----------------------------------+
15971597
| ``INTRINSIC_UNARY_POSITIVE`` | Performs the unary ``+`` |
15981598
| | operation |

‎_sources/library/email.utils.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -148,7 +148,7 @@ of the new API.
148148

149149
Fri, 09 Nov 2001 01:08:47 -0000
150150

151-
Optional *timeval* if given is a floating point time value as accepted by
151+
Optional *timeval* if given is a floating-point time value as accepted by
152152
:func:`time.gmtime` and :func:`time.localtime`, otherwise the current time is
153153
used.
154154

‎_sources/library/exceptions.rst.txt

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -412,8 +412,8 @@ The following exceptions are the exceptions that are usually raised.
412412
represented. This cannot occur for integers (which would rather raise
413413
:exc:`MemoryError` than give up). However, for historical reasons,
414414
OverflowError is sometimes raised for integers that are outside a required
415-
range. Because of the lack of standardization of floating point exception
416-
handling in C, most floating point operations are not checked.
415+
range. Because of the lack of standardization of floating-point exception
416+
handling in C, most floating-point operations are not checked.
417417

418418

419419
.. exception:: RecursionError

‎_sources/library/fractions.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ another rational number, or from a string.
3131
:class:`Fraction` instance with the same value. The next two versions accept
3232
either a :class:`float` or a :class:`decimal.Decimal` instance, and return a
3333
:class:`Fraction` instance with exactly the same value. Note that due to the
34-
usual issues with binary floating-point (see :ref:`tut-fp-issues`), the
34+
usual issues with binary floating point (see :ref:`tut-fp-issues`), the
3535
argument to ``Fraction(1.1)`` is not exactly equal to 11/10, and so
3636
``Fraction(1.1)`` does *not* return ``Fraction(11, 10)`` as one might expect.
3737
(But see the documentation for the :meth:`limit_denominator` method below.)

‎_sources/library/functions.rst.txt

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ are always available. They are listed here in alphabetical order.
5757
.. function:: abs(x)
5858

5959
Return the absolute value of a number. The argument may be an
60-
integer, a floating point number, or an object implementing
60+
integer, a floating-point number, or an object implementing
6161
:meth:`~object.__abs__`.
6262
If the argument is a complex number, its magnitude is returned.
6363

@@ -538,7 +538,7 @@ are always available. They are listed here in alphabetical order.
538538
Take two (non-complex) numbers as arguments and return a pair of numbers
539539
consisting of their quotient and remainder when using integer division. With
540540
mixed operand types, the rules for binary arithmetic operators apply. For
541-
integers, the result is the same as ``(a // b, a % b)``. For floating point
541+
integers, the result is the same as ``(a // b, a % b)``. For floating-point
542542
numbers the result is ``(q, a % b)``, where *q* is usually ``math.floor(a /
543543
b)`` but may be 1 less than that. In any case ``q * b + a % b`` is very
544544
close to *a*, if ``a % b`` is non-zero it has the same sign as *b*, and ``0
@@ -714,7 +714,7 @@ are always available. They are listed here in alphabetical order.
714714
single: NaN
715715
single: Infinity
716716

717-
Return a floating point number constructed from a number or a string.
717+
Return a floating-point number constructed from a number or a string.
718718

719719
Examples:
720720

@@ -755,8 +755,8 @@ are always available. They are listed here in alphabetical order.
755755
Case is not significant, so, for example, "inf", "Inf", "INFINITY", and
756756
"iNfINity" are all acceptable spellings for positive infinity.
757757

758-
Otherwise, if the argument is an integer or a floating point number, a
759-
floating point number with the same value (within Python's floating point
758+
Otherwise, if the argument is an integer or a floating-point number, a
759+
floating-point number with the same value (within Python's floating-point
760760
precision) is returned. If the argument is outside the range of a Python
761761
float, an :exc:`OverflowError` will be raised.
762762

@@ -983,7 +983,7 @@ are always available. They are listed here in alphabetical order.
983983
``int(x)`` returns ``x.__int__()``. If the argument defines :meth:`~object.__index__`,
984984
it returns ``x.__index__()``. If the argument defines :meth:`~object.__trunc__`,
985985
it returns ``x.__trunc__()``.
986-
For floating point numbers, this truncates towards zero.
986+
For floating-point numbers, this truncates towards zero.
987987

988988
If the argument is not a number or if *base* is given, then it must be a string,
989989
:class:`bytes`, or :class:`bytearray` instance representing an integer
@@ -1440,7 +1440,7 @@ are always available. They are listed here in alphabetical order.
14401440
(where :func:`open` is declared), :mod:`os`, :mod:`os.path`, :mod:`tempfile`,
14411441
and :mod:`shutil`.
14421442

1443-
.. audit-event:: open file,mode,flags open
1443+
.. audit-event:: open path,mode,flags open
14441444

14451445
The ``mode`` and ``flags`` arguments may have been modified or inferred from
14461446
the original call.
@@ -1859,7 +1859,7 @@ are always available. They are listed here in alphabetical order.
18591859

18601860
For some use cases, there are good alternatives to :func:`sum`.
18611861
The preferred, fast way to concatenate a sequence of strings is by calling
1862-
``''.join(sequence)``. To add floating point values with extended precision,
1862+
``''.join(sequence)``. To add floating-point values with extended precision,
18631863
see :func:`math.fsum`\. To concatenate a series of iterables, consider using
18641864
:func:`itertools.chain`.
18651865

0 commit comments

Comments
 (0)