Repository navigation
Explicitly mention bytes and other buffers in the documentation for float() #77748
Description
| BPO | 33567 |
|---|---|
| Nosy | @rhettinger, @mjpieters, @joelthelion |
Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.
Show more details
GitHub fields:
assignee = None
closed_at = None
created_at = <Date 2018-05-18.10:41:41.124>
labels = ['3.11', 'type-feature', '3.9', '3.10', 'docs']
title = 'Explicitly mention bytes and other buffers in the documentation for float()'
updated_at = <Date 2021-12-19.04:18:07.710>
user = 'https://github.com/mjpieters'bugs.python.org fields:
activity = <Date 2021-12-19.04:18:07.710>
actor = 'rhettinger'
assignee = 'docs@python'
closed = False
closed_date = None
closer = None
components = ['Documentation']
creation = <Date 2018-05-18.10:41:41.124>
creator = 'mjpieters'
dependencies = []
files = []
hgrepos = []
issue_num = 33567
keywords = []
message_count = 1.0
messages = ['317022']
nosy_count = 4.0
nosy_names = ['rhettinger', 'mjpieters', 'docs@python', 'joelthelion']
pr_nums = []
priority = 'normal'
resolution = None
stage = 'needs patch'
status = 'open'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue33567'
versions = ['Python 3.9', 'Python 3.10', 'Python 3.11']
Activity
mjpieters commentedon May 18, 2018
float(bytesobject) treats the contents of the bytesobject as a sequence of ASCII characters, and converts those to a float value as if you used float(bytesobject.decode('ASCII')). The same support is extended to other objects implementing the buffer protocol.
The documentation, however, doesn't mention this:
Everywhere else in the functions documentation, "string" refers to an object of type
str. Please make it explicit thatbytesis also acceptedable, like it does for the int() documentation.