New submission from Martin Blais:

Functions that parse arguments like  PyArg_ParseTupleAndKeywords() have several 
formatters that fill in C strings, e.g. "s".

In the C API doc:
https://docs.python.org/3.5/c-api/arg.html#c.PyArg_ParseTupleAndKeywords

There should be an explicit mention of whether this memory needs to be free (in 
this case: No) and if not, how this memory is managed (in this case: This 
refers to a buffer managed by the string object itself). Because of questions 
of encoding, it raises questions where this memory lies, and what its lifetime 
is (in this case: That of the owning string object from the caller).

This deserves an explicit mention, even if brief.

----------
assignee: docs@python
components: Documentation
messages: 243987
nosy: blais, docs@python
priority: normal
severity: normal
status: open
title: Docs on Parsing arguments should say something about mem mgmt for 
formatters returning C strings

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue24278>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to