dep/ACE_wrappers/ace/OS_NS_stdlib.h

   1 // -*- C++ -*-
   2
   3 //=============================================================================
   4 /**
   5  *  @file   OS_NS_stdlib.h
   6  *
   7  *  $Id: OS_NS_stdlib.h 81804 2008-05-29 16:12:07Z vzykov $
   8  *
   9  *  @author Douglas C. Schmidt <schmidt@cs.wustl.edu>
  10  *  @author Jesper S. M|ller<stophph@diku.dk>
  11  *  @author and a cast of thousands...
  12  *
  13  *  Originally in OS.h.
  14  */
  15 //=============================================================================
  16
  17 #ifndef ACE_OS_NS_STDLIB_H
  18 # define ACE_OS_NS_STDLIB_H
  19
  20 # include /**/ "ace/pre.h"
  21
  22 # include "ace/config-all.h"
  23
  24 # if !defined (ACE_LACKS_PRAGMA_ONCE)
  25 #  pragma once
  26 # endif /* ACE_LACKS_PRAGMA_ONCE */
  27
  28 #include "ace/os_include/os_stdlib.h"
  29 #include /**/ "ace/ACE_export.h"
  30
  31 #include "ace/Basic_Types.h"  /* ACE_UINT64 and intptr_t in inl file */
  32
  33 #if defined (ACE_EXPORT_MACRO)
  34 #  undef ACE_EXPORT_MACRO
  35 #endif
  36 #define ACE_EXPORT_MACRO ACE_Export
  37
  38 # if defined (ACE_HAS_BROKEN_R_ROUTINES)
  39 #   undef rand_r
  40 # endif /* ACE_HAS_BROKEN_R_ROUTINES */
  41
  42 // We need this for MVS... as well as Linux, etc...
  43 // On Windows, we explicitly set this up as __cdecl so it's correct even
  44 // if building with another calling convention, such as __stdcall.
  45 #if defined (ACE_WIN32) && defined (_MSC_VER)
  46 extern "C" {
  47   typedef int (__cdecl *ACE_COMPARE_FUNC)(const void *, const void *);
  48 }
  49 #else
  50 extern "C" {
  51   typedef int (*ACE_COMPARE_FUNC)(const void *, const void *);
  52 }
  53 #endif /* ACE_WIN32 && _MSC_VER */
  54
  55 ACE_BEGIN_VERSIONED_NAMESPACE_DECL
  56
  57 namespace ACE_OS {
  58
  59   /** @name Non-standard functions
  60    *
  61    *  These functions aren't in the standard.
  62    *
  63    */
  64   //@{
  65
  66
  67   ACE_NAMESPACE_INLINE_FUNCTION
  68   void _exit (int status = 0);
  69
  70   ACE_NAMESPACE_INLINE_FUNCTION
  71   void abort (void);
  72
  73   ACE_NAMESPACE_INLINE_FUNCTION
  74   int atexit (ACE_EXIT_HOOK func);
  75
  76   ACE_NAMESPACE_INLINE_FUNCTION
  77   int atoi (const char *s);
  78
  79 # if defined (ACE_HAS_WCHAR)
  80   ACE_NAMESPACE_INLINE_FUNCTION
  81   int atoi (const wchar_t *s);
  82 # endif /* ACE_HAS_WCHAR */
  83
  84   // atop not in spec
  85 # if defined (atop)
  86 #   undef atop
  87 # endif /* atop */
  88
  89   ACE_NAMESPACE_INLINE_FUNCTION
  90   void *atop (const char *s);
  91
  92 # if defined (ACE_HAS_WCHAR)
  93   ACE_NAMESPACE_INLINE_FUNCTION
  94   void *atop (const wchar_t *s);
  95 # endif /* ACE_HAS_WCHAR */
  96
  97   ACE_NAMESPACE_INLINE_FUNCTION
  98   void *bsearch (const void *key,
  99                  const void *base,
 100                  size_t nel,
 101                  size_t size,
 102                  ACE_COMPARE_FUNC);
 103
 104   extern ACE_Export
 105   void *calloc (size_t elements, size_t sizeof_elements);
 106
 107   extern ACE_Export
 108   void exit (int status = 0);
 109
 110   extern ACE_Export
 111   void free (void *);
 112
 113   ACE_NAMESPACE_INLINE_FUNCTION
 114   char *getenv (const char *symbol);
 115
 116 #   if defined (ACE_HAS_WCHAR) && defined (ACE_WIN32)
 117   ACE_NAMESPACE_INLINE_FUNCTION
 118   wchar_t *getenv (const wchar_t *symbol);
 119 #   endif /* ACE_HAS_WCHAR && ACE_WIN32 */
 120
 121   // not in spec
 122   extern ACE_Export
 123   ACE_TCHAR *getenvstrings (void);
 124
 125   // itoa not in spec
 126   /// Converts an integer to a string.
 127   ACE_NAMESPACE_INLINE_FUNCTION
 128   char *itoa (int value, char *string, int radix);
 129
 130 #if defined (ACE_HAS_WCHAR)
 131   /// Converts an integer to a string.
 132   ACE_NAMESPACE_INLINE_FUNCTION
 133   wchar_t *itoa (int value, wchar_t *string, int radix);
 134 #endif /* ACE_HAS_WCHAR */
 135
 136 #if !defined (ACE_HAS_ITOA)
 137   /// Emulated itoa - Converts an integer to a string.
 138   extern ACE_Export
 139   char *itoa_emulation (int value, char *string, int radix);
 140 #endif /* !ACE_HAS_ITOA */
 141
 142 #if defined (ACE_HAS_WCHAR) && defined (ACE_LACKS_ITOW)
 143   /// Emulated itow - Converts an integer to a string.
 144   extern ACE_Export
 145   wchar_t *itow_emulation (int value, wchar_t *string, int radix);
 146 #endif /* ACE_HAS_WCHAR && ACE_LACKS_ITOW */
 147
 148   extern ACE_Export
 149   void *malloc (size_t);
 150
 151   ACE_NAMESPACE_INLINE_FUNCTION
 152   ACE_HANDLE mkstemp (char *s);
 153
 154 #  if defined (ACE_HAS_WCHAR)
 155   ACE_NAMESPACE_INLINE_FUNCTION
 156   ACE_HANDLE mkstemp (wchar_t *s);
 157 #  endif /* ACE_HAS_WCHAR */
 158
 159 #if defined (ACE_LACKS_MKSTEMP)
 160   extern ACE_Export
 161   ACE_HANDLE mkstemp_emulation (ACE_TCHAR * s);
 162 #endif /* ACE_LACKS_MKSTEMP */
 163
 164 #if !defined (ACE_LACKS_MKTEMP)
 165   ACE_NAMESPACE_INLINE_FUNCTION
 166   char *mktemp (char *s);
 167
 168 #  if defined (ACE_HAS_WCHAR)
 169   ACE_NAMESPACE_INLINE_FUNCTION
 170   wchar_t *mktemp (wchar_t *s);
 171 #  endif /* ACE_HAS_WCHAR */
 172 #else
 173   extern ACE_Export
 174   ACE_TCHAR *mktemp (ACE_TCHAR *s);
 175 #endif /* !ACE_LACKS_MSTEMP */
 176
 177   ACE_NAMESPACE_INLINE_FUNCTION
 178   int putenv (const char *string);
 179
 180 #if defined (ACE_HAS_WCHAR) && defined (ACE_WIN32)
 181   // Windows is the only platform that supports a wchar_t environment.
 182   // Since other platforms make @a string part of the environment, it's
 183   // a certain memory leak to copy and transform wchar_t to char for
 184   // emulating this, so it's not attempted.
 185   ACE_NAMESPACE_INLINE_FUNCTION
 186   int putenv (const wchar_t *string);
 187 #endif /* ACE_HAS_WCHAR && ACE_WIN32 */
 188
 189   ACE_NAMESPACE_INLINE_FUNCTION
 190   void qsort (void *base,
 191               size_t nel,
 192               size_t width,
 193               ACE_COMPARE_FUNC);
 194
 195   ACE_NAMESPACE_INLINE_FUNCTION
 196   int rand (void);
 197
 198   ACE_NAMESPACE_INLINE_FUNCTION
 199   int rand_r (ACE_RANDR_TYPE &seed);
 200
 201   extern ACE_Export
 202   void *realloc (void *, size_t);
 203
 204 #if !defined (ACE_HAS_WINCE)
 205 #  if !defined (ACE_LACKS_REALPATH)
 206   ACE_NAMESPACE_INLINE_FUNCTION
 207 #  else
 208   extern ACE_Export
 209 #  endif /* !ACE_LACKS_REALPATH */
 210   char *realpath (const char *file_name, char *resolved_name);
 211
 212 #  if defined (ACE_HAS_WCHAR)
 213   ACE_NAMESPACE_INLINE_FUNCTION
 214   wchar_t *realpath (const wchar_t *file_name, wchar_t *resolved_name);
 215 #  endif /* ACE_HAS_WCHAR */
 216 #endif /* ACE_HAS_WINCE */
 217
 218   // exit_hook and set_exit_hook not in spec
 219   /// Function that is called by <ACE_OS::exit>, if non-null.
 220   extern ACE_Export ACE_EXIT_HOOK exit_hook_;
 221
 222   /// For use by ACE_Object_Manager only, to register its exit hook..
 223   ACE_NAMESPACE_INLINE_FUNCTION
 224   ACE_EXIT_HOOK set_exit_hook (ACE_EXIT_HOOK hook);
 225
 226   ACE_NAMESPACE_INLINE_FUNCTION
 227   void srand (u_int seed);
 228
 229   // not in spec
 230   extern ACE_Export
 231   ACE_TCHAR *strenvdup (const ACE_TCHAR *str);
 232
 233 #if !defined (ACE_LACKS_STRTOD)
 234   /// Converts a string to a double value (char version).
 235   ACE_NAMESPACE_INLINE_FUNCTION
 236   double strtod (const char *s, char **endptr);
 237 #endif /* !ACE_LACKS_STRTOD */
 238
 239 #if defined (ACE_HAS_WCHAR) && !defined (ACE_LACKS_WCSTOD)
 240   /// Converts a string to a double value (wchar_t version).
 241   ACE_NAMESPACE_INLINE_FUNCTION
 242   double strtod (const wchar_t *s, wchar_t **endptr);
 243 #endif /* ACE_HAS_WCHAR && !ACE_LACKS_WCSTOD */
 244
 245   /// Converts a string to a long value (char version).
 246   ACE_NAMESPACE_INLINE_FUNCTION
 247   long strtol (const char *s, char **ptr, int base);
 248
 249 #if defined (ACE_HAS_WCHAR) && !defined (ACE_LACKS_WCSTOL)
 250   /// Converts a string to a long value (wchar_t version).
 251   ACE_NAMESPACE_INLINE_FUNCTION
 252   long strtol (const wchar_t *s, wchar_t **ptr, int base);
 253 #endif /* ACE_HAS_WCHAR && !ACE_LACKS_WCSTOL */
 254
 255 #if defined (ACE_LACKS_STRTOL)
 256   extern ACE_Export
 257   long strtol_emulation (const char *nptr, char **endptr, int base);
 258 #endif /* ACE_LACKS_STRTOL */
 259
 260   /// Converts a string to an unsigned long value (char version).
 261   ACE_NAMESPACE_INLINE_FUNCTION
 262   unsigned long strtoul (const char *s, char **ptr, int base);
 263
 264 #if defined (ACE_HAS_WCHAR) && !defined (ACE_LACKS_WCSTOUL)
 265   /// Converts a string to an unsigned long value (wchar_t version).
 266   ACE_NAMESPACE_INLINE_FUNCTION
 267   unsigned long strtoul (const wchar_t *s, wchar_t **ptr, int base);
 268 #endif /* ACE_HAS_WCHAR && !ACE_LACKS_WCSTOUL */
 269
 270 #if defined (ACE_LACKS_STRTOUL)
 271   extern ACE_Export
 272   unsigned long strtoul_emulation (const char *nptr,
 273                                    char **endptr,
 274                                    int base);
 275 #endif /* ACE_LACKS_STRTOUL */
 276
 277   /// Converts a string to a 64 bit int value (char version).
 278   ACE_NAMESPACE_INLINE_FUNCTION
 279   ACE_UINT64 strtoull (const char *s, char **ptr, int base);
 280
 281 #if defined (ACE_HAS_WCHAR) && !defined (ACE_LACKS_WCSTOULL)
 282   /// Converts a string to a 64 bit int value (wchar_t version).
 283   ACE_NAMESPACE_INLINE_FUNCTION
 284   ACE_UINT64 strtoull (const wchar_t *s, wchar_t **ptr, int base);
 285 #endif /* ACE_HAS_WCHAR && !ACE_LACKS_WCSTOUL */
 286
 287 #if defined (ACE_LACKS_STRTOULL)
 288   extern ACE_Export
 289   ACE_UINT64 strtoull_emulation (const char *nptr,
 290                                  char **endptr,
 291                                  int base);
 292 #endif /* ACE_LACKS_STRTOULL */
 293
 294   ACE_NAMESPACE_INLINE_FUNCTION
 295   int system (const ACE_TCHAR *s);
 296
 297   /// Get the name of the current program
 298   ///
 299   /// Originally from NetBSD, now found in *BSD, Cygwin, Darwin, etc.
 300   ACE_NAMESPACE_INLINE_FUNCTION
 301   const char *getprogname ();
 302
 303 #if !defined (ACE_HAS_GETPROGNAME)
 304   extern ACE_Export
 305   const char *getprogname_emulation ();
 306 #endif /* !ACE_HAS_GETPROGNAME */
 307
 308   /// Set the name of the current program
 309   ///
 310   /// Originally from NetBSD, now found in *BSD, Cygwin, Darwin, etc.
 311   ACE_NAMESPACE_INLINE_FUNCTION
 312   void setprogname (const char* name);
 313
 314 #if !defined (ACE_HAS_SETPROGNAME)
 315   extern ACE_Export
 316   void setprogname_emulation (const char* name);
 317 #endif /* !ACE_HAS_SETPROGNAME */
 318
 319 } /* namespace ACE_OS */
 320
 321 ACE_END_VERSIONED_NAMESPACE_DECL
 322
 323 # if defined (ACE_HAS_INLINED_OSCALLS)
 324 #   if defined (ACE_INLINE)
 325 #     undef ACE_INLINE
 326 #   endif /* ACE_INLINE */
 327 #   define ACE_INLINE inline
 328 #   include "ace/OS_NS_stdlib.inl"
 329 # endif /* ACE_HAS_INLINED_OSCALLS */
 330
 331 # include /**/ "ace/post.h"
 332 #endif /* ACE_OS_NS_STDLIB_H */