mirror of
https://github.com/pybind/pybind11.git
synced 2024-11-25 06:35:12 +00:00
d65e34d61d
* Wrap PYBIND11_OVERLOAD_NAME and PYBIND11_OVERLOAD_PURE_NAME in do { ... } while (false), and resolve trailing semicolon
* Deprecate PYBIND11_OVERLOAD_* and get_overload in favor of PYBIND11_OVERRIDE_* and get_override
* Correct erroneous usage of 'overload' instead of 'override' in the implementation and internals
* Fix tests to use non-deprecated PYBIND11_OVERRIDE_* macros
* Update docs to use override instead of overload where appropriate, and add warning about deprecated aliases
* Add semicolons to deprecated PYBIND11_OVERLOAD macros to match original behavior
* Remove deprecation of PYBIND11_OVERLOAD_* macros and get_overload
* Add note to changelog and upgrade guide
118 lines
2.1 KiB
ReStructuredText
118 lines
2.1 KiB
ReStructuredText
.. _reference:
|
|
|
|
.. warning::
|
|
|
|
Please be advised that the reference documentation discussing pybind11
|
|
internals is currently incomplete. Please refer to the previous sections
|
|
and the pybind11 header files for the nitty gritty details.
|
|
|
|
Reference
|
|
#########
|
|
|
|
.. _macros:
|
|
|
|
Macros
|
|
======
|
|
|
|
.. doxygendefine:: PYBIND11_MODULE
|
|
|
|
.. _core_types:
|
|
|
|
Convenience classes for arbitrary Python types
|
|
==============================================
|
|
|
|
Common member functions
|
|
-----------------------
|
|
|
|
.. doxygenclass:: object_api
|
|
:members:
|
|
|
|
Without reference counting
|
|
--------------------------
|
|
|
|
.. doxygenclass:: handle
|
|
:members:
|
|
|
|
With reference counting
|
|
-----------------------
|
|
|
|
.. doxygenclass:: object
|
|
:members:
|
|
|
|
.. doxygenfunction:: reinterpret_borrow
|
|
|
|
.. doxygenfunction:: reinterpret_steal
|
|
|
|
Convenience classes for specific Python types
|
|
=============================================
|
|
|
|
.. doxygenclass:: module
|
|
:members:
|
|
|
|
.. doxygengroup:: pytypes
|
|
:members:
|
|
|
|
.. _extras:
|
|
|
|
Passing extra arguments to ``def`` or ``class_``
|
|
================================================
|
|
|
|
.. doxygengroup:: annotations
|
|
:members:
|
|
|
|
Embedding the interpreter
|
|
=========================
|
|
|
|
.. doxygendefine:: PYBIND11_EMBEDDED_MODULE
|
|
|
|
.. doxygenfunction:: initialize_interpreter
|
|
|
|
.. doxygenfunction:: finalize_interpreter
|
|
|
|
.. doxygenclass:: scoped_interpreter
|
|
|
|
Redirecting C++ streams
|
|
=======================
|
|
|
|
.. doxygenclass:: scoped_ostream_redirect
|
|
|
|
.. doxygenclass:: scoped_estream_redirect
|
|
|
|
.. doxygenfunction:: add_ostream_redirect
|
|
|
|
Python built-in functions
|
|
=========================
|
|
|
|
.. doxygengroup:: python_builtins
|
|
:members:
|
|
|
|
Inheritance
|
|
===========
|
|
|
|
See :doc:`/classes` and :doc:`/advanced/classes` for more detail.
|
|
|
|
.. doxygendefine:: PYBIND11_OVERRIDE
|
|
|
|
.. doxygendefine:: PYBIND11_OVERRIDE_PURE
|
|
|
|
.. doxygendefine:: PYBIND11_OVERRIDE_NAME
|
|
|
|
.. doxygendefine:: PYBIND11_OVERRIDE_PURE_NAME
|
|
|
|
.. doxygenfunction:: get_override
|
|
|
|
Exceptions
|
|
==========
|
|
|
|
.. doxygenclass:: error_already_set
|
|
:members:
|
|
|
|
.. doxygenclass:: builtin_exception
|
|
:members:
|
|
|
|
|
|
Literals
|
|
========
|
|
|
|
.. doxygennamespace:: literals
|