STLport for Android

WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING

     This feature is currently in beta. In case of issue
     please contact the android-ndk support forum or
     file bugs at http://b.android.com

WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING

This directory contains a port of STLport for Android, which provides
a simple STL implementation. Note that it currently does not support
C++ exceptions and RTTI. Support for wchar_t and locales is probably buggy.

You can either use it as a static or shared library.

1/ The static library is recommended if you will only produce
   one shared library for your project. All necessary STLport functions
   will be added to it. This option should also generate smaller
   overall binaries.

2/ The shared library, is recommended if you want to produce
   several shared libraries in your project, because it avoids copying the
   same STLport functions to each one of them, and having different instances
   of the same global variables (which can easily conflict or result in
   undefined behaviour).

To use the *static* library, define APP_STL in your Application.mk as follows:

    APP_STL := stlport_static

To use the *shared* library, use "stlport_shared" instead:

    APP_STL := stlport_shared

Note that, in this case, you will need, in your application, to explicitely
load the 'stlport_shared' library before any library that depends on it.
For example:

    static {
        System.loadLibrary("stlport_shared");
        System.loadLibrary("foo");
        System.loadLibrary("bar");
    }

If both libfoo.so and libbar.so depend on STLport.

You can build the STLport unit test program by doing the following:

  cd $NDK
  tests/run-tests.sh --test=test-stlport

If you have an Android device connected to your machine, this will
automatically try to run the generated test command. Note that for now
a few tests are still failing (mostly related to wchar_t and locales).

They should be fixed hopefully by a later release of this library.

The NDK comes with prebuilt binaries for this library to speed up development.
You can however rebuild them from sources in your own application build by
defining STLPORT_FORCE_REBUILD to 'true' in your Application.mk as in:

    STLPORT_FORCE_REBUILD := true


VERSION INFORMATION: This module is based on STLport version 5.2.0

Version: 5.2.1

Changes:
    * Added _android.h included by _system.h
    * Do not use linux float functions in num_get_float.cpp as Android does not
      have them.
    * _mbstate_t.h cannot define its own mbstate_t as bionic already defines
      it.
    * _pair.h needs to define bionic's (sgi's) internal pair header guard.

**********************************************************************
* 	README file for STLport 5.0                                    *
*                                                                    *
**********************************************************************

This directory contains the STLport-5.0 release.

What's inside :

README           - this file
INSTALL          - installation instructions

bin              - installation directory for STLport unit tests;
                   it may contain more subdirs, if you use
                   crosscompilation
build/lib        - build directory for STLport library (if you use
                   STLport iostreams and/or locale only)
build/test/unit  - build directory for regression (unit) tests
build/test/eh    - build directory for exception handling tests
stlport          - main STLport include directory
src              - source for iostreams implementation and other parts
                   that aren't pure template code
lib              - installation directory for STLport library (if you
                   use STLport iostreams and/or locale only);
                   it may contain more subdirs, if you use
                   crosscompilation
test/unit        - unit (regression) tests
test/eh          - exception handling test using STLport iostreams
etc              - miscellanous files (ChangeLog, TODO, scripts, etc.)

GETTING STLPORT

To download the latest version of STLport, please be sure to visit
https://sourceforge.net/project/showfiles.php?group_id=146814

LEGALESE

This software is being distributed under the following terms:

 *
 *
 * Copyright (c) 1994
 * Hewlett-Packard Company
 *
 * Copyright (c) 1996-1999
 * Silicon Graphics Computer Systems, Inc.
 *
 * Copyright (c) 1997
 * Moscow Center for SPARC Technology
 *
 * Copyright (c) 1999-2003
 * Boris Fomitchev
 *
 * This material is provided "as is", with absolutely no warranty expressed
 * or implied. Any use is at your own risk.
 *
 * Permission to use or copy this software for any purpose is hereby granted
 * without fee, provided the above notices are retained on all copies.
 * Permission to modify the code and to distribute modified code is granted,
 * provided the above notices are retained, and a notice that the code was
 * modified is included with the above copyright notice.
 *

**********************************************************************