c4aaf373aa
This should help reduce warning spew when building with newer compilers. The pybind11::module type has been renamed pybind11::module_ to avoid conflicts with c++20 modules, according to the pybind11 changelog, so this CL also updates gem5 source to use the new type. There is supposedly an alias pybind11::module which is for compatibility, but we still get linker errors without changing to pybind11::module_. Change-Id: I0acb36215b33e3a713866baec43f5af630c356ee Reviewed-on: https://gem5-review.googlesource.com/c/public/gem5/+/40255 Maintainer: Bobby R. Bruce <bbruce@ucdavis.edu> Reviewed-by: Bobby R. Bruce <bbruce@ucdavis.edu> Tested-by: kokoro <noreply+kokoro@google.com>
44 lines
1.5 KiB
ReStructuredText
44 lines
1.5 KiB
ReStructuredText
.. _type-conversions:
|
|
|
|
Type conversions
|
|
################
|
|
|
|
Apart from enabling cross-language function calls, a fundamental problem
|
|
that a binding tool like pybind11 must address is to provide access to
|
|
native Python types in C++ and vice versa. There are three fundamentally
|
|
different ways to do this—which approach is preferable for a particular type
|
|
depends on the situation at hand.
|
|
|
|
1. Use a native C++ type everywhere. In this case, the type must be wrapped
|
|
using pybind11-generated bindings so that Python can interact with it.
|
|
|
|
2. Use a native Python type everywhere. It will need to be wrapped so that
|
|
C++ functions can interact with it.
|
|
|
|
3. Use a native C++ type on the C++ side and a native Python type on the
|
|
Python side. pybind11 refers to this as a *type conversion*.
|
|
|
|
Type conversions are the most "natural" option in the sense that native
|
|
(non-wrapped) types are used everywhere. The main downside is that a copy
|
|
of the data must be made on every Python ↔ C++ transition: this is
|
|
needed since the C++ and Python versions of the same type generally won't
|
|
have the same memory layout.
|
|
|
|
pybind11 can perform many kinds of conversions automatically. An overview
|
|
is provided in the table ":ref:`conversion_table`".
|
|
|
|
The following subsections discuss the differences between these options in more
|
|
detail. The main focus in this section is on type conversions, which represent
|
|
the last case of the above list.
|
|
|
|
.. toctree::
|
|
:maxdepth: 1
|
|
|
|
overview
|
|
strings
|
|
stl
|
|
functional
|
|
chrono
|
|
eigen
|
|
custom
|