python · serhiy-storchaka · Dec 18, 2018 · Dec 11, 2018 · Dec 17, 2018 · Dec 17, 2018
diff --git a/Doc/c-api/buffer.rst b/Doc/c-api/buffer.rst
@@ -429,7 +429,7 @@ Buffer-related functions

   Return ``1`` if *obj* supports the buffer interface otherwise ``0``.  When ``1`` is
   returned, it doesn't guarantee that :c:func:`PyObject_GetBuffer` will
-   succeed.
+   succeed.  This function always succeeds.


 .. c:function:: int PyObject_GetBuffer(PyObject *exporter, Py_buffer *view, int flags)
@@ -470,7 +470,7 @@ Buffer-related functions

   Return ``1`` if the memory defined by the *view* is C-style (*order* is
   ``'C'``) or Fortran-style (*order* is ``'F'``) :term:`contiguous` or either one
-   (*order* is ``'A'``).  Return ``0`` otherwise.
+   (*order* is ``'A'``).  Return ``0`` otherwise.  This function always succeeds.


 .. c:function:: int PyBuffer_ToContiguous(void *buf, Py_buffer *src, Py_ssize_t len, char order)

diff --git a/Doc/c-api/codec.rst b/Doc/c-api/codec.rst
@@ -13,7 +13,7 @@ Codec registry and support functions
 .. c:function:: int PyCodec_KnownEncoding(const char *encoding)

   Return ``1`` or ``0`` depending on whether there is a registered codec for
-   the given *encoding*.
+   the given *encoding*.  This function always succeeds.

 .. c:function:: PyObject* PyCodec_Encode(PyObject *object, const char *encoding, const char *errors)


diff --git a/Doc/c-api/dict.rst b/Doc/c-api/dict.rst
@@ -95,6 +95,10 @@ Dictionary Objects
   Return the object from dictionary *p* which has a key *key*.  Return *NULL*
   if the key *key* is not present, but *without* setting an exception.

+   Note that exceptions which occur while calling :meth:`__hash__` and
+   :meth:`__eq__` methods will get suppressed.
+   To get error reporting use :c:func:`PyDict_GetItemWithError()` instead.
+

 .. c:function:: PyObject* PyDict_GetItemWithError(PyObject *p, PyObject *key)

@@ -109,6 +113,11 @@ Dictionary Objects
   This is the same as :c:func:`PyDict_GetItem`, but *key* is specified as a
   :c:type:`const char\*`, rather than a :c:type:`PyObject\*`.

+   Note that exceptions which occur while calling :meth:`__hash__` and
+   :meth:`__eq__` methods and creating a temporary string object
+   will get suppressed.
+   To get error reporting use :c:func:`PyDict_GetItemWithError()` instead.
+

 .. c:function:: PyObject* PyDict_SetDefault(PyObject *p, PyObject *key, PyObject *default)


diff --git a/Doc/c-api/mapping.rst b/Doc/c-api/mapping.rst
@@ -60,13 +60,21 @@ See also :c:func:`PyObject_GetItem`, :c:func:`PyObject_SetItem` and
   This is equivalent to the Python expression ``key in o``.
   This function always succeeds.

+   Note that exceptions which occur while calling the :meth:`__getitem__`
+   method will get suppressed.
+   To get error reporting use :c:func:`PyObject_GetItem()` instead.
+

 .. c:function:: int PyMapping_HasKeyString(PyObject *o, const char *key)

   Return ``1`` if the mapping object has the key *key* and ``0`` otherwise.
   This is equivalent to the Python expression ``key in o``.
   This function always succeeds.

+   Note that exceptions which occur while calling the :meth:`__getitem__`
+   method and creating a temporary string object will get suppressed.
+   To get error reporting use :c:func:`PyMapping_GetItemString()` instead.
+

 .. c:function:: PyObject* PyMapping_Keys(PyObject *o)


diff --git a/Doc/c-api/number.rst b/Doc/c-api/number.rst
@@ -280,3 +280,4 @@ Number Protocol

   Returns ``1`` if *o* is an index integer (has the nb_index slot of  the
   tp_as_number structure filled in), and ``0`` otherwise.
+   This function always succeeds.
diff --git a/Doc/c-api/objbuffer.rst b/Doc/c-api/objbuffer.rst
@@ -39,7 +39,11 @@ an object, and :c:func:`PyBuffer_Release` when the buffer view can be released.
 .. c:function:: int PyObject_CheckReadBuffer(PyObject *o)

   Returns ``1`` if *o* supports the single-segment readable buffer interface.
-   Otherwise returns ``0``.
+   Otherwise returns ``0``.  This function always succeeds.
+
+   Note that this function tries to get and release a buffer, and exceptions
+   which occur while calling correspoding functions will get suppressed.
+   To get error reporting use :c:func:`PyObject_GetBuffer()` instead.


 .. c:function:: int PyObject_AsWriteBuffer(PyObject *obj, void **buffer, Py_ssize_t *buffer_len)

diff --git a/Doc/c-api/object.rst b/Doc/c-api/object.rst
@@ -33,13 +33,22 @@ Object Protocol
   is equivalent to the Python expression ``hasattr(o, attr_name)``.  This function
   always succeeds.

+   Note that exceptions which occur while calling :meth:`__getattr__` and
+   :meth:`__getattribute__` methods will get suppressed.
+   To get error reporting use :c:func:`PyObject_GetAttr()` instead.
+

 .. c:function:: int PyObject_HasAttrString(PyObject *o, const char *attr_name)

   Returns ``1`` if *o* has the attribute *attr_name*, and ``0`` otherwise.  This
   is equivalent to the Python expression ``hasattr(o, attr_name)``.  This function
   always succeeds.

+   Note that exceptions which occur while calling :meth:`__getattr__` and
+   :meth:`__getattribute__` methods and creating a temporary string object
+   will get suppressed.
+   To get error reporting use :c:func:`PyObject_GetAttrString()` instead.
+

 .. c:function:: PyObject* PyObject_GetAttr(PyObject *o, PyObject *attr_name)
-Original file line number
+Diff line change
@@ -39,7 +39,11 @@ an object, and :c:func:`PyBuffer_Release` when the buffer view can be released.
     .. c:function:: int PyObject_CheckReadBuffer(PyObject *o)
        Returns ``1`` if *o* supports the single-segment readable buffer interface.
-       Otherwise returns ``0``.
+       Otherwise returns ``0``.  This function always succeeds.
+       Note that this function tries to get and release a buffer, and exceptions
+       which occur while calling correspoding functions will get suppressed.
               Copy link

  
        
      
    

    
        

  
    Contributor


        

    
  

  
    
      
          
      

      
            christopheNan
  

      

      

      


        Mar 2, 2019


      
  •

  
    
      
        
          edited
          
        
        
      
    
    
      
  
        
      Loading


  
    
  
    
      

              Uh oh!

              
There was an error while loading. Please reload this page.


  
  
    
  


    

  


        
      
  
  
  
    

    There was a problem hiding this comment.


  

 
  
    

    Choose a reason for hiding this comment

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

    
      
      


  


  
    
      There is a typo in "corresponding"
    
  
  



    

        
      
  
  
    
  
  
  
    
    Sorry, something went wrong.
  

  
    
  
    
      

              Uh oh!

              
There was an error while loading. Please reload this page.


  
  


          
              
  
    
    
      
        
            
    All reactions
+       To get error reporting use :c:func:`PyObject_GetBuffer()` instead.
     .. c:function:: int PyObject_AsWriteBuffer(PyObject *obj, void **buffer, Py_ssize_t *buffer_len)
-          Expand Down