nuttx/libs/libxx
Xiang Xiao 7d66a16c53 Minor style clean up
Signed-off-by: Xiang Xiao <xiaoxiang@xiaomi.com>
2023-01-28 19:53:20 +02:00
..
libcxxmini
.gitignore Add Embedded Template Library (ETL) support 2022-08-05 09:38:48 +08:00
0001-libc-abi-avoid-the-waring-__EXCEPTIONS-is-not-define.patch
0001-libc-avoid-the-waring-__EXCEPTIONS-is-not-defined-ev.patch
0001-libcxx-Rename-PS-macro-to-avoid-clashing-with-Xtensa.patch
0001-Remove-the-locale-fallback-for-NuttX.patch
0001-uClibcxx-basic_definitions-fix-GCC-specific-definiti.patch
0001-uclibxx-use-overload-constructor-of-filebuf-ostream.patch
0002-Omit-atomic_-un-signed_lock_free-if-unsupported.patch
etl.defs Don't download tarballs if a local git repo found 2022-12-05 10:47:36 +01:00
Kconfig c++: Change the default value of CXX_STANDARD from c++17 to gnu++17 2023-01-19 08:21:48 +01:00
libcxx.defs libxx: Add CXX_STANDARD to select -std=c++?? 2023-01-16 15:41:57 +02:00
libcxxabi.defs tools: replace DEFINE script to Makefile variable 2022-11-03 19:59:55 +08:00
libcxxmini.defs
Makefile Minor style clean up 2023-01-28 19:53:20 +02:00
README.txt
system_configuration.h
uClibc++.defs Don't download tarballs if a local git repo found 2022-12-05 10:47:36 +01:00

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

This directory contains three C++ library:

 - 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.

   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);

   This implementation is selected when neither of the following
   two options are enabled.

 - LLVM "libc++" C++ library (http://libcxx.llvm.org/)
   This implementation is selected with CONFIG_LIBCXX=y.

 - uClibc++ C++ library (http://cxx.uclibc.org/)
   This implementation is selected with CONFIG_UCLIBCXX=y.

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