blob: d9dc961c2dd4f2cec5afb04a349c0728f9955d9b [file] [log] [blame]
Wenzel Jakob28f98aa2015-10-13 02:57:16 +02001.. _reference:
2
Wenzel Jakob93296692015-10-13 23:21:54 +02003.. warning::
4
5 Please be advised that the reference documentation discussing pybind11
6 internals is currently incomplete. Please refer to the previous sections
Wenzel Jakob8f4eb002015-10-15 18:13:33 +02007 and the pybind11 header files for the nitty gritty details.
Wenzel Jakob93296692015-10-13 23:21:54 +02008
Wenzel Jakob28f98aa2015-10-13 02:57:16 +02009Reference
10#########
11
12Macros
13======
14
Dean Moldovan443ab592017-04-24 01:51:44 +020015.. doxygendefine:: PYBIND11_MODULE
Wenzel Jakob28f98aa2015-10-13 02:57:16 +020016
17.. _core_types:
18
19Convenience classes for arbitrary Python types
20==============================================
21
Dean Moldovan57a9bbc2017-01-31 16:54:08 +010022Common member functions
23-----------------------
24
25.. doxygenclass:: object_api
26 :members:
27
Wenzel Jakob28f98aa2015-10-13 02:57:16 +020028Without reference counting
29--------------------------
30
Dean Moldovan57a9bbc2017-01-31 16:54:08 +010031.. doxygenclass:: handle
32 :members:
Wenzel Jakob28f98aa2015-10-13 02:57:16 +020033
34With reference counting
35-----------------------
36
Dean Moldovan57a9bbc2017-01-31 16:54:08 +010037.. doxygenclass:: object
38 :members:
Wenzel Jakob28f98aa2015-10-13 02:57:16 +020039
Dean Moldovan57a9bbc2017-01-31 16:54:08 +010040.. doxygenfunction:: reinterpret_borrow
Wenzel Jakob28f98aa2015-10-13 02:57:16 +020041
Dean Moldovan57a9bbc2017-01-31 16:54:08 +010042.. doxygenfunction:: reinterpret_steal
Wenzel Jakob28f98aa2015-10-13 02:57:16 +020043
44Convenience classes for specific Python types
45=============================================
46
Dean Moldovan57a9bbc2017-01-31 16:54:08 +010047.. doxygenclass:: module
48 :members:
Wenzel Jakob28f98aa2015-10-13 02:57:16 +020049
Dean Moldovan57a9bbc2017-01-31 16:54:08 +010050.. doxygengroup:: pytypes
51 :members:
Wenzel Jakob28f98aa2015-10-13 02:57:16 +020052
53.. _extras:
54
Dean Moldovan57a9bbc2017-01-31 16:54:08 +010055Passing extra arguments to ``def`` or ``class_``
56================================================
Wenzel Jakob28f98aa2015-10-13 02:57:16 +020057
Dean Moldovan57a9bbc2017-01-31 16:54:08 +010058.. doxygengroup:: annotations
59 :members:
Wenzel Jakob28f98aa2015-10-13 02:57:16 +020060
Dean Moldovan22c413b2017-03-30 00:20:42 +020061Embedding the interpreter
62=========================
63
64.. doxygendefine:: PYBIND11_EMBEDDED_MODULE
65
66.. doxygenfunction:: initialize_interpreter
67
68.. doxygenfunction:: finalize_interpreter
69
70.. doxygenclass:: scoped_interpreter
71
Dean Moldovan57a9bbc2017-01-31 16:54:08 +010072Python build-in functions
73=========================
Wenzel Jakob28f98aa2015-10-13 02:57:16 +020074
Dean Moldovan57a9bbc2017-01-31 16:54:08 +010075.. doxygengroup:: python_builtins
76 :members:
Wenzel Jakob28f98aa2015-10-13 02:57:16 +020077
Dean Moldovan57a9bbc2017-01-31 16:54:08 +010078Exceptions
79==========
Wenzel Jakob28f98aa2015-10-13 02:57:16 +020080
Dean Moldovan57a9bbc2017-01-31 16:54:08 +010081.. doxygenclass:: error_already_set
82 :members:
Wenzel Jakob93296692015-10-13 23:21:54 +020083
Dean Moldovan57a9bbc2017-01-31 16:54:08 +010084.. doxygenclass:: builtin_exception
85 :members:
Wenzel Jakob28f98aa2015-10-13 02:57:16 +020086
Wenzel Jakob28f98aa2015-10-13 02:57:16 +020087
Dean Moldovan57a9bbc2017-01-31 16:54:08 +010088Literals
89========
Wenzel Jakob28f98aa2015-10-13 02:57:16 +020090
Dean Moldovan57a9bbc2017-01-31 16:54:08 +010091.. doxygennamespace:: literals