[issue8649] Py_UNICODE_* functions are undocumented
New submission from Daniel Stutzbach <daniel@stutzbachenterprises.com>: Python provides several functions for manipulating raw Py_UNICODE strings, but they aren't documented. Below are their signatures. PyAPI_FUNC(size_t) Py_UNICODE_strlen(const Py_UNICODE *u); PyAPI_FUNC(Py_UNICODE*) Py_UNICODE_strcpy( Py_UNICODE *s1, const Py_UNICODE *s2); PyAPI_FUNC(Py_UNICODE*) Py_UNICODE_strncpy( Py_UNICODE *s1, const Py_UNICODE *s2, size_t n); PyAPI_FUNC(int) Py_UNICODE_strcmp( const Py_UNICODE *s1, const Py_UNICODE *s2); PyAPI_FUNC(Py_UNICODE*) Py_UNICODE_strchr( const Py_UNICODE *s, Py_UNICODE c ); ---------- assignee: docs@python components: Documentation messages: 105214 nosy: docs@python, stutzbach priority: normal severity: normal stage: needs patch status: open title: Py_UNICODE_* functions are undocumented versions: Python 2.7, Python 3.2 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue8649> _______________________________________
Changes by STINNER Victor <victor.stinner@haypocalc.com>: ---------- nosy: +haypo _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue8649> _______________________________________
Terry J. Reedy <tjreedy@udel.edu> added the comment: If, for this and your previous two issues, you could add a suggestion as to precisely where you would make an addition and what minimally adequate text you would add (even unformatted ascii text in a message) that is consistent with surrounding style, action would likely happen sooner. ---------- nosy: +tjreedy _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue8649> _______________________________________
Changes by Terry J. Reedy <tjreedy@udel.edu>: ---------- versions: +Python 2.6, Python 3.1 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue8649> _______________________________________
Nick Coghlan <ncoghlan@gmail.com> added the comment: For this one, I suggest adding something to http://docs.python.org/dev/c-api/unicode.html#plain-py-unicode ---------- nosy: +ncoghlan _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue8649> _______________________________________
Alexander Belopolsky <belopolsky@users.sourceforge.net> added the comment: There are more undocumented functions in unicode.h. It makes sense to fix all of them in one patch. Closing this as superseded by #10435. ---------- nosy: +belopolsky resolution: -> duplicate status: open -> closed superseder: -> Document unicode C-API in reST _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue8649> _______________________________________
participants (5)
-
Alexander Belopolsky
-
Daniel Stutzbach
-
Nick Coghlan
-
STINNER Victor
-
Terry J. Reedy