incubator-nuttx/libxx
Gregory Nutt db78b76102 Mostly updates and corrections to .gitignore files 2013-04-04 15:39:50 -06:00
..
.gitignore Mostly updates and corrections to .gitignore files 2013-04-04 15:39:50 -06:00
Kconfig Patches from Petteri Aimonen + stdbool and rand() changes for Freddie Chopin 2012-12-07 16:00:56 +00:00
Makefile Missing comma in EVERY DELFILE/DELDIR macro call in every Makefile 2012-11-20 15:47:41 +00:00
README.txt uClibc++ compiles... but it is a long way from linking 2012-11-01 21:08:56 +00:00
libxx_cxa_atexit.cxx More changes for a kernel-mode allocator (more to be done) 2013-03-09 21:12:20 +00:00
libxx_cxapurevirtual.cxx Add support for C++ static constructors (at least to a few platforms) 2012-02-28 21:58:24 +00:00
libxx_delete.cxx More changes for a kernel-mode allocator (more to be done) 2013-03-09 21:12:20 +00:00
libxx_deletea.cxx More changes for a kernel-mode allocator (more to be done) 2013-03-09 21:12:20 +00:00
libxx_eabi_atexit.cxx Add __cxa_atexit(); atexit() is now built on top of on_exit() 2012-11-01 16:50:53 +00:00
libxx_internal.hxx More changes for a kernel-mode allocator (more to be done) 2013-03-09 21:12:20 +00:00
libxx_new.cxx More changes for a kernel-mode allocator (more to be done) 2013-03-09 21:12:20 +00:00
libxx_newa.cxx More changes for a kernel-mode allocator (more to be done) 2013-03-09 21:12:20 +00:00
libxx_stdthrow.cxx Add handler for bad_function_call. Petteri Aimonen patch 0015 2013-02-28 19:26:17 +00:00

README.txt

libxx/README.txt
^^^^^^^^^^^^^^^^

This directory contains a fragmentary C++ library that will allow
to build only the simplest of C++ applications.  In the deeply
embedded world, that is probably all that is necessary.  If you
have a need for more extensive C++ support, the following libraries
are recommended:

 - libstdc++  (part of GCC)
 - STLport    http://www.stlport.org/ 
 - uClibc++   http://cxx.uclibc.org/
 - uSTL       http://ustl.sourceforge.net/

There is a version of uClibc++ that is customized for NuttX that can
be found here:  misc/uClibc++.  See misc/uClibc++ for installation
instructions.

At present, only the following are supported here:

 - void *operator new(std::size_t nbytes);
 - void operator delete(void* ptr);
 - void operator delete[](void *ptr);
 - void __cxa_pure_virtual(void);
 - int __aeabi_atexit(void* object, void (*destroyer)(void*), void *dso_handle);
 - int __cxa_atexit(__cxa_exitfunc_t func, FAR void *arg, FAR void *dso_handle);
 
operator new
------------

  This operator should take a type of size_t.  But size_t has an unknown underlying
  type.  In the nuttx sys/types.h header file, size_t is typed as uint32_t
  (which is determined by architecture-specific logic).  But the C++
  compiler may believe that size_t is of a different type resulting in
  compilation errors in the operator.  Using the underlying integer type
  instead of size_t seems to resolve the compilation issues. Need to
  REVISIT this.

  Once some C++ compilers, this will cause an error:

    Problem:     "'operator new' takes size_t ('...') as first parameter"
    Workaround:  Add -fpermissive to the compilation flags