gh-74232: Add a note about roundtrip of non-float numerics in CSV (GH-134963)

This commit is contained in:
Serhiy Storchaka 2025-06-02 23:31:06 +03:00 committed by GitHub
parent 7a79f52d83
commit e814f43f2c
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -70,7 +70,7 @@ The :mod:`csv` module defines the following functions:
section :ref:`csv-fmt-params`.
Each row read from the csv file is returned as a list of strings. No
automatic data type conversion is performed unless the ``QUOTE_NONNUMERIC`` format
automatic data type conversion is performed unless the :data:`QUOTE_NONNUMERIC` format
option is specified (in which case unquoted fields are transformed into floats).
A short usage example::
@ -331,8 +331,14 @@ The :mod:`csv` module defines the following constants:
Instructs :class:`writer` objects to quote all non-numeric fields.
Instructs :class:`reader` objects to convert all non-quoted fields to type *float*.
Instructs :class:`reader` objects to convert all non-quoted fields to type :class:`float`.
.. note::
Some numeric types, such as :class:`bool`, :class:`~fractions.Fraction`,
or :class:`~enum.IntEnum`, have a string representation that cannot be
converted to :class:`float`.
They cannot be read in the :data:`QUOTE_NONNUMERIC` and
:data:`QUOTE_STRINGS` modes.
.. data:: QUOTE_NONE