File: call.qbk

package info (click to toggle)
boost1.83 1.83.0-5
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 545,632 kB
  • sloc: cpp: 3,857,086; xml: 125,552; ansic: 34,414; python: 25,887; asm: 5,276; sh: 4,799; ada: 1,681; makefile: 1,629; perl: 1,212; pascal: 1,139; sql: 810; yacc: 478; ruby: 102; lisp: 24; csh: 6
file content (26 lines) | stat: -rw-r--r-- 1,120 bytes parent folder | download | duplicates (10)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
[section boost/python/call.hpp]
[section Introduction]
 <boost/python/call.hpp> defines the call family of overloaded function templates, used to invoke Python callable objects from C++. 
[endsect]
[section Function `call`]
``
template <class R, class A1, class A2, ... class An>
R call(PyObject* callable, A1 const&, A2 const&, ... An const&)
``
[variablelist
[[Requires][R is a pointer type, reference type, or a complete type with an accessible copy constructor]]
[[Effects][Invokes callable(a1, a2, ...an) in Python, where a1...an are the arguments to call(), converted to Python objects. ]]
[[Returns][The result of the Python call, converted to the C++ type R.]]
[[Rationale][For a complete semantic description and rationale, see this page. ]]
]
[endsect]
[section Example]
The following C++ function applies a Python callable object to its two arguments and returns the result. If a Python exception is raised or the result can't be converted to a double, an exception is thrown. 
``
double apply2(PyObject* func, double x, double y)
{
   return boost::python::call<double>(func, x, y);
}
``
[endsect]
[endsect]