PySide Binding Generation Tutorial: Module 4 The Global Header

From Qt Wiki
Revision as of 10:03, 24 February 2015 by Maintenance script (talk | contribs)
Jump to navigation Jump to search


[toc align_right="yes" depth="3"]

English "French":http://qt-devnet.developpez.com/tutoriels/python/pyside/binding-shiboken/#LVI

The Global Header

In addition to the information provided by the type system, the generator needs to gather more data from the library headers containing the classes to be exported to Python. If there is a header that includes all the others (or just one, as is the case of libfoo) this could be passed directly to the generator.

If such a file is not available, or only a subset of the library is desired, or if some flags must be set through <code&gt;#define&lt;/code&gt; statements before parsing the library headers, then a <code&gt;global.h&lt;/code&gt; file must be provided. For example, if NULL is not defined and it is used as a default parameter for some constructor or method, the parser will not recognize it.

global.h

<br />#undef QT_NO_STL<br />#undef QT_NO_STL_WCHAR

#ifndef NULL<br />#define NULL 0<br />#endif

#include &quot;pyside_global.h&amp;quot;<br />#include &lt;foo.h&amp;gt;<br />

<code&gt;pyside_global.h&lt;/code&gt; contains includes and definitions needed to generate the PySide bindings. It was copied from the resulting file after processing of <code&gt;pyside/PySide/global.pc.in&lt;/code&gt;. At the moment the file is included in this tutorial's source code tarball, but the desirable situation is to have it provided by PySide itself. For the time being just copy it to your PySide based binding projects.