configure.html

内含stl 的很多书籍

              allocator engine. </font></td>
          </tr>
          <tr>
            <td><font size="1" face="Arial, Helvetica"><b>_STLP_DEBUG_ALLOC </b></font></td>
            <td><font face="Arial, Helvetica" size="2">This makes <b>allocator</b>&lt;&gt;
              to perform memory debugging, such as padding/checking for memory
              consistency. </font></td>
          </tr>
          <tr>
            <td><font size="1" face="Arial, Helvetica"><b>_STLP_DEBUG_UNINITIALIZED </b></font></td>
            <td><font face="Arial, Helvetica" size="2">
	    Use this option to catch uninitialized members in your classes.
	    When it is set, construct() and destroy() fill the class storage
	    with _STLP_SHRED_BYTE (see below). 
	    Note : _STLP_DEBUG and _STLP_DEBUG_ALLOC don't set this option automatically
	    </font></td>
          </tr>
          <tr>
            <td><font size="1" face="Arial, Helvetica"><b>_STLP_SHRED_BYTE </b></font></td>
            <td><font face="Arial, Helvetica" size="2">Provides a definition for
              the byte with which raw memory will be filled if _STLP_DEBUG_ALLOC or _STLP_DEBUG_UNINITIALIZED
              is defined. Choose a value which is likely to cause a noticeable
              problem if dereferenced or otherwise abused. A good value may
              already be defined for your platform; see <b>stldebug.h</b> </font></td>
          </tr>
          <tr>
            <td><font size="1" face="Arial, Helvetica"><b>_STLP_DONT_THROW_RANGE_ERRORS </b></font></td>
            <td><font face="Arial, Helvetica" size="2">
	    This macro prevents instantiation of at() member function
	    for containers (vector and deque).
	    We do not instantiate at() that does not throw range errors -
	    if this macro is defined, at() method is not defined.
	    </font></td>
          </tr>
          <tr>
            <td><font size="1" face="Arial, Helvetica"><b>_STLP_MSVC50_COMPATIBILITY
              </b></font></td>
            <td><font face="Arial, Helvetica" size="2">This definition makes SGI
              <b>reverse_iterator</b> to be compatible with other parts of MSVC
              library. (With partial specialization, it just has no effect). Its
              use is strongly discouraged - for MSVC5.0 configuration, it is
              being set automatically. </font></td>
          </tr>
          <tr>
            <td><font size="1" face="Arial, Helvetica"><b>_STLP_USE_MFC </b></font></td>
            <td><font face="Arial, Helvetica" size="2">
	    You should define this macro if compiling with MFC - STLport &lt;stl/_config.h&gt;
	    then include &lt;afx.h&gt; instead of &lt;windows.h&gt; to get synchronisation primitives
	    </font></td>
          </tr>
          <tr>
            <td><font size="1" face="Arial, Helvetica"><b>_STLP_MINIMUM_DEFAULT _TEMPLATE_PARAMS</b></font></td>
            <td><font face="Arial, Helvetica" size="2">
	    Use minimum set of default arguments on template classes that have more
	    than one - for example map&lt;&gt;, set&lt;&gt;.
	    This has effect only if _STLP_LIMITED_DEFAULT_TEMPLATES is on.
	    </font></td>
          </tr>
          <tr>
            <td><font size="1" face="Arial, Helvetica"><b>_STLP_NO_PROXY_ARROW_OPERATOR</b></font></td>
            <td><font face="Arial, Helvetica" size="2">
	    By default, STLport uses proxy technique to enable operator -&gt; for
	    iterators even for those compilers that check the return type of
	    unused instantiations. If this causes problems for your project, turn this
	    switch on to disable proxy -&gt;() operators.
	    </font></td>
          </tr>
          <tr>
            <td><font size="1" face="Arial, Helvetica"><b>_STLP_USE_ABBREVS</b></font></td>
            <td><font face="Arial, Helvetica" size="2">Use abbreviated class
              names internally for linker benefit (don't affect interface). This
              option is obsolete, but should work in this release.</font></td>
          </tr>
          <tr>
            <td><font face="Arial, Helvetica" size="1"><b>_STLP_USE_DECLSPEC
              </b></font></td>
            <td><font face="Arial, Helvetica" size="2">
	   (Windows only) This switch makes some STLport symbols exported from DLL.
           To use export feature, you should define this macro for all compilation units and
           also define _STLP_DESIGNATED_DLL macro for one of your DLL's which is supposed to export
           all STLport symbols. You must use this feature if you use default node allocator and pass
           objects across DLL boundaries. Defined automatically if you use STLport iostreams and
	   compile with /MD flag.
	    </font></td>
          </tr>

          <tr>
            <td><font face="Arial, Helvetica" size="1"><b>_STLP_DESIGNATED_DLL
              </b></font></td>
            <td><font face="Arial, Helvetica" size="2">
	   (Windows only) Designed to be used together with _STLP_USE_DECLSPEC switch to
           make one of your DLL's to export STLport symbols for other modules. 
           The library which is designated to export DLL symbols, must have both of
           those switches defined for compilation and it should include at least &lt;string&gt;
           header from at least one source file. Used by STLport internally to build STLport DLL.
	    </font></td>
          </tr>

        </table>
        <p><b>Notes:</b></p>
        <ul>
          <li>When using tools like Purify (c), Codeguard (c) or BoundsChecker
            (c), it is advised to <tt>#define _STLP_USE_MALLOC</tt> or <tt>_STLP_USE_NEWALLOC</tt>,
            otherwise pointer checking will generally not be available on most
            STL internal structures, thus defeating the purpose of those tools.</li>
        </ul>
        <p>&nbsp;</p>

	<a name="compiler_switches"></a>
        <h3>Compiler-specific switches</h3>

        <p>Compiler-specific switches are STLport macros describing compiler (mis)features/bugs.Below is the
        table describing them. They are designed in such a way that the compiler 
        that implements complete set of ANSI C++ features and has no bugs ;) would 
	have empty configuration file.</p>

	STLport also provides a script that is designed to help you setting those numerous switches.
	Please read <a href="auto_configure.html">Running configure</a> chapter to learn more about this tool. 
	<br><i>Note : <b>do not</b> expect STLport to be configured just by running "configure".
	It is provided only as a tool to help in the initial configuration phase.</i>

        <table border="1" cellspacing="0" cellpadding="4">
          <caption>
            <h4>STLport macros describing compiler features</h4>
          </caption>
          <tr>
            <td><b>Controlling macro name</b></td>
            <td><b>Description</b></td>
            <td><b>Default</b></td>
          </tr>
          <tr>
            <td><font size="1" face="Arial, Helvetica"><b>_STLP_UINT32_T</b></font></td>
            <td><font face="Arial, Helvetica" size="2">Unsigned 32-bit integral
              type</font></td>
            <td><font face="Arial, Helvetica" size="2">unsigned long</font></td>
          </tr>
          <tr>
            <td><font size="1" face="Arial, Helvetica"><b>_STLP_LONG_LONG</b></font></td>
            <td><font face="Arial, Helvetica" size="2">Defined if compiler
              supports non-standard <b>long long</b> type</font></td>
            <td><font face="Arial, Helvetica" size="2">Off</font></td>
          </tr>

          <tr>
            <td><font size="1" face="Arial, Helvetica"><b>_STLP_NO_WCHAR_T</b></font></td>
            <td><font face="Arial, Helvetica" size="2">Defined if compiler
              does not support <b>wchar_t</b> type</font></td>
            <td><font face="Arial, Helvetica" size="2">Off</font></td>
          </tr>
          <tr>
            <td><font face="Arial, Helvetica" size="1"><b>_STLP_WCHAR_T_IS_USHORT
              </b></font></td>
            <td><font face="Arial, Helvetica" size="2">wchar_t is not a unique
              type, and is actually a typedef to unsigned short </font></td>
            <td><font face="Arial, Helvetica" size="2">Off</font></td>
          </tr>
          <tr>
            <td><font size="1" face="Arial, Helvetica"><b>_STLP_NO_LONG_DOUBLE</b></font></td>
            <td><font face="Arial, Helvetica" size="2">Defined if compiler
              does not support <b>long double</b> type</font></td>
            <td><font face="Arial, Helvetica" size="2">Off</font></td>
          </tr>
          <tr>
            <td><font size="1" face="Arial, Helvetica"><b>_STLP_NO_TYPENAME</b></font></td>
            <td><font face="Arial, Helvetica" size="2">Defined if your compiler
              does not support <b>typename </b>keyword</font></td>
            <td><font face="Arial, Helvetica" size="2">Off</font></td>
          </tr>
          <tr>
            <td><font size="1" face="Arial, Helvetica"><b>_STLP_NO_EXPLICIT</b></font></td>
            <td><font face="Arial, Helvetica" size="2">Defined if your compiler
              does not support <b>explicit </b>keyword</font></td>
            <td><font face="Arial, Helvetica" size="2">Off</font></td>
          </tr>
          <tr>
            <td><font size="1" face="Arial, Helvetica"><b>_STLP_NO_MUTABLE</b></font></td>
            <td><font face="Arial, Helvetica" size="2">Defined if your compiler
              does not support <b>mutable </b>keyword</font></td>
            <td><font face="Arial, Helvetica" size="2">Off</font></td>
          </tr>
          <tr>
            <td><font size="1" face="Arial, Helvetica"><b>_STLP_NO_NEW_STYLE_CASTS</b></font></td>
            <td><font face="Arial, Helvetica" size="2">Defined if compiler
              does not support new-style <b>const_cast&lt;&gt;</b></font></td>
            <td><font face="Arial, Helvetica" size="2">Off</font></td>
          </tr>
          <tr>
            <td><font size="1" face="Arial, Helvetica"><b>_STLP_NO_BOOL</b></font></td>
            <td><font face="Arial, Helvetica" size="2">Defined if the compiler
              does not support <b>bool</b></font></td>
            <td><font face="Arial, Helvetica" size="2">Off</font></td>
          </tr>
          <tr>
            <td><font size="1" face="Arial, Helvetica"><b>_STLP_DONT_USE_BOOL_TYPEDEF</b></font></td>
            <td><font face="Arial, Helvetica" size="2">Bool not supported, but
              keyword is reserved for future use</font></td>
            <td><font face="Arial, Helvetica" size="2">Off</font></td>