The following is not meant to be an exhaustive list, but more of a show case. Most features will be fairly obvious in their use.
The C++ code used for the examples below can be found
here, and it is assumed that that code is
loaded at the start of any session.
Download it, save it under the name
features.h, and load it:
>>> import cppyy >>> cppyy.include('features.h') >>>
memory: C++ instances created by calling their constructor from python are owned by python. You can check/change the ownership with the __python_owns__ flag that every bound instance carries. Example:
>>> from cppyy.gbl import Concrete >>> c = Concrete() >>> c.__python_owns__ # True: object created in Python True >>>
namespaces: Are represented as python classes. Namespaces are more open-ended than classes, so sometimes initial access may result in updates as data and functions are looked up and constructed lazily. Thus the result of
dir()on a namespace shows the classes available, even if they may not have been created yet. It does not show classes that could potentially be loaded by the class loader. Once created, namespaces are registered as modules, to allow importing from them. Namespace currently do not work with the class loader. Fixing these bootstrap problems is on the TODO list. The global namespace is
NULL: Is represented as
cppyy.gbl.nullptr. In C++11, the keyword
nullptris used to represent
NULL. For clarity of intent, it is recommended to use this instead of
None(or the integer
0, which can serve in some cases), as
Noneis better understood as
static methods: Are represented as python’s
staticmethodobjects and can be called both from the class as well as from instances.
templated functions: Automatically participate in overloading and are used in the same way as other global functions.
templated methods: For now, require an explicit selection of the template parameters. This will be changed to allow them to participate in overloads as expected.
unary operators: Are supported if a python equivalent exists, and if the operator is defined in the C++ class.