Skip to content

bpo-32077: Documentation: Some Unicode object functions don't indicate whether they return a new reference#4472

Closed
lioncash wants to merge 1 commit into
python:masterfrom
lioncash:unicode-c-api-docs
Closed

bpo-32077: Documentation: Some Unicode object functions don't indicate whether they return a new reference#4472
lioncash wants to merge 1 commit into
python:masterfrom
lioncash:unicode-c-api-docs

Conversation

@lioncash

@lioncash lioncash commented Nov 20, 2017

Copy link
Copy Markdown
Contributor

Also adds missing functions. Makes the documentation more comprehensive in terms of indicating whether or not a function returns a new reference.

I've gone over the entries quite a few times, and I'm fairly confident I've amended most of the existing functions and added the new ones that weren't yet added. If I've happened to miss any, just say the word and I'll add them.

I've also noticed the API documentation for bytes objects is also missing entries, which I've made a local commit for, but wasn't sure if it was a good idea to intermix it in this change. I can PR it separately or include it in this one depending on whichever is preferable.

https://bugs.python.org/issue32077

Also adds missing functions.

Makes the documentation more comprehensive in terms of indicating
whether or not a function returns a new reference.
@lioncash lioncash changed the title bpo-32077: Some Unicode object functions don't indicate whether they return a new reference bpo-32077: Documentation: Some Unicode object functions don't indicate whether they return a new reference Nov 20, 2017
Comment thread Doc/data/refcounts.dat
PyUnicode_AsWideChar:int:::
PyUnicode_AsWideChar:PyObject*:*unicode:0:
PyUnicode_AsWideChar:Py_ssize_t:::
PyUnicode_AsWideChar:PyUnicodeObject*:unicode:0:

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

PyObject

Comment thread Doc/data/refcounts.dat
PyUnicode_DecodeUTF16Stateful:Py_ssize_t:size::
PyUnicode_DecodeUTF16Stateful:const char*:errors::
PyUnicode_DecodeUTF16Stateful:int*:byteorder::
PyUnicode_DecodeUTF16Stateful:int*:consumed::

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Py_ssize_t

Comment thread Doc/data/refcounts.dat
PyUnicode_DecodeUTF8Stateful:int:size::
PyUnicode_DecodeUTF8Stateful:Py_ssize_t:size::
PyUnicode_DecodeUTF8Stateful:const char*:errors::
PyUnicode_DecodeUTF8Stateful:int*:consumed::

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Py_ssize_t

Comment thread Doc/data/refcounts.dat

PyUnicode_AsUTF8AndSize:const char*:::
PyUnicode_AsUTF8AndSize:PyObject*:unicode:0:

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

PyUnicode_AsUTF8AndSize:Py_ssize_t*:size::

Comment thread Doc/data/refcounts.dat
PyUnicode_EncodeRawUnicodeEscape:const Py_UNICODE*:s::
PyUnicode_EncodeRawUnicodeEscape:int:size::
PyUnicode_EncodeRawUnicodeEscape:Py_ssize_t:size::
PyUnicode_EncodeRawUnicodeEscape:const char*:errors::

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remove.

Comment thread Doc/data/refcounts.dat
PyUnicode_InternFromString:const char*:cp::

PyUnicode_New:PyObject*::+1:
PyUnicode_New:Py_UCS4:maxchar::

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Insert PyUnicode_New:Py_ssize_t:size::.

@lioncash

lioncash commented Dec 19, 2018

Copy link
Copy Markdown
Contributor Author

I've recreated the pull request in #11243, with the feedback addressed, as I mistakenly thought this was addressed in the past and removed my fork on github, which seems to have orphaned this pull request. I'm really sorry about that. Will close this one.

@lioncash lioncash closed this Dec 19, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants