PySide Binding Generation Tutorial: Module 4 The Global Header: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
No edit summary
 
(Change category "LanguageBindings::PySide::Shiboken::PySide Binding Generation Tutorial" -> "PySide")
 
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
'''English''' [http://qt-devnet.developpez.com/tutoriels/python/pyside/binding-shiboken/#LVI French] ''[qt-devnet.developpez.com]''


* '''Note:''' this article is a member of the multipart [http://developer.qt.nokia.com/wiki/Category:LanguageBindings::PySide::Shiboken::PySide_Binding_Generation_Tutorial PySide Binding Generation Tutorial] ''[developer.qt.nokia.com]''


=The Global Header=
[[Category:PySide]]
 
 
'''English''' [http://qt-devnet.developpez.com/tutoriels/python/pyside/binding-shiboken/#LVI French]
 
 
* '''Note:''' this article is a member of the multipart [https://wiki.qt.io/PySide_Binding_Generation_Tutorial PySide Binding Generation Tutorial]
 
= 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.
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>#define</code> statements before parsing the library headers, then a <code>global.h</code> file must be provided. For example, if <span class="caps">NULL</span> is not defined and it is used as a default parameter for some constructor or method, the parser will not recognize it.
If such a file is not available, or only a subset of the library is desired, or if some flags must be set through '''#define''' statements before parsing the library headers, then a '''global.h''' 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==
== global.h ==


<code>pyside_global.h</code> contains includes and definitions needed to generate the PySide bindings. It was copied from the resulting file after processing of <code>pyside/PySide/global.pc.in</code>. 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.
<code>
#undef QT_NO_STL
#undef QT_NO_STL_WCHAR


===Categories:===
#ifndef NULL
#define NULL 0
#endif


* [[:Category:LanguageBindings|LanguageBindings]]
#include "pyside_global.h"
** [[:Category:LanguageBindings::PySide|PySide]]
#include <foo.h>
* [[:Category:LanguageBindings::PySide::Shiboken|Shiboken]]
</code>


* [[:Category:LanguageBindings::PySide::Shiboken::PySide Binding Generation Tutorial|PySide_Binding_Generation_Tutorial]]
'''pyside_global.h''' contains includes and definitions needed to generate the PySide bindings. It was copied from the resulting file after processing of '''pyside/PySide/global.pc.in'''. 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.

Latest revision as of 05:06, 5 June 2016


English French


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 #define statements before parsing the library headers, then a global.h 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

#undef QT_NO_STL
#undef QT_NO_STL_WCHAR

#ifndef NULL
#define NULL 0
#endif

#include "pyside_global.h"
#include <foo.h>

pyside_global.h contains includes and definitions needed to generate the PySide bindings. It was copied from the resulting file after processing of pyside/PySide/global.pc.in. 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.