Zengtudor/pybind11
1
0
Fork 0
mirror of https://github.com/pybind/pybind11.git synced 2024-11-24 22:25:10 +00:00
Code Issues Packages Projects Releases Wiki Activity

Clarify error_already_set documentation.

Browse Source
This commit is contained in:
Antony Lee 2018-03-11 16:15:56 -07:00 committed by Jason Rhinelander
parent 289e5d9cc2
commit 8fbb5594fd
1 changed files with 39 additions and 39 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

78
docs/advanced/exceptions.rst
View File

@ -11,45 +11,45 @@ exceptions:
.. tabularcolumns:: |p{0.5\textwidth}|p{0.45\textwidth}| .. tabularcolumns:: |p{0.5\textwidth}|p{0.45\textwidth}|
+--------------------------------------+------------------------------+ +--------------------------------------+--------------------------------------+
| C++ exception type | Python exception type | | C++ exception type | Python exception type |
+======================================+==============================+ +======================================+======================================+
| :class:`std::exception` | ``RuntimeError`` | | :class:`std::exception` | ``RuntimeError`` |
+--------------------------------------+------------------------------+ +--------------------------------------+--------------------------------------+
| :class:`std::bad_alloc` | ``MemoryError`` | | :class:`std::bad_alloc` | ``MemoryError`` |
+--------------------------------------+------------------------------+ +--------------------------------------+--------------------------------------+
| :class:`std::domain_error` | ``ValueError`` | | :class:`std::domain_error` | ``ValueError`` |
+--------------------------------------+------------------------------+ +--------------------------------------+--------------------------------------+
| :class:`std::invalid_argument` | ``ValueError`` | | :class:`std::invalid_argument` | ``ValueError`` |
+--------------------------------------+------------------------------+ +--------------------------------------+--------------------------------------+
| :class:`std::length_error` | ``ValueError`` | | :class:`std::length_error` | ``ValueError`` |
+--------------------------------------+------------------------------+ +--------------------------------------+--------------------------------------+
| :class:`std::out_of_range` | ``ValueError`` | | :class:`std::out_of_range` | ``ValueError`` |
+--------------------------------------+------------------------------+ +--------------------------------------+--------------------------------------+
| :class:`std::range_error` | ``ValueError`` | | :class:`std::range_error` | ``ValueError`` |
+--------------------------------------+------------------------------+ +--------------------------------------+--------------------------------------+
| :class:`pybind11::stop_iteration` | ``StopIteration`` (used to | | :class:`pybind11::stop_iteration` | ``StopIteration`` (used to implement |
| | implement custom iterators) | | | custom iterators) |
+--------------------------------------+------------------------------+ +--------------------------------------+--------------------------------------+
| :class:`pybind11::index_error` | ``IndexError`` (used to | | :class:`pybind11::index_error` | ``IndexError`` (used to indicate out |
| | indicate out of bounds | | | of bounds access in ``__getitem__``, |
| | accesses in ``__getitem__``, | | | ``__setitem__``, etc.) |
| | ``__setitem__``, etc.) | +--------------------------------------+--------------------------------------+
+--------------------------------------+------------------------------+ | :class:`pybind11::value_error` | ``ValueError`` (used to indicate |
| :class:`pybind11::value_error` | ``ValueError`` (used to | | | wrong value passed in |
| | indicate wrong value passed | | | ``container.remove(...)``) |
| | in ``container.remove(...)`` | +--------------------------------------+--------------------------------------+
+--------------------------------------+------------------------------+ | :class:`pybind11::key_error` | ``KeyError`` (used to indicate out |
| :class:`pybind11::key_error` | ``KeyError`` (used to | | | of bounds access in ``__getitem__``, |
| | indicate out of bounds | | | ``__setitem__`` in dict-like |
| | accesses in ``__getitem__``, | | | objects, etc.) |
| | ``__setitem__`` in dict-like | +--------------------------------------+--------------------------------------+
| | objects, etc.) | | :class:`pybind11::error_already_set` | Indicates that the Python exception |
+--------------------------------------+------------------------------+ | | flag has already been set via Python |
| :class:`pybind11::error_already_set` | Indicates that the Python | | | API calls from C++ code; this C++ |
| | exception flag has already | | | exception is used to propagate such |
| | been initialized | | | a Python exception back to Python. |
+--------------------------------------+------------------------------+ +--------------------------------------+--------------------------------------+
When a Python function invoked from C++ throws an exception, it is converted When a Python function invoked from C++ throws an exception, it is converted
into a C++ exception of type :class:`error_already_set` whose string payload into a C++ exception of type :class:`error_already_set` whose string payload