reference.rst 2.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127
  1. .. _reference:
  2. .. warning::
  3. Please be advised that the reference documentation discussing pybind11
  4. internals is currently incomplete. Please refer to the previous sections
  5. and the pybind11 header files for the nitty gritty details.
  6. Reference
  7. #########
  8. .. _macros:
  9. Macros
  10. ======
  11. .. doxygendefine:: PYBIND11_MODULE
  12. .. _core_types:
  13. Convenience classes for arbitrary Python types
  14. ==============================================
  15. Common member functions
  16. -----------------------
  17. .. doxygenclass:: object_api
  18. :members:
  19. Without reference counting
  20. --------------------------
  21. .. doxygenclass:: handle
  22. :members:
  23. With reference counting
  24. -----------------------
  25. .. doxygenclass:: object
  26. :members:
  27. .. doxygenfunction:: reinterpret_borrow
  28. .. doxygenfunction:: reinterpret_steal
  29. Convenience classes for specific Python types
  30. =============================================
  31. .. doxygenclass:: module_
  32. :members:
  33. .. doxygengroup:: pytypes
  34. :members:
  35. Convenience functions converting to Python types
  36. ================================================
  37. .. doxygenfunction:: make_tuple(Args&&...)
  38. .. doxygenfunction:: make_iterator(Iterator, Sentinel, Extra &&...)
  39. .. doxygenfunction:: make_iterator(Type &, Extra&&...)
  40. .. doxygenfunction:: make_key_iterator(Iterator, Sentinel, Extra &&...)
  41. .. doxygenfunction:: make_key_iterator(Type &, Extra&&...)
  42. .. _extras:
  43. Passing extra arguments to ``def`` or ``class_``
  44. ================================================
  45. .. doxygengroup:: annotations
  46. :members:
  47. Embedding the interpreter
  48. =========================
  49. .. doxygendefine:: PYBIND11_EMBEDDED_MODULE
  50. .. doxygenfunction:: initialize_interpreter
  51. .. doxygenfunction:: finalize_interpreter
  52. .. doxygenclass:: scoped_interpreter
  53. Redirecting C++ streams
  54. =======================
  55. .. doxygenclass:: scoped_ostream_redirect
  56. .. doxygenclass:: scoped_estream_redirect
  57. .. doxygenfunction:: add_ostream_redirect
  58. Python built-in functions
  59. =========================
  60. .. doxygengroup:: python_builtins
  61. :members:
  62. Inheritance
  63. ===========
  64. See :doc:`/classes` and :doc:`/advanced/classes` for more detail.
  65. .. doxygendefine:: PYBIND11_OVERRIDE
  66. .. doxygendefine:: PYBIND11_OVERRIDE_PURE
  67. .. doxygendefine:: PYBIND11_OVERRIDE_NAME
  68. .. doxygendefine:: PYBIND11_OVERRIDE_PURE_NAME
  69. .. doxygenfunction:: get_override
  70. Exceptions
  71. ==========
  72. .. doxygenclass:: error_already_set
  73. :members:
  74. .. doxygenclass:: builtin_exception
  75. :members:
  76. Literals
  77. ========
  78. .. doxygennamespace:: literals