This commit was generated by cvs2svn to compensate for changes in r711,

which included commits to RCS files with non-trunk default branches.


[SVN r8328]

example/example1.cpp

@@ -0,0 +1,54 @@
+#include <string.h>
+
+namespace hello {
+  class world
+  {
+   public:
+      world(int) {}
+      ~world() {}
+      const char* get() const { return "hi, world"; }
+  };
+
+  size_t length(const world& x) { return strlen(x.get()); }
+}
+
+#include <boost/python/class_builder.hpp>
+
+// Python requires an exported function called init<module-name> in every
+// extension module. This is where we build the module contents.
+extern "C"
+#ifdef _WIN32
+__declspec(dllexport)
+#endif
+void inithello()
+{
+    try
+    {
+       // create an object representing this extension module
+       boost::python::module_builder hello("hello");
+
+       // Create the Python type object for our extension class
+       boost::python::class_builder<hello::world> world_class(hello, "world");
+
+       // Add the __init__ function
+       world_class.def(boost::python::constructor<int>());
+       // Add a regular member function
+       world_class.def(&hello::world::get, "get");
+
+       // Add a regular function to the module
+       hello.def(hello::length, "length");
+    }
+    catch(...)
+    {
+       boost::python::handle_exception();    // Deal with the exception for Python
+    }
+}
+
+// Win32 DLL boilerplate
+#if defined(_WIN32)
+#include <windows.h>
+extern "C" BOOL WINAPI DllMain(HINSTANCE, DWORD, LPVOID)
+{
+    return 1;
+}
+#endif // _WIN32

example/example1.py

@@ -0,0 +1,50 @@
+r'''
+//  (C) Copyright David Abrahams 2000. Permission to copy, use, modify, sell and
+//  distribute this software is granted provided this copyright notice appears
+//  in all copies. This software is provided "as is" without express or implied
+//  warranty, and with no claim as to its suitability for any purpose.
+//
+//  The author gratefully acknowleges the support of Dragon Systems, Inc., in
+//  producing this work.
+
+That's it! If we build this shared library and put it on our PYTHONPATH we can
+now access our C++ class and function from Python.
+
+    >>> import hello
+    >>> hi_world = hello.world(3)
+    >>> hi_world.get()
+    'hi, world'
+    >>> hello.length(hi_world)
+    9
+
+We can even make a subclass of hello.world:
+
+
+    >>> class my_subclass(hello.world):
+    ...     def get(self):
+    ...         return 'hello, world'
+    ...
+    >>> y = my_subclass(2)
+    >>> y.get()
+    'hello, world'
+
+Pretty cool! You can't do that with an ordinary Python extension type!
+
+    >>> hello.length(y)
+    9
+
+Of course, you may now have a slightly empty feeling in the pit of your little
+pythonic stomach. Perhaps you feel your subclass deserves to have a length() of
+12? If so, read on...
+'''
+from hello import *
+
+def run(args = None):
+    if args is not None:
+        import sys
+        sys.argv = args
+    import doctest, test_example1
+    doctest.testmod(test_example1)
+    
+if __name__ == '__main__':
+    run()