STLSoft: unixstl/unixstl.h Source File

00001 /* /////////////////////////////////////////////////////////////////////////
00002  * File:        unixstl/unixstl.h
00003  *
00004  * Purpose:     Root header for the UNIXSTL libraries. Performs various compiler
00005  *              and platform discriminations, and definitions of types.
00006  *
00007  * Created:     15th January 2002
00008  * Updated:     5th February 2010
00009  *
00010  * Home:        http://stlsoft.org/
00011  *
00012  * Copyright (c) 2002-2010, Matthew Wilson and Synesis Software
00013  * All rights reserved.
00014  *
00015  * Redistribution and use in source and binary forms, with or without
00016  * modification, are permitted provided that the following conditions are met:
00017  *
00018  * - Redistributions of source code must retain the above copyright notice, this
00019  *   list of conditions and the following disclaimer.
00020  * - Redistributions in binary form must reproduce the above copyright notice,
00021  *   this list of conditions and the following disclaimer in the documentation
00022  *   and/or other materials provided with the distribution.
00023  * - Neither the name(s) of Matthew Wilson and Synesis Software nor the names of
00024  *   any contributors may be used to endorse or promote products derived from
00025  *   this software without specific prior written permission.
00026  *
00027  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
00028  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
00029  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
00030  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
00031  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
00032  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
00033  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
00034  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
00035  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
00036  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
00037  * POSSIBILITY OF SUCH DAMAGE.
00038  *
00039  * ////////////////////////////////////////////////////////////////////// */
00040 
00041 
00042 #ifndef UNIXSTL_INCL_UNIXSTL_H_UNIXSTL
00043 #define UNIXSTL_INCL_UNIXSTL_H_UNIXSTL
00044 #define UNIXSTL_INCL_H_UNIXSTL
00045 
00046 /* File version */
00047 #ifndef STLSOFT_DOCUMENTATION_SKIP_SECTION
00048 # define UNIXSTL_VER_UNIXSTL_H_UNIXSTL_MAJOR    3
00049 # define UNIXSTL_VER_UNIXSTL_H_UNIXSTL_MINOR    7
00050 # define UNIXSTL_VER_UNIXSTL_H_UNIXSTL_REVISION 2
00051 # define UNIXSTL_VER_UNIXSTL_H_UNIXSTL_EDIT     89
00052 #endif /* !STLSOFT_DOCUMENTATION_SKIP_SECTION */
00053 
00056 /* /////////////////////////////////////////////////////////////////////////
00057  * UNIXSTL version
00058  *
00059  * The libraries version information is comprised of major, minor and revision
00060  * components.
00061  *
00062  * The major version is denoted by the _UNIXSTL_VER_MAJOR preprocessor symbol.
00063  * A changes to the major version component implies that a dramatic change has
00064  * occurred in the libraries, such that considerable changes to source dependent
00065  * on previous versions would need to be effected.
00066  *
00067  * The minor version is denoted by the _UNIXSTL_VER_MINOR preprocessor symbol.
00068  * Changes to the minor version component imply that a significant change has
00069  * occurred to the libraries, either in the addition of new functionality or in
00070  * the destructive change to one or more components such that recomplilation and
00071  * code change may be necessitated.
00072  *
00073  * The revision version is denoted by the _UNIXSTL_VER_REVISION preprocessor
00074  * symbol. Changes to the revision version component imply that a bug has been
00075  * fixed. Dependent code should be recompiled in order to pick up the changes.
00076  *
00077  * In addition to the individual version symbols - _UNIXSTL_VER_MAJOR,
00078  * _UNIXSTL_VER_MINOR and _UNIXSTL_VER_REVISION - a composite symbol _UNIXSTL_VER
00079  * is defined, where the upper 8 bits are 0, bits 16-23 represent the major
00080  * component,  bits 8-15 represent the minor component, and bits 0-7 represent
00081  * the revision component.
00082  *
00083  * Each release of the libraries will bear a different version, and that version
00084  * will also have its own symbol: Version 1.0.1 specifies _UNIXSTL_VER_1_0_1.
00085  *
00086  * Thus the symbol _UNIXSTL_VER may be compared meaningfully with a specific
00087  * version symbol, e.g.# if _UNIXSTL_VER >= _UNIXSTL_VER_1_0_1
00088  */
00089 
00106 #ifndef STLSOFT_DOCUMENTATION_SKIP_SECTION
00107 # define _UNIXSTL_VER_0_9_1     0x00000901  
00108 # define _UNIXSTL_VER_0_9_2     0x00000902  
00109 # define _UNIXSTL_VER_1_0_1     0x00010001  
00110 # define _UNIXSTL_VER_1_0_2     0x00010002  
00111 # define _UNIXSTL_VER_1_0_3     0x00010003  
00112 # define _UNIXSTL_VER_1_1_1     0x00010101  
00113 # define _UNIXSTL_VER_1_2_1     0x00010201  
00114 # define _UNIXSTL_VER_1_3_1     0x00010301  
00115 # define _UNIXSTL_VER_1_4_1     0x00010401  
00116 # define _UNIXSTL_VER_1_5_1     0x00010501  
00117 # define _UNIXSTL_VER_1_6_1     0x00010601  
00118 # define _UNIXSTL_VER_1_6_2     0x00010602  
00119 # define _UNIXSTL_VER_1_6_3     0x00010603  
00120 # define _UNIXSTL_VER_1_6_4     0x00010604  
00121 # define _UNIXSTL_VER_1_6_5     0x00010605  
00122 # define _UNIXSTL_VER_1_6_6     0x00010606  
00123 # define _UNIXSTL_VER_1_6_7     0x010607ff  
00124 # define _UNIXSTL_VER_1_6_8     0x010608ff  
00125 # define _UNIXSTL_VER_1_7_1     0x010701ff  
00126 # define _UNIXSTL_VER_1_7_2     0x010702ff  
00127 # define _UNIXSTL_VER_1_7_3     0x010703ff  
00128 #endif /* !STLSOFT_DOCUMENTATION_SKIP_SECTION */
00129 
00130 #define _UNIXSTL_VER_MAJOR      1
00131 #define _UNIXSTL_VER_MINOR      7
00132 #define _UNIXSTL_VER_REVISION   3
00133 #define _UNIXSTL_VER            _UNIXSTL_VER_1_7_3
00134 
00135 /* /////////////////////////////////////////////////////////////////////////
00136  * Includes
00137  */
00138 
00139 #ifndef STLSOFT_INCL_STLSOFT_H_STLSOFT
00140 # include <stlsoft/stlsoft.h>
00141 #endif /* !STLSOFT_INCL_STLSOFT_H_STLSOFT */
00142 
00143 /* /////////////////////////////////////////////////////////////////////////
00144  * STLSoft version compatibility
00145  */
00146 
00147 #if !defined(_STLSOFT_VER) || \
00148     _STLSOFT_VER < 0x01095cff
00149 # error This version of the UNIXSTL libraries requires STLSoft version 1.9.92, or later
00150 #endif /* _STLSOFT_VER */
00151 
00152 /* /////////////////////////////////////////////////////////////////////////
00153  * Compiler compatibility
00154  *
00155  * Currently the only compilers supported by the UNIXSTL libraries are
00156  *
00157  * GCC version 2.95 or later
00158  * Intel C/C++ 6.0 or later
00159  * Sun Pro C & Sun Pro C++ versions 5.9.x or later
00160  */
00161 
00162 #if defined(STLSOFT_COMPILER_IS_COMO)
00163  /* ******************************* Comeau ****************************** */
00164 # if __COMO_VERSION__ < 4300
00165 #  error Versions of Comeau C++ prior to 4.3.0.1 are not supported by the UNIXSTL libraries
00166 # endif /* __COMO_VERSION__ */
00167 
00168 #elif defined(STLSOFT_COMPILER_IS_GCC)
00169  /* ******************************** GCC ******************************** */
00170 # if __GNUC__ < 2 || \
00171      (  __GNUC__ == 2 && \
00172         __GNUC_MINOR__ < 95)
00173 #  error Versions of GNU C/C++ prior to 2.95 are not supported by the UNIXSTL libraries
00174 # endif /* __GNUC__ */
00175 
00176 #elif defined(STLSOFT_COMPILER_IS_INTEL)
00177  /* ******************************* Intel ******************************* */
00178 # if (__INTEL_COMPILER < 700)
00179 #  error Versions of Intel C++ prior to 7.0 are not supported by the UNIXSTL libraries
00180 # endif /* __INTEL_COMPILER */
00181 
00182 #elif defined(STLSOFT_COMPILER_IS_SUNPRO)
00183  /* ******************************* Sun Pro ***************************** */
00184 # ifdef __cplusplus
00185 #  if ((__SUNPRO_CC & 0xFFF0) < 0x0590)
00186 #   error Versions of Sun Pro C++ prior to 5.9 are not supported by the UNIXSTL libraries
00187 #  endif /* __SUNPRO_CC */
00188 # else /* ? __cplusplus */
00189 #  if ((__SUNPRO_C & 0xFFF0) < 0x0590)
00190 #   error Versions of Sun Pro C prior to 5.9 are not supported by the UNIXSTL libraries
00191 #  endif /* __SUNPRO_CC */
00192 # endif /* __cplusplus */
00193 
00194 #else
00195 /* No recognised compiler */
00196 # ifdef _STLSOFT_FORCE_ANY_COMPILER
00197 #  define _UNIXSTL_COMPILER_IS_UNKNOWN
00198 #  ifdef _STLSOFT_COMPILE_VERBOSE
00199 #   pragma message("Compiler is unknown to UNIXSTL")
00200 #  endif /* _STLSOFT_COMPILE_VERBOSE */
00201 # else
00202 #  error Currently only the Comeau, GCC, Intel and Sun Pro C/C++ compilers are supported by the UNIXSTL libraries. To use other, possibly untested, compilers, define _STLSOFT_FORCE_ANY_COMPILER
00203 # endif /* _STLSOFT_FORCE_ANY_COMPILER */
00204 #endif /* compiler */
00205 
00206 /* /////////////////////////////////////////////////////////////////////////
00207  * Architecture
00208  *
00209  * The UNIX architecture.
00210  */
00211 
00212 #ifdef UNIXSTL_ARCH_IS_X86
00213 # undef UNIXSTL_ARCH_IS_X86
00214 #endif /* UNIXSTL_ARCH_IS_X86 */
00215 #ifdef UNIXSTL_ARCH_IS_IA64
00216 # undef UNIXSTL_ARCH_IS_IA64
00217 #endif /* UNIXSTL_ARCH_IS_IA64 */
00218 #ifdef UNIXSTL_ARCH_IS_X64
00219 # undef UNIXSTL_ARCH_IS_X64
00220 #endif /* UNIXSTL_ARCH_IS_X64 */
00221 
00222 #ifdef UNIXSTL_ARCH_IS_INTEL
00223 # undef UNIXSTL_ARCH_IS_INTEL
00224 #endif /* UNIXSTL_ARCH_IS_INTEL */
00225 #ifdef UNIXSTL_ARCH_IS_POWERPC
00226 # undef UNIXSTL_ARCH_IS_POWERPC
00227 #endif /* UNIXSTL_ARCH_IS_POWERPC */
00228 #ifdef UNIXSTL_ARCH_IS_ALPHA
00229 # undef UNIXSTL_ARCH_IS_ALPHA
00230 #endif /* UNIXSTL_ARCH_IS_ALPHA */
00231 #ifdef UNIXSTL_ARCH_IS_HPPA
00232 # undef UNIXSTL_ARCH_IS_HPPA
00233 #endif /* UNIXSTL_ARCH_IS_HPPA */
00234 #ifdef UNIXSTL_ARCH_IS_SPARC
00235 # undef UNIXSTL_ARCH_IS_SPARC
00236 #endif /* UNIXSTL_ARCH_IS_SPARC */
00237 #ifdef UNIXSTL_ARCH_IS_UNKNOWN
00238 # undef UNIXSTL_ARCH_IS_UNKNOWN
00239 #endif /* UNIXSTL_ARCH_IS_UNKNOWN */
00240 
00241 #if defined(__amd64__) || \
00242       defined(__amd64) || \
00243       defined(_AMD64_) || \
00244       defined(_M_AMD64) || \
00245       defined(_M_X64)
00246 # define UNIXSTL_ARCH_IS_INTEL
00247 # define UNIXSTL_ARCH_IS_X64
00248 #elif defined(__ia64__) || \
00249       defined(__ia64) || \
00250       defined(_IA64_) || \
00251       defined(_M_IA64)
00252 # define UNIXSTL_ARCH_IS_INTEL
00253 # define UNIXSTL_ARCH_IS_IA64
00254 #elif defined(__i386__) || \
00255       defined(__i386) || \
00256       defined(_X86_) || \
00257       defined(_M_IX86)
00258 # define UNIXSTL_ARCH_IS_INTEL
00259 # define UNIXSTL_ARCH_IS_X86
00260 #elif defined(__alpha__) || \
00261       defined(__alpha) || \
00262       defined(_M_ALPHA)
00263 # define UNIXSTL_ARCH_IS_ALPHA
00264 #elif defined(__hppa__) || \
00265       defined(__hppa)
00266 # define UNIXSTL_ARCH_IS_HPPA
00267 #elif defined(__ppc__) || \
00268       defined(__ppc) || \
00269       defined(__POWERPC__) || \
00270       defined(_POWER) || \
00271       defined(_M_PPC)
00272 # define UNIXSTL_ARCH_IS_POWERPC
00273 #elif defined(__sparc__) || \
00274       defined(__sparc)
00275 /* TODO: Separate out arch-family and archs (incl. Sparc32 and Sparc64) */
00276 # define UNIXSTL_ARCH_IS_SPARC
00277 #else /* ? arch */
00278 # define UNIXSTL_ARCH_IS_UNKNOWN
00279 #endif /* ? arch */
00280 
00281 /* /////////////////////////////////////////////////////////////////////////
00282  * Operating system family
00283  *
00284  * In some circumstances more than one of these may be defined.
00285  *
00286  * Some of this os-discrimination is provided by SourceForge (http://predef.sourceforge.net/preos.html)
00287  */
00288 
00289 #ifdef UNIXSTL_OSFAMILY_IS_BSD
00290 # undef UNIXSTL_OSFAMILY_IS_BSD
00291 #endif /* UNIXSTL_OSFAMILY_IS_BSD */
00292 #ifdef UNIXSTL_OSFAMILY_IS_SVR4
00293 # undef UNIXSTL_OSFAMILY_IS_SVR4
00294 #endif /* UNIXSTL_OSFAMILY_IS_SVR4 */
00295 
00296 
00297 #if defined(__FreeBSD__) || \
00298     defined(__NetBSD__) || \
00299     defined(__OpenBSD__) || \
00300     defined(__bsdi__) || \
00301     defined(_SYSTYPE_BSD)
00302 # define UNIXSTL_OSFAMILY_IS_BSD
00303 #endif /* bsd */
00304 
00305 #if defined(__sysv__) || \
00306     defined(__SVR4) || \
00307     defined(__svr4__) || \
00308     defined(_SYSTYPE_SVR4)
00309 # define UNIXSTL_OSFAMILY_IS_SVR4
00310 #endif /* SVR4 */
00311 
00312 /* /////////////////////////////////////////////////////////////////////////
00313  * Operating system
00314  *
00315  * The UNIX operating system.
00316  *
00317  * Some of this os-discrimination is provided by SourceForge (http://predef.sourceforge.net/preos.html)
00318  */
00319 
00320 #ifdef UNIXSTL_OS_IS_APPLE
00321 # undef UNIXSTL_OS_IS_APPLE
00322 #endif /* UNIXSTL_OS_IS_APPLE */
00323 #ifdef UNIXSTL_OS_IS_AIX
00324 # undef UNIXSTL_OS_IS_AIX
00325 #endif /* UNIXSTL_OS_IS_AIX */
00326 #ifdef UNIXSTL_OS_IS_FREEBSD
00327 # undef UNIXSTL_OS_IS_FREEBSD
00328 #endif /* UNIXSTL_OS_IS_FREEBSD */
00329 #ifdef UNIXSTL_OS_IS_HPUX
00330 # undef UNIXSTL_OS_IS_HPUX
00331 #endif /* UNIXSTL_OS_IS_HPUX */
00332 #ifdef UNIXSTL_OS_IS_LINUX
00333 # undef UNIXSTL_OS_IS_LINUX
00334 #endif /* UNIXSTL_OS_IS_LINUX */
00335 #ifdef UNIXSTL_OS_IS_MACOSX
00336 # undef UNIXSTL_OS_IS_MACOSX
00337 #endif /* UNIXSTL_OS_IS_MACOSX */
00338 #ifdef UNIXSTL_OS_IS_NETBSD
00339 # undef UNIXSTL_OS_IS_NETBSD
00340 #endif /* UNIXSTL_OS_IS_NETBSD */
00341 #ifdef UNIXSTL_OS_IS_OPENBSD
00342 # undef UNIXSTL_OS_IS_OPENBSD
00343 #endif /* UNIXSTL_OS_IS_OPENBSD */
00344 #ifdef UNIXSTL_OS_IS_SOLARIS
00345 # undef UNIXSTL_OS_IS_SOLARIS
00346 #endif /* UNIXSTL_OS_IS_SOLARIS */
00347 #ifdef UNIXSTL_OS_IS_FREEBSD
00348 # undef UNIXSTL_OS_IS_FREEBSD
00349 #endif /* UNIXSTL_OS_IS_FREEBSD */
00350 #ifdef UNIXSTL_OS_IS_UNKNOWN
00351 # undef UNIXSTL_OS_IS_UNKNOWN
00352 #endif /* UNIXSTL_OS_IS_UNKNOWN */
00353 
00354 #if defined(__APPLE__) || \
00355     defined(__MACOSX__)
00356 # define UNIXSTL_OS_IS_APPLE
00357 # define UNIXSTL_OS_IS_MACOSX
00358 #elif defined(_AIX)
00359 # define UNIXSTL_OS_IS_AIX
00360 #elif defined(__FreeBSD__)
00361 # define UNIXSTL_OS_IS_FREEBSD
00362 #elif defined(hpux) || \
00363       defined(_hpux)
00364 # define UNIXSTL_OS_IS_HPUX
00365 #elif defined(__linux__) || \
00366       defined(__linux) || \
00367       defined(linux)
00368 # define UNIXSTL_OS_IS_LINUX
00369 #elif defined(__NetBSD__)
00370 # define UNIXSTL_OS_IS_NETBSD
00371 #elif defined(__OpenBSD__)
00372 # define UNIXSTL_OS_IS_OPENBSD
00373 #elif defined(sun) || \
00374       defined(__sun)
00375 # if defined(UNIXSTL_OSFAMILY_IS_SVR4)
00376 #  define UNIXSTL_OS_IS_SOLARIS
00377 # else /* ? UNIXSTL_OSFAMILY_IS_SVR4 */
00378 #  define UNIXSTL_OS_IS_SUNOS
00379 # endif /* UNIXSTL_OSFAMILY_IS_SVR4 */
00380 #else /* ? operating system */
00381 # define UNIXSTL_OS_IS_UNKNOWN
00382 #endif /* ? operating system */
00383 
00384 /* /////////////////////////////////////////////////////////////////////////
00385  * Contract Enforcement
00386  *
00387  * The macro unixstl_assert provides standard debug-mode assert functionality.
00388  */
00389 
00396 #if defined(UNIXSTL_OS_IS_MACOSX) && \
00397     defined(__assert)
00398 # define UNIXSTL_ASSERT(expr)               ((void)((expr) ? 0 : (__assert(#expr, __FILE__, __LINE__), 0)))
00399 #else /* ? UNIXSTL_OS_IS_MACOSX */
00400 # define UNIXSTL_ASSERT(expr)               STLSOFT_ASSERT(expr)
00401 #endif /* UNIXSTL_OS_IS_MACOSX */
00402 
00410 #define UNIXSTL_MESSAGE_ASSERT(msg, expr)   STLSOFT_MESSAGE_ASSERT(msg, expr)
00411 
00418 #define UNIXSTL_STATIC_ASSERT(expr)         STLSOFT_STATIC_ASSERT(expr)
00419 
00420 
00421 
00422 #ifndef STLSOFT_DOCUMENTATION_SKIP_SECTION
00423 # define unixstl_assert(expr)               UNIXSTL_ASSERT(expr)
00424 # define unixstl_message_assert(msg, expr)  UNIXSTL_MESSAGE_ASSERT(msg, expr)
00425 # define unixstl_static_assert(expr)        UNIXSTL_STATIC_ASSERT(expr)
00426 #endif /* !STLSOFT_DOCUMENTATION_SKIP_SECTION */
00427 
00428 /* /////////////////////////////////////////////////////////////////////////
00429  * Namespace
00430  *
00431  * The UNIXSTL components are contained within the unixstl namespace. This is
00432  * usually an alias for stlsoft::unixstl_project,
00433  *
00434  * When compilers support namespaces they are defined by default. They can be
00435  * undefined using a cascasing system, as follows:
00436  *
00437  * If _STLSOFT_NO_NAMESPACES is defined, then _UNIXSTL_NO_NAMESPACES is defined.
00438  *
00439  * If _UNIXSTL_NO_NAMESPACES is defined, then _UNIXSTL_NO_NAMESPACE is defined.
00440  *
00441  * If _UNIXSTL_NO_NAMESPACE is defined, then the UNIXSTL constructs are defined
00442  * in the global scope.
00443  *
00444  * If _STLSOFT_NO_NAMESPACES, _UNIXSTL_NO_NAMESPACES and _UNIXSTL_NO_NAMESPACE are
00445  * all undefined but the symbol _STLSOFT_NO_NAMESPACE is defined (whence the
00446  * namespace stlsoft does not exist), then the UNIXSTL constructs are defined
00447  * within the unixstl namespace. The definition matrix is as follows:
00448  *
00449  * _STLSOFT_NO_NAMESPACE    _UNIXSTL_NO_NAMESPACE   unixstl definition
00450  * ---------------------    --------------------    -----------------
00451  *  not defined              not defined             = stlsoft::unixstl_project
00452  *  not defined              defined                 not defined
00453  *  defined                  not defined             unixstl
00454  *  defined                  defined                 not defined
00455  *
00456  *
00457  *
00458  * The macro unixstl_ns_qual() macro can be used to refer to elements in the
00459  * UNIXSTL libraries irrespective of whether they are in the
00460  * stlsoft::unixstl_project (or unixstl) namespace or in the global namespace.
00461  *
00462  * Furthermore, some compilers do not support the standard library in the std
00463  * namespace, so the unixstl_ns_qual_std() macro can be used to refer to elements
00464  * in the UNIXSTL libraries irrespective of whether they are in the std namespace
00465  * or in the global namespace.
00466  */
00467 
00468 /* No STLSoft namespaces means no UNIXSTL namespaces */
00469 #ifdef _STLSOFT_NO_NAMESPACES
00470 # define _UNIXSTL_NO_NAMESPACES
00471 #endif /* _STLSOFT_NO_NAMESPACES */
00472 
00473 /* No UNIXSTL namespaces means no unixstl namespace */
00474 #ifdef _UNIXSTL_NO_NAMESPACES
00475 # define _UNIXSTL_NO_NAMESPACE
00476 #endif /* _UNIXSTL_NO_NAMESPACES */
00477 
00478 #ifndef _UNIXSTL_NO_NAMESPACE
00479 # if defined(_STLSOFT_NO_NAMESPACE) || \
00480      defined(STLSOFT_DOCUMENTATION_SKIP_SECTION)
00481 /* There is no stlsoft namespace, so must define ::unixstl */
00512 namespace unixstl
00513 {
00514 # else
00515 /* Define stlsoft::unixstl_project */
00516 
00517 namespace stlsoft
00518 {
00519 
00520 namespace unixstl_project
00521 {
00522 
00523 # endif /* _STLSOFT_NO_NAMESPACE */
00524 #else
00525 stlsoft_ns_using(move_lhs_from_rhs)
00526 #endif /* !_UNIXSTL_NO_NAMESPACE */
00527 
00536 #ifndef _UNIXSTL_NO_NAMESPACE
00537 # define unixstl_ns_qual(x)             ::unixstl::x
00538 # define unixstl_ns_using(x)            using ::unixstl::x;
00539 #else
00540 # define unixstl_ns_qual(x)             x
00541 # define unixstl_ns_using(x)
00542 #endif /* !_UNIXSTL_NO_NAMESPACE */
00543 
00552 #ifdef STLSOFT_CF_std_NAMESPACE
00553 # define unixstl_ns_qual_std(x)         ::std::x
00554 # define unixstl_ns_using_std(x)        using ::std::x;
00555 #else /* ? STLSOFT_CF_std_NAMESPACE */
00556 # define unixstl_ns_qual_std(x)         x
00557 # define unixstl_ns_using_std(x)
00558 #endif /* !STLSOFT_CF_std_NAMESPACE */
00559 
00560 /* /////////////////////////////////////////////////////////////////////////
00561  * Typedefs
00562  *
00563  * The UNIXSTL uses a number of typedefs to aid in compiler-independence in the
00564  * libraries' main code.
00565  */
00566 
00567 #ifndef STLSOFT_DOCUMENTATION_SKIP_SECTION
00568 
00569 typedef stlsoft_ns_qual(ss_char_a_t)        us_char_a_t;    
00570 typedef stlsoft_ns_qual(ss_char_w_t)        us_char_w_t;    
00571 typedef stlsoft_ns_qual(ss_sint8_t)         us_sint8_t;     
00572 typedef stlsoft_ns_qual(ss_uint8_t)         us_uint8_t;     
00573 typedef stlsoft_ns_qual(ss_int16_t)         us_int16_t;     
00574 typedef stlsoft_ns_qual(ss_sint16_t)        us_sint16_t;    
00575 typedef stlsoft_ns_qual(ss_uint16_t)        us_uint16_t;    
00576 typedef stlsoft_ns_qual(ss_int32_t)         us_int32_t;     
00577 typedef stlsoft_ns_qual(ss_sint32_t)        us_sint32_t;    
00578 typedef stlsoft_ns_qual(ss_uint32_t)        us_uint32_t;    
00579 #ifdef STLSOFT_CF_64BIT_INT_SUPPORT
00580 typedef stlsoft_ns_qual(ss_int64_t)         us_int64_t;     
00581 typedef stlsoft_ns_qual(ss_sint64_t)        us_sint64_t;    
00582 typedef stlsoft_ns_qual(ss_uint64_t)        us_uint64_t;    
00583 #endif /* STLSOFT_CF_64BIT_INT_SUPPORT */
00584 typedef stlsoft_ns_qual(ss_int_t)           us_int_t;       
00585 typedef stlsoft_ns_qual(ss_sint_t)          us_sint_t;      
00586 typedef stlsoft_ns_qual(ss_uint_t)          us_uint_t;      
00587 typedef stlsoft_ns_qual(ss_long_t)          us_long_t;      
00588 #if defined(__cplusplus)
00589 typedef stlsoft_ns_qual(ss_bool_t)          us_bool_t;      
00590 #endif /* __cplusplus */
00591 typedef stlsoft_ns_qual(ss_size_t)          us_size_t;      
00592 typedef stlsoft_ns_qual(ss_ptrdiff_t)       us_ptrdiff_t;   
00593 typedef stlsoft_ns_qual(ss_streampos_t)     us_streampos_t; 
00594 typedef stlsoft_ns_qual(ss_streamoff_t)     us_streamoff_t; 
00596 #endif /* !STLSOFT_DOCUMENTATION_SKIP_SECTION */
00597 
00598 #ifndef _UNIXSTL_NO_NAMESPACE
00599 typedef us_char_a_t         char_a_t;           
00600 typedef us_char_w_t         char_w_t;           
00601 /* typedef us_int8_t           int8_t; */             
00602 typedef us_sint8_t          sint8_t;            
00603 typedef us_uint8_t          uint8_t;            
00604 typedef us_int16_t          int16_t;            
00605 typedef us_sint16_t         sint16_t;           
00606 typedef us_uint16_t         uint16_t;           
00607 typedef us_int32_t          int32_t;            
00608 typedef us_sint32_t         sint32_t;           
00609 typedef us_uint32_t         uint32_t;           
00610 # ifdef STLSOFT_CF_64BIT_INT_SUPPORT
00611  typedef us_int64_t         int64_t;            
00612  typedef us_sint64_t        sint64_t;           
00613  typedef us_uint64_t        uint64_t;           
00614 # endif /* STLSOFT_CF_64BIT_INT_SUPPORT */
00615 /* typedef us_short_t          short_t; */            
00616 typedef us_int_t            int_t;              
00617 typedef us_sint_t           sint_t;             
00618 typedef us_uint_t           uint_t;             
00619 typedef us_long_t           long_t;             
00620 /* typedef us_byte_t           byte_t; */             
00621 typedef us_bool_t           bool_t;             
00622 # if !defined(STLSOFT_COMPILER_IS_DMC)
00623 typedef us_streampos_t      streampos_t;        
00624 typedef us_streamoff_t      streamoff_t;        
00625 # endif /* compiler */
00626 #endif /* !_UNIXSTL_NO_NAMESPACE */
00627 
00628 /* /////////////////////////////////////////////////////////////////////////
00629  * Values
00630  *
00631  * Since the boolean type may not be supported natively on all compilers, the
00632  * values of true and false may also not be provided. Hence the values of
00633  * us_true_v and us_false_v are defined, and are used in all code.
00634  */
00635 
00636 #ifndef STLSOFT_DOCUMENTATION_SKIP_SECTION
00637 
00638 #define us_true_v       ss_true_v
00639 #define us_false_v      ss_false_v
00640 
00641 #endif /* !STLSOFT_DOCUMENTATION_SKIP_SECTION */
00642 /* /////////////////////////////////////////////////////////////////////////
00643  * Code modification macros
00644  */
00645 
00646 #ifndef STLSOFT_DOCUMENTATION_SKIP_SECTION
00647 /* Exception signatures. */
00648 #define unixstl_throw_0()                               stlsoft_throw_0()
00649 #define unixstl_throw_1(x1)                             stlsoft_throw_1(x1)
00650 #define unixstl_throw_2(x1, x2)                         stlsoft_throw_2(x1, x2)
00651 #define unixstl_throw_3(x1, x2, x3)                     stlsoft_throw_3(x1, x2, x3)
00652 #define unixstl_throw_4(x1, x2, x3, x4)                 stlsoft_throw_4(x1, x2, x3, x4)
00653 #define unixstl_throw_5(x1, x2, x3, x4, x5)             stlsoft_throw_5(x1, x2, x3, x4, x5)
00654 #define unixstl_throw_6(x1, x2, x3, x4, x5, x6)         stlsoft_throw_6(x1, x2, x3, x4, x5, x6)
00655 #define unixstl_throw_7(x1, x2, x3, x4, x5, x6, x7)     stlsoft_throw_7(x1, x2, x3, x4, x5, x6, x7)
00656 #define unixstl_throw_8(x1, x2, x3, x4, x5, x6, x7, x8) stlsoft_throw_8(x1, x2, x3, x4, x5, x6, x7, x8)
00657 #endif /* !STLSOFT_DOCUMENTATION_SKIP_SECTION */
00658 
00659 #ifndef STLSOFT_DOCUMENTATION_SKIP_SECTION
00660 # define UNIXSTL_NUM_ELEMENTS(ar)                       STLSOFT_NUM_ELEMENTS(ar)
00661 # define unixstl_num_elements(ar)                       UNIXSTL_NUM_ELEMENTS(ar)
00662 #endif /* !STLSOFT_DOCUMENTATION_SKIP_SECTION */
00663 
00668 #define unixstl_destroy_instance(t, _type, p)           STLSOFT_DESTROY_INSTANCE(t, _type, p)
00669 
00674 #define unixstl_gen_opaque(_htype)                      STLSOFT_GEN_OPAQUE(_htype)
00675 
00676 /* ////////////////////////////////////////////////////////////////////// */
00677 
00678 #ifndef _UNIXSTL_NO_NAMESPACE
00679 # if defined(_STLSOFT_NO_NAMESPACE) || \
00680      defined(STLSOFT_DOCUMENTATION_SKIP_SECTION)
00681 } /* namespace unixstl */
00682 # else
00683 } /* namespace unixstl_project */
00684 } /* namespace stlsoft */
00685 namespace unixstl = ::stlsoft::unixstl_project;
00686 # endif /* _STLSOFT_NO_NAMESPACE */
00687 #endif /* !_UNIXSTL_NO_NAMESPACE */
00688 
00689 /* /////////////////////////////////////////////////////////////////////////
00690  * Inclusion
00691  */
00692 
00693 #ifdef STLSOFT_CF_PRAGMA_ONCE_SUPPORT
00694 # pragma once
00695 #endif /* STLSOFT_CF_PRAGMA_ONCE_SUPPORT */
00696 
00697 /* ////////////////////////////////////////////////////////////////////// */
00698 
00699 #endif /* !UNIXSTL_INCL_UNIXSTL_H_UNIXSTL */
00700 
00701 /* ///////////////////////////// end of file //////////////////////////// */