diff options
author | Serhiy Storchaka <storchaka@gmail.com> | 2015-06-21 14:11:21 (GMT) |
---|---|---|
committer | Serhiy Storchaka <storchaka@gmail.com> | 2015-06-21 14:11:21 (GMT) |
commit | 03863d2b290d0856d7647a0275a73b55b6589fa7 (patch) | |
tree | b108c989aeb591eb444722e7f0046c75689182ab /Doc/c-api | |
parent | 5fa22fc088ac44c5652107c7c17cda01eaa84a28 (diff) | |
download | cpython-03863d2b290d0856d7647a0275a73b55b6589fa7.zip cpython-03863d2b290d0856d7647a0275a73b55b6589fa7.tar.gz cpython-03863d2b290d0856d7647a0275a73b55b6589fa7.tar.bz2 |
Fixed documentation of functions with const char* arguments.
Diffstat (limited to 'Doc/c-api')
-rw-r--r-- | Doc/c-api/conversion.rst | 4 | ||||
-rw-r--r-- | Doc/c-api/exceptions.rst | 8 | ||||
-rw-r--r-- | Doc/c-api/import.rst | 4 | ||||
-rw-r--r-- | Doc/c-api/init.rst | 2 | ||||
-rw-r--r-- | Doc/c-api/mapping.rst | 2 | ||||
-rw-r--r-- | Doc/c-api/marshal.rst | 2 | ||||
-rw-r--r-- | Doc/c-api/sys.rst | 4 | ||||
-rw-r--r-- | Doc/c-api/unicode.rst | 2 |
8 files changed, 14 insertions, 14 deletions
diff --git a/Doc/c-api/conversion.rst b/Doc/c-api/conversion.rst index 9578f98..9566d9d 100644 --- a/Doc/c-api/conversion.rst +++ b/Doc/c-api/conversion.rst @@ -119,13 +119,13 @@ The following functions provide locale-independent string to number conversions. .. versionadded:: 3.1 -.. c:function:: int PyOS_stricmp(char *s1, char *s2) +.. c:function:: int PyOS_stricmp(const char *s1, const char *s2) Case insensitive comparison of strings. The function works almost identically to :c:func:`strcmp` except that it ignores the case. -.. c:function:: int PyOS_strnicmp(char *s1, char *s2, Py_ssize_t size) +.. c:function:: int PyOS_strnicmp(const char *s1, const char *s2, Py_ssize_t size) Case insensitive comparison of strings. The function works almost identically to :c:func:`strncmp` except that it ignores the case. diff --git a/Doc/c-api/exceptions.rst b/Doc/c-api/exceptions.rst index d89c31c..c2df767 100644 --- a/Doc/c-api/exceptions.rst +++ b/Doc/c-api/exceptions.rst @@ -324,7 +324,7 @@ in various ways. There is a separate error indicator for each thread. .. versionadded:: 3.4 -.. c:function:: void PyErr_SyntaxLocationEx(char *filename, int lineno, int col_offset) +.. c:function:: void PyErr_SyntaxLocationEx(const char *filename, int lineno, int col_offset) Like :c:func:`PyErr_SyntaxLocationObject`, but *filename* is a byte string decoded from the filesystem encoding (:func:`os.fsdecode`). @@ -332,7 +332,7 @@ in various ways. There is a separate error indicator for each thread. .. versionadded:: 3.2 -.. c:function:: void PyErr_SyntaxLocation(char *filename, int lineno) +.. c:function:: void PyErr_SyntaxLocation(const char *filename, int lineno) Like :c:func:`PyErr_SyntaxLocationEx`, but the col_offset parameter is omitted. @@ -451,7 +451,7 @@ in various ways. There is a separate error indicator for each thread. only be called from the main thread. -.. c:function:: PyObject* PyErr_NewException(char *name, PyObject *base, PyObject *dict) +.. c:function:: PyObject* PyErr_NewException(const char *name, PyObject *base, PyObject *dict) This utility function creates and returns a new exception class. The *name* argument must be the name of the new exception, a C string of the form @@ -466,7 +466,7 @@ in various ways. There is a separate error indicator for each thread. argument can be used to specify a dictionary of class variables and methods. -.. c:function:: PyObject* PyErr_NewExceptionWithDoc(char *name, char *doc, PyObject *base, PyObject *dict) +.. c:function:: PyObject* PyErr_NewExceptionWithDoc(const char *name, const char *doc, PyObject *base, PyObject *dict) Same as :c:func:`PyErr_NewException`, except that the new exception class can easily be given a docstring: If *doc* is non-*NULL*, it will be used as the diff --git a/Doc/c-api/import.rst b/Doc/c-api/import.rst index 3641fc6..60865f4 100644 --- a/Doc/c-api/import.rst +++ b/Doc/c-api/import.rst @@ -39,7 +39,7 @@ Importing Modules behaviour isn't needed anymore. -.. c:function:: PyObject* PyImport_ImportModuleEx(char *name, PyObject *globals, PyObject *locals, PyObject *fromlist) +.. c:function:: PyObject* PyImport_ImportModuleEx(const char *name, PyObject *globals, PyObject *locals, PyObject *fromlist) .. index:: builtin: __import__ @@ -70,7 +70,7 @@ Importing Modules .. versionadded:: 3.3 -.. c:function:: PyObject* PyImport_ImportModuleLevel(char *name, PyObject *globals, PyObject *locals, PyObject *fromlist, int level) +.. c:function:: PyObject* PyImport_ImportModuleLevel(const char *name, PyObject *globals, PyObject *locals, PyObject *fromlist, int level) Similar to :c:func:`PyImport_ImportModuleLevelObject`, but the name is an UTF-8 encoded string instead of a Unicode object. diff --git a/Doc/c-api/init.rst b/Doc/c-api/init.rst index 4d358ca..4bb5064 100644 --- a/Doc/c-api/init.rst +++ b/Doc/c-api/init.rst @@ -86,7 +86,7 @@ Process-wide parameters ======================= -.. c:function:: int Py_SetStandardStreamEncoding(char *encoding, char *errors) +.. c:function:: int Py_SetStandardStreamEncoding(const char *encoding, const char *errors) .. index:: single: Py_Initialize() diff --git a/Doc/c-api/mapping.rst b/Doc/c-api/mapping.rst index 2803fd0..e341047 100644 --- a/Doc/c-api/mapping.rst +++ b/Doc/c-api/mapping.rst @@ -34,7 +34,7 @@ Mapping Protocol failure. This is equivalent to the Python statement ``del o[key]``. -.. c:function:: int PyMapping_HasKeyString(PyObject *o, char *key) +.. c:function:: int PyMapping_HasKeyString(PyObject *o, const char *key) On success, return ``1`` if the mapping object has the key *key* and ``0`` otherwise. This is equivalent to the Python expression ``key in o``. diff --git a/Doc/c-api/marshal.rst b/Doc/c-api/marshal.rst index 9ea0aaa..a6d0f46 100644 --- a/Doc/c-api/marshal.rst +++ b/Doc/c-api/marshal.rst @@ -88,7 +88,7 @@ written using these routines? :exc:`TypeError`) and returns *NULL*. -.. c:function:: PyObject* PyMarshal_ReadObjectFromString(char *string, Py_ssize_t len) +.. c:function:: PyObject* PyMarshal_ReadObjectFromString(const char *string, Py_ssize_t len) Return a Python object from the data stream in a character buffer containing *len* bytes pointed to by *string*. diff --git a/Doc/c-api/sys.rst b/Doc/c-api/sys.rst index 9760dca..7cead07 100644 --- a/Doc/c-api/sys.rst +++ b/Doc/c-api/sys.rst @@ -56,12 +56,12 @@ These are utility functions that make functionality from the :mod:`sys` module accessible to C code. They all work with the current interpreter thread's :mod:`sys` module's dict, which is contained in the internal thread state structure. -.. c:function:: PyObject *PySys_GetObject(char *name) +.. c:function:: PyObject *PySys_GetObject(const char *name) Return the object *name* from the :mod:`sys` module or *NULL* if it does not exist, without setting an exception. -.. c:function:: int PySys_SetObject(char *name, PyObject *v) +.. c:function:: int PySys_SetObject(const char *name, PyObject *v) Set *name* in the :mod:`sys` module to *v* unless *v* is *NULL*, in which case *name* is deleted from the sys module. Returns ``0`` on success, ``-1`` diff --git a/Doc/c-api/unicode.rst b/Doc/c-api/unicode.rst index 65d24c4..f7e99d6 100644 --- a/Doc/c-api/unicode.rst +++ b/Doc/c-api/unicode.rst @@ -1628,7 +1628,7 @@ They all return *NULL* or ``-1`` if an exception occurs. respectively. -.. c:function:: int PyUnicode_CompareWithASCIIString(PyObject *uni, char *string) +.. c:function:: int PyUnicode_CompareWithASCIIString(PyObject *uni, const char *string) Compare a unicode object, *uni*, with *string* and return -1, 0, 1 for less than, equal, and greater than, respectively. It is best to pass only |